Migracja z Shopify Scripts do Shopify Functions

Rozwiązanie Shopify Functions działa podobnie jak skrypty Shopify i umożliwia programistom tworzenie niestandardowych doświadczeń handlowych.

Wymóg dotyczący planu

Aplikacje Shopify Scripts i Script Editor są dostępne tylko dla sklepów objętych planem Shopify Plus. Aplikacja Script Editor nie jest już dostępna do pobrania ze sklepu Shopify App Store.

W dniu 28 sierpnia 2025 roku Shopify Scripts zostaną wycofane i przestaną działać.Przenieś istniejące skrypty do Shopify Functions przed tym dniem.

Funkcje Shopify

Rozwiązanie Shopify Functions jest instalowane w ramach aplikacji. Rozwiązanie jest konfigurowane obok innych funkcji bezpośrednio w panelu administracyjnym Shopify, co oznacza, że sprzedawcy nie muszą używać kodu podczas tworzenia lub modyfikowania dostosowań. Platforma WebAssembly, na której działa rozwiązanie Shopify Functions, oferuje lepszą wydajność niż skrypty Shopify — wykonanie kodu trwa mniej niż 5 milisekund. Dzięki temu rozwiązanie Shopify Functions może obsługiwać duże wydarzenia sprzedażowe, takie jak szybka wyprzedaż, bez obniżenia wydajności.

Za pomocą rozwiązania Shopify Functions programiści mogą kodować i przeprowadzać testy jednostkowe w swoim lokalnym środowisku. Programiści dystrybuują swoje dostosowania Shopify Functions w ramach aplikacji, zamiast kopiować i wklejać kod Ruby do każdego sklepu. Ponadto rozwiązanie Shopify Functions umożliwia ograniczenie problemów z limitem czasu i pamięci CPU.

Migracja do Shopify Functions za pomocą raportu dostosowań Shopify Scripts

Raport dostosowań Shopify Scripts to spersonalizowana strona w panelu administracyjnym Shopify, która wyświetla istniejące dostosowania skryptów aktywne w Twoim sklepie i udostępnia dokumentację Shopify Functions lub odpowiednie linki do aplikacji, które mogą pomóc w ponownym utworzeniu dostosowań.

Raporty dostosowań Shopify Scripts są generowane automatycznie. Możesz także wyeksportować raport i wyświetlić go jako plik CSV. Musisz utworzyć ponownie dostosowania za pomocą Shopify Functions przed 28 sierpnia 2025 r.

Przeglądanie dostosowań

W zależności od posiadanych skryptów strona raportu może zawierać sekcje dostosowań bramek płatniczych, wysyłki i rabatów na produkty.

Każda sekcja może zawierać nazwę, opis i linki do plików źródłowych dostosowań Shopify Scripts, linki do zalecanych aplikacji utworzonych za pomocą Shopify Functions i specyficznych dla Twoich dostosowań oraz linki do tutoriali Shopify Functions.

Zapoznaj się z informacjami zawartymi w raporcie, aby zdecydować, czy chcesz utworzyć ponownie dostosowania za pomocą następujących opcji:

• Opracuj własne rozwiązanie za pomocą Shopify Functions
• Zainstaluj aplikacje opracowane w Shopify Functions

Uwaga

Aplikacje oparte na Shopify Functions wymagają korzystania z Shopify App Bridge. Aplikacje niestandardowe utworzone w panelu administracyjnym Shopify nie obsługują Shopify App Bridge, więc aplikacje niestandardowe oparte na Shopify Functions muszą zostać utworzone za pomocą Pulpitu Partnerów, a następnie połączone z Twoim sklepem.

Ponowne utworzenie dostosowań

1. W panelu administracyjnym Shopify przejdź do opcji: Ustawienia > Aplikacje i kanały sprzedaży.

2. Kliknij Script Editor.

3. Na banerze Zastąp Shopify Scripts kliknij opcję Zastąp Shopify Scripts.

4. W każdej sekcji raportu dostosowań wykonaj dowolną z następujących czynności:

   • Aby wyświetlić istniejące dostosowania Shopify Scripts, kliknij nazwę skryptu pod liczbą zmian w sekcji Wykryto automatycznie.
   • Aby wyświetlić lub zainstalować zgodne aplikacje, które odpowiadają Twoim skryptom, w sekcji Rekomendowane aplikacje kliknij Zainstaluj obok aplikacji, której chcesz użyć, lub kliknij Więcej aplikacji tego typu, aby znaleźć inne zgodne aplikacje.
   • Aby wyświetlić tutorial Shopify Functions, w sekcji Jak dokonać przebudowy za pomocą Shopify Functions kliknij odpowiedni link API funkcji.

Po pomyślnym przetestowaniu aplikacji lub dostosowaniu funkcji Shopify możesz dezaktywować skrypt, który zastępujesz.

Korzystanie ze skryptów Shopify z Shopify Functions

Skrypty Shopify Scripts będą nadal działać w przypadku realizacji zakupu, które dostosowywano za pomocą checkout.liquid, oraz realizacji zakupu, które zostały uaktualnione do 28 sierpnia 2025 r.

Skrypty Shopify i Shopify Functions mogą być używane jednocześnie w jednym sklepie. Jeśli nie można zastąpić skryptów za pomocą rozwiązania Shopify Functions, kontynuuj korzystanie ze skryptów Shopify, dopóki API Shopify Functions nie spełni Twoich potrzeb. Zapoznaj się z poniższymi informacjami, aby ustalić sposób interakcji skryptów Shopify i Shopify Functions.

Skrypty pozycji pojedynczych

Skrypty pozycji pojedynczych są wykonywane przed Shopify Functions, które obejmują rabaty tworzone przez aplikacje. Skrypty pozycji pojedynczych nie mogą uzyskać dostępu do kwot, które zostały obniżone przez funkcje i aplikacje.

Skrypty mogą uzyskać dostęp tylko do pierwszego kodu rabatowego zastosowanego do realizacji zakupu i nie mogą uzyskać dostępu do innych kodów rabatowych, które mogły zostać zastosowane. Na przykład użycie reject działa dla pierwszego rabatu zastosowanego do realizacji zakupu i nie ma wpływu na inne rabaty.

Skrypty wysyłki

Skrypty wysyłki są wykonywane po utworzeniu dostosowań płatności przez Shopify Functions. Skrypty nie mogą działać na zmodyfikowanych wynikach zmiany nazwy dostosowania dostawy, ale mogą działać na dostosowaniach, które przesuwają się lub ukrywają.

Skrypty płatności

Skrypty płatności są wykonywane po utworzeniu dostosowań płatności przez Shopify Functions. Skrypty nie mogą działać na zmodyfikowanych wynikach zmiany nazwy dostosowania płatności, ale mogą działać na dostosowaniach, które przesuwają się lub ukrywają.