Metapola w szablonach

Metapola to własne dane, które Ty lub Twoje aplikacje przechowujecie w Shopify: wiadomość z prezentem przy zamówieniu, etykieta z instrukcją prania przy produkcie, numer konta klienta. Szablony mogą je drukować za pomocą Liquid. Karta Metapola w edytorze kodu pokazuje składnię dla każdego rodzaju.

Zanim zaczniesz: sprawdź, które metapola wczytuje Foliant

Foliant wczytuje metapola razem z zamówieniem i nie może wczytać wszystkich. Działa to tak:

Twój sklep potrzebuje co najmniej jednej definicji metapola (w panelu administracyjnym Shopify, Ustawienia › Dane niestandardowe). Bez żadnej definicji nie są wczytywane żadne metapola.
Dla każdego rodzaju (zamówienia, wersje robocze zamówień, klienci, produkty i warianty) Foliant wczytuje przypięte definicje, maksymalnie 10 na rodzaj, w kolejności przypięcia.
Jeśli dany rodzaj nie ma przypiętych definicji, Foliant wczytuje pierwsze 10 metapól, które dla niego znajdzie.

Aby mieć pewność, że metapole się wydrukuje, utwórz dla niego definicję i przypnij ją w Ustawienia › Dane niestandardowe. Zmiany w definicjach mogą pojawić się w dokumentach dopiero po godzinie.

Drukowanie metapola

Zastąp namespace i key przestrzenią nazw i kluczem swojego metapola (na przykład custom.gift_message):

Metapole dotyczy	Liquid
Zamówienia lub wersji roboczej zamówienia	`{{ order.metafields.namespace.key }}`
Klienta	`{{ customer.metafields.namespace.key }}`
Produktu	`{{ line_item.product.metafields.namespace.key }}`
Wariantu	`{{ line_item.variant.metafields.namespace.key }}`

Metapola produktów i wariantów dotyczą pojedynczych pozycji, więc używaj ich wewnątrz pętli pozycji zamówienia:

{% for line_item in line_items %}
  {{ line_item.title }}
  {% if line_item.product.metafields.custom.care_instructions != blank %}
    <br>{{ line_item.product.metafields.custom.care_instructions }}
  {% endif %}
{% endfor %}

Jak drukują się typy metapól

Typ	Co otrzymujesz
Tekst, URL, data, kolor…	Wartość jako tekst
Liczba całkowita, dziesiętna	Liczbę, którą możesz porównywać lub używać w obliczeniach
Prawda lub fałsz	`true` lub `false`, do `{% if %}`
Tekst sformatowany	Tekst bez formatowania
Waga, wymiar, objętość	`.value` i `.unit`, na przykład `{{ … .weight.value }} {{ … .weight.unit }}`
Pieniądze	`.value` (np. `23.00`) i `.unit` (kod waluty). Nie w groszach.
Ocena	`.value`, `.scale_min` i `.scale_max`
JSON, listy	Listę lub obiekt, po którym możesz iterować w pętli

Warto wiedzieć

Puste lub brakujące metapole niczego nie drukuje. Użyj != blank, aby pominąć jego etykietę.
W szablonach wizualnych drukuj metapola za pomocą bloku Własny Liquid.
Listy kompletacyjne mogą pokazywać metapola produktów lub wariantów jako kolumny, w ustawieniach Lista kompletacyjna szablonu.

Witamy

Pierwsze kroki

Drukowanie

Szablony

Edytor szablonów

Projekty

Dostarczanie plików PDF

Szablony e-maili

Konta klientów

Eksporty

Faktury i numeracja

Podatki i dane prawne

Integracje

Płatności i plany

Ustawienia

Rozwiązywanie problemów

Informacje prawne

Zanim zaczniesz: sprawdź, które metapola wczytuje Foliant

Drukowanie metapola

Jak drukują się typy metapól

Warto wiedzieć

Powiązane artykuły