Dokumentacja zmiennych specyfikacji towarów

Specyfikacje towarów są renderowane przy użyciu języka Liquid, języka szablonów stworzonego przez Shopify.

Możesz wprowadzić zmiany w szablonach specyfikacji towarów, klikając opcję Szablon specyfikacji towarów w sekcji Dokumenty na stronie Wysyłka i dostawa w panelu administracyjnym Shopify.

Zmienne sklepu

Użyj zmiennych z tej tabeli, aby dodać szczegóły sklepu do specyfikacji towarów. Informacje o sklepie możesz znaleźć i edytować na stronie ustawień Ogólne w panelu administracyjnym Shopify.

Opis zmiennych sklepu Liquid, których można używać w szablonach specyfikacji towarów
ZmiennaOpis
shop.name
Nazwa sklepu.
shop.email
Adres e-mail sklepu.
shop.domain
Domena sklepu.

Zmienne adresu sklepu

Użyj zmiennych z tej tabeli, aby dodać adres sklepu do specyfikacji towarów. Możesz znaleźć i edytować szczegóły adresu w sekcji Miejsce pochodzenia wysyłki na stronie Wysyłka i dostawa w panelu administracyjnym Shopify.

Opis zmiennych Liquid adresu sklepu, których możesz używać w szablonach specyfikacji towarów.
ZmiennaOpis
shop_address.address1
Adres sklepu.
shop_address.address2
Numer mieszkania lub lokalu sklepu.
shop_address.company
Nazwa firmy.
shop_address.city
Miasto sklepu
shop_address.province_code
Kod stanu lub prowincji sklepu. Na przykład kod prowincji dla Ontario to ON.
shop_address.province
Stan lub prowincja sklepu
shop_address.zip
Kod pocztowy sklepu.
shop_address.country_code
Kod kraju sklepu. Na przykład kod kraju dla Kanady to CA.
shop_address.country
Kraj sklepu.
shop_address.summary
Pełny adres sklepu.

Zmienne zamówienia

Użyj zmiennych z tej tabeli, aby dodać szczegóły dotyczące zamówienia do specyfikacji towarów. Listę zamówień możesz wyświetlić na stronie Zamówienia w panelu administracyjnym Shopify.

Opis zmiennych Liquid zamówienia, których możesz używać w szablonach specyfikacji towarów.
ZmiennaOpis
order.order_number
Numer zamówienia bez prefiksów i sufiksów. Na przykład: 1004.
order.name
Numer zamówienia zawierający wszelkie prefiksy lub sufiksy ustawione na stronie Ustawienia ogólne w panelu administracyjnym Shopify. Na przykład: #1004.
order.note
Notatka powiązana z zamówieniem, jeśli istnieje.
order.created_at
Data i godzina utworzenia zamówienia. Na przykład: 2009-05-30T17:43:51+02:00. Użyj filtra daty, aby zmienić format.

Zmienne klienta

Użyj zmiennych z tej tabeli, aby dodać informacje o kliencie do specyfikacji towarów. Listę zamówień możesz wyświetlić na stronie Klienci w panelu administracyjnym Shopify.

Opis zmiennych Liquid klienta, których możesz używać w szablonach specyfikacji towarów.
ZmiennaOpis
customer.first_name
Imię klienta.
customer.last_name
Nazwisko klienta.
customer.name
Imię i nazwisko klienta.
customer.email
Adres e-mail klienta.

Zmienne adresu wysyłki i adresu rozliczeniowego klienta

Użyj zmiennych z tej tabeli, aby dodać adres wysyłki lub adres rozliczeniowy klienta do specyfikacji towarów. Listę zamówień możesz wyświetlić na stronie Klienci w panelu administracyjnym Shopify.

Opis zmiennych Liquid adresu klienta, których możesz używać w szablonach specyfikacji towarów.
ZmiennaOpis

shipping_address.address1

billing_address.address1

Adres klienta.

shipping_address.address2

billing_address.address2

Numer mieszkania lub lokalu klienta.

shipping_address.first_name

billing_address.first_name

Imię klienta.

shipping_address.last_name

billing_address.last_name

Nazwisko klienta.

shipping_address.name

billing_address.name

Imię i nazwisko klienta.

shipping_address.phone

billing_address.phone

Numer telefonu klienta.

shipping_address.company

billing_address.company

Nazwa firmy klienta dla adresu wysyłki.

shipping_address.city

billing_address.city

Miasto klienta.

shipping_address.province_code

billing_address.province_code

Kod stanu lub prowincji klienta. Na przykład kod prowincji dla Ontario to ON.

shipping_address.province

billing_address.province

Stan lub prowincja klienta.

shipping_address.zip

billing_address.zip

Kod pocztowy klienta.

shipping_address.country_code

billing_address.country_code

Kod kraju klienta. Na przykład kod kraju dla Kanady to CA.

shipping_address.country

billing_address.country

Kraj klienta.

shipping_address.summary

billing_address.summary

Pełny adres klienta.

Zmienne pozycji w wysyłce

Użyj zmiennych z tej tabeli, aby dodać szczegóły produktu do specyfikacji towarów. Aby zobaczyć produkty w zamówieniu, przejdź do strony Zamówienia w panelu administracyjnym Shopify i kliknij numer zamówienia.

Opis zmiennych Liquid pozycji w wysyłce, których możesz używać w szablonach specyfikacji towarów.
ZmiennaOpis
line_items_in_shipment

Lista pozycji, które należą do jednej wysyłki. Poszczególne pozycje można umieścić w pętli jako line_item:

{% for line_item in line_items_in_shipment %} {{ line_item.image }} {{ line_item.title }} ... {% endfor %}

Wszystkie dostępne atrybuty elementu line_item wymieniono poniżej:

line_item.image — obraz produktu, jeśli istnieje.

line_item.title — nazwa produktu. Jeśli produkt ma wiele wariantów, uwzględniana jest również nazwa wariantu.

line_item.variant_title — nazwa wariantu produktu.

line_item.vendor — dostawca produktu.

line_item.sku — kod SKU produktu.

line_item.quantity — całkowita ilość tego produktu.

line_item.shipping_quantity — ilość tego produktu, która jest realizowana w ramach wysyłki.

line_item.properties — właściwości produktu.

line_item.groups - Lista grup pozycji pojedynczych, do których należy produkt, takich jak pakiety lub dodatki add on. Każda grupa ma następujące atrybuty:

  • group.title - Wyświetlany tytuł grupy.
  • group.deliverable? - Zwraca true, jeśli pozycja pojedyncza jest dodatkiem add on do produktu nadrzędnego, lub false, jeśli pozycja pojedyncza jest częścią pakietu.
includes_all_line_items_in_order

Wartość logiczna

Jeśli wartość to true, wszystkie pozycje w zamówieniu są uwzględnione w wysyłce.

Jeśli wartość to false, nie wszystkie pozycje z zamówienia są uwzględnione w wysyłce.

Obrazy

Dozwolone są tylko obrazy z domeny https://cdn.myshopify.com/. Wszystkie inne obrazy są odfiltrowywane. Możesz dołączyć dowolny obraz przesłany na stronę Pliki w panelu administracyjnym Shopify.

Aby dodać obrazy produktów lub miniatury do specyfikacji towarów, użyj zmiennej line_item.image.

Przykłady zmiennych specyfikacji towarów

Poniższe przykłady pokazują, jak można używać niektórych zmiennych specyfikacji towarów.

now

Możesz użyć następującego formatu, aby wyświetlić bieżącą datę i godzinę:

{{ "now" | date: "%Y-%m-%d %H:%M" }}

Wynik to:

2018-09-10 14:23

line_items_in_shipment

Zmienna line_items_in_shipment wyświetla tablicę pozycji, które są zawarte w wysyłce.

Na przykład:

{% for line_item in line_items_in_shipment %}
  {{ line_item.title }}
  {{ line_item.variant_title }}
  ...
{% endfor %}

Pola zwracane w każdym wpisie line_item są następujące:

line_item.image
line_item.title
line_item.variant_title
line_item.sku
line_item.vendor
line_item.quantity
line_item.shipping_quantity
line_item.properties
line_item.groups

line_item.groups

Jeśli w swoim sklepie używasz pakietów lub dodatków add on, możesz wyświetlać informacje o grupie dla każdej pozycji pojedynczej:

{% for group in line_item.groups %}
  {% if group.deliverable? %}
    Add-on for: {{ group.title }}
  {% else %}
    Part of: {{ group.title }}
  {% endif %}
{% endfor %}

line_item.image

Możesz wyświetlić obrazy dla swoich pozycji za pomocą następującego formatu:

{% if line_item.image != blank %}
  {{ line_item.image | img_url: '58x58' | img_tag }}
{% endif %}

Możesz wyświetlić ilość i wysyłaną ilość dla swoich pozycji, używając następującego formatu:

{{ line_item.shipping_quantity }} of {{ line_item.quantity }}

Na przykład może to spowodować wyświetlenie:

2 of 5

includes_all_line_items_in_order

Możesz użyć tej zmiennej, aby wyświetlić komunikat, jeśli wysyłasz tylko niektóre pozycje z zamówienia. Na przykład:

{% unless includes_all_line_items_in_order %}
  There are other items from your order not included in this shipment.
{% endunless %}