- Bloki znajdują się bezpośrednio w koszyku, w jednej z trzech sekcji: Header, Body lub Footer. Każda sekcja oferuje inny zestaw bloków.
- Sub-bloki są zagnieżdżone wewnątrz innego bloku. Obecnie tylko Cart items obsługuje sub-bloki: wiersz Product (sam wiersz pozycji), Subscription upgrade oraz Custom code.
- Dodawaj bloki przez selektor Add block. Blok jest wyszarzony, jeśli nie może trafić tam, gdzie go dodajesz, lub jeśli osiągnięto jego limit (selektor pokazuje odznakę
count/max). - Zmieniaj kolejność, przeciągając blok w obrębie jego sekcji.
- Usuwaj ikoną kosza — z wyjątkiem bloków zablokowanych (poniżej).
- Pokazuj/ukrywaj większość bloków przełącznikiem oka, który ukrywa blok przed kupującymi bez jego usuwania. Kilku bloków strukturalnych nie można ukryć: Cart items, Checkout button i wiersza Product.
- Cart items
- Checkout button
- Wypełniony koszyk: Header, Banner, Cart items, Summary, Checkout button
- Pusty koszyk: Header, blok Empty cart
Stan pustego koszyka to cały pusty układ. Blok Empty cart to jeden blok wewnątrz niego. Różnicę znajdziesz w Jak działają koszyki?.
Każdy blok konfiguruje się przez maksymalnie trzy powierzchnie w edytorze:
- Content: ustawienia bloku (tekst, wybór produktów, progi itd.). Blok Custom code to jedyny wyjątek: nie ma panelu Content, ponieważ blok jest kodem.
- Design: stylizacja per blok, która nakłada się na twoje globalne Ustawienia designu. Ma ją każdy blok poza Custom code, który w ogóle nie ma panelu ustawień.
- Code: nadpisanie wbudowanego renderowania bloku szablonem niestandardowym. Obsługuje to większość bloków; kilka nie.
Obsługiwane typy warunków dziś: rynek Shopify, kraj klienta i waluta klienta (każdy z In lub Not in). Suma koszyka i zawartość koszyka nie są typami warunków. Użyj progów poziomów w Rewards do progresu wydatków/ilości albo Cart SDK, gdy potrzebujesz reguły, której edytor nie potrafi wyrazić.
Warunki to uporządkowana lista: wygrywa pierwszy pasujący warunek. Umieszczaj reguły szczegółowe nad regułą zbiorczą All buyers. Jeśli nic nie pasuje, blok nie renderuje niczego dla tego kupującego.
W edytorze dziś pełny interfejs Conditions dostępny jest w bloku Rewards: różne zestawy poziomów per rynek, kraj lub waluta. Inne bloki albo używają jednej konfiguracji „dla wszystkich kupujących”, albo jeszcze nie uczestniczą w tym systemie.
Podgląd edytora nie ocenia rzeczywistego kupującego. Wybierz warunek w panelu, aby podejrzeć ten wariant.
Struktura
- Header: tytuł, liczba pozycji, logo i przycisk zamknięcia, przypięte do góry.
- Cart items: pozycje dodane przez klientów do koszyka; powtarza się per linia.
- Subscription upgrade: sub-blok oferujący konwersję linii na subskrypcję.
- Summary: sumy, oszczędności i zastosowane rabaty.
- Checkout button: główne wezwanie do działania prowadzące do checkoutu.
- Empty cart: treść pokazywana, gdy koszyk jest pusty.
- Express payments: przyciski przyspieszonego checkoutu (Shop Pay, PayPal itd.) wewnątrz koszyka.
- Upsells: rekomendacje produktów dobierane strategią.
- Product add-on: pojedynczy konkretny produkt oferowany jako dodatek.
- Rewards: progowe nagrody, takie jak darmowa wysyłka lub prezenty.
- Shipping protection: opcjonalny dodatek ochrony przesyłki.
- Discount code: pole do zastosowania kodu rabatowego.
- Notes: pole notatek do zamówienia.
- Banner: baner z komunikatem, z opcjonalnym licznikiem odliczającym.
- Image: pojedynczy obraz lub hostowany preset, np. ikony płatności.
- Custom code: niestandardowy HTML lub React w dowolnym miejscu koszyka.
- Custom templates: nadpisanie sposobu renderowania dowolnego bloku z jego karty Code.
Niektóre z tych bloków są przypisane do stanu (na przykład Empty cart tylko w stanie pustym). Zobacz Jak działają koszyki?.
Jeśli ustawienia bloku zawierają nieprawidłową wartość, obok nazwy tego bloku w pasku bocznym pojawia się mała czerwona kropka. Kropka pozostaje, dopóki nie naprawisz problemu. Nie jest to powiadomienie, które można odrzucić.
Dopóki jakikolwiek blok ma błąd, zapisywanie jest zablokowane. Przycisk Save pozostaje klikalny, ale jego wybranie pokazuje toast z błędem („Fix the errors in your cart blocks before saving”) i przeskakuje do pierwszego bloku z problemem, otwierając jego ustawienia, abyś mógł poprawić podświetlone pole. Publish dodatkowo wymaga braku niezapisanych zmian, więc pozostaje niedostępny do czasu udanego, czystego zapisu.
Po poprawieniu nieprawidłowego pola kropka znika sama, a zapisywanie przebiega normalnie.
Ukryte bloki wciąż podlegają walidacji. Ukryty blok może zawierać nieprawidłowe ustawienie, pokazywać kropkę błędu i blokować zapisywanie dokładnie jak widoczny — więc jeśli zapisywanie jest zablokowane, a każdy widoczny blok wygląda dobrze, sprawdź ukryte bloki.