Klucze i wartości
Zmienna ma dwie części:
- Klucz — unikalny identyfikator, którym odwołujesz się z treści (
{promotionText}). - Jedną lub więcej wartości — faktyczna treść, do której rozwiązuje się klucz.
Wartości to nie pojedyncze pole. Każda zmienna ma listę wierszy wartości, każdy wiersz przypisany do kanału sprzedaży (lub „global”, jeśli kanał nie jest ustawiony) i tłumaczalny per język. Plugin wybiera odpowiedni wiersz w momencie renderowania na podstawie kontekstu storefrontu.
| Właściwość | Zasada |
|---|---|
| Format | Litery, cyfry, podkreślenia — zacznij od litery. Zalecane camelCase. |
| Wielkość liter | Tak — {promoText} i {promotext} to dwa różne placeholdery. |
| Zarezerwowane | Wbudowane (shopName, shopEmail, shopAddress, shopBankAccount) nie mogą być nadpisane jako własne klucze. |
| Unikalność | Klucz musi być unikalny w obrębie wszystkich własnych zmiennych. |
Dobre klucze: promotionText, footerDisclaimer, legalShipping, usp1, usp2.
Unikaj: text, value, info (za ogólne), albo kluczy ze spacjami / myślnikami (nie będą sparsowane).
Składnia placeholdera
Dział zatytułowany „Składnia placeholdera”Wpisz klucz w nawiasach klamrowych:
Skorzystaj z {promotionText} przy zamówieniach powyżej {minOrderValue} zł.Plugin dopasowuje wszystko między { a } do listy zmiennych. Nieznane klucze pozostają niezmienione — to znaczy, że literówki renderują się dosłownie na storefroncie, więc sprawdzaj przez podgląd w edytorze przed publikacją.
Białe znaki wewnątrz klamr nie są dozwolone: { promotionText } nie zadziała. Trzymaj się {promotionText}.
Wartości
Dział zatytułowany „Wartości”Każdy wiersz wartości ma następujące pola:
| Pole | Tłumaczalne | Cel |
|---|---|---|
| Kanał sprzedaży | — | Kanał, do którego stosuje się ten wiersz. Pusty = globalny / domyślny dla wszystkich kanałów. |
| Wartość | tak | Treść zastępcza. Wspiera rich text / HTML. |
| CSS | tak | Opcjonalny CSS wstrzykiwany tylko na stronach używających zmiennej. |
| Skrypt | tak | Opcjonalny JavaScript wstrzykiwany tylko na stronach używających zmiennej. |
Dodajesz wiersz wartości klikając Dodaj wartość na stronie szczegółów zmiennej. Dodaj tyle wierszy, ile potrzebujesz:
- Jeden wiersz globalny (bez kanału) wystarczy w prostych przypadkach.
- Dodaj wiersze per kanał na górze, aby nadpisać wartość globalną dla konkretnego kanału sprzedaży.
Flaga aktywności
Dział zatytułowany „Flaga aktywności”Każda zmienna ma przełącznik Aktywna. Gdy wyłączony, placeholder pozostaje nietknięty — przydatne do przygotowywania treści lub czasowego wyłączenia kampanii bez usuwania zmiennej.