Referenčná príručka premenných pre baliace listy

Na vykresľovanie baliacich listov sa používa Liquid, jazyk šablón vytvorený spoločnosťou Shopify.

V šablónach baliaceho listu môžete vykonávať zmeny kliknutím na Šablóna baliaceho listu v sekcii Dokumenty na stránke Doprava a doručovanie v administrátorovi Shopify.

Na tejto stránke

Premenné obchodu

Pomocou premenných v tejto tabuľke môžete do baliaceho listu pridať detaily o obchode. Informácie o obchode nájdete a môžete upraviť na stránke s nastaveniami Všeobecné u vášho administrátora Shopify.

Opis premenných obchodu Liquid, ktoré možno použiť v šablónach baliacich listov
Premenná	Opis
shop.name	Názov vášho obchodu.
shop.email	E‑mailová adresa vášho obchodu.
shop.domain	Doména vášho obchodu.

Premenné adresy obchodu

Pomocou premenných v tejto tabuľke môžete do baliaceho listu pridať adresu obchodu. Podrobnosti o adrese nájdete a môžete ich upraviť v sekcii Miesto odoslania na stránke Doprava a doručovanie u vášho administrátora Shopify.

Opis premenných adresy obchodu Liquid, ktoré možno použiť v šablónach baliacich listov
Premenná	Opis
shop_address.address1	Adresa vášho obchodu.
shop_address.address2	Byt alebo apartmán vášho obchodu.
shop_address.company	Názov vašej spoločnosti.
shop_address.city	Mesto vášho obchodu
shop_address.province_code	Kód štátu alebo provincie vášho obchodu. Napríklad kód provincie Ontário je ON.
shop_address.province	Štát alebo provincia vášho obchodu
shop_address.zip	Smerovacie číslo alebo poštové smerovacie číslo vášho obchodu.
shop_address.country_code	Kód krajiny vášho obchodu. Napríklad kód pre Kanadu je CA.
shop_address.country	Krajina vášho obchodu.
shop_address.summary	Úplná adresa vášho obchodu.

Premenné objednávky

Pomocou premenných v tejto tabuľke môžete do baliaceho listu pridať detaily objednávky. Zoznam objednávok si môžete pozrieť na stránke Objednávky u vášho administrátora Shopify.

Opis premenných objednávky Liquid, ktoré možno použiť v šablónach baliacich listov
Premenná	Opis
order.order_number	Číslo objednávky bez akýchkoľvek predpôn alebo prípon. Napríklad `1004`.
order.name	Číslo objednávky vrátane predpôn a prípon nastavených na stránke s nastaveniami Všeobecné u vášho administrátora Shopify. Napríklad `#1004`.
order.note	Poznámka priradená k objednávke, ak existuje.
order.created_at	Dátum a čas vytvorenia objednávky. Napríklad `2009-05-30T17:43:51+02:00`. Ak chcete zmeniť formát, použite filter dátumu.

Premenné zákazníka

Pomocou premenných v tejto tabuľke môžete do baliaceho listu pridať informácie o zákazníkovi. Zoznam objednávok si môžete pozrieť na stránke Zákazníci u vášho administrátora Shopify.

Opis premenných zákazníka Liquid, ktoré možno použiť v šablónach baliacich listov
Premenná	Opis
customer.first_name	Krstné meno zákazníka.
customer.last_name	Priezvisko zákazníka.
customer.name	Celé meno zákazníka.
customer.email	E‑mail zákazníka.

Premenné dodacej a fakturačnej adresy zákazníka

Pomocou premenných v tejto tabuľke môžete do baliaceho listu pridať dodaciu alebo fakturačnú adresu zákazníka. Zoznam objednávok si môžete pozrieť na stránke Zákazníci u vášho administrátora Shopify.

Opis premenných adresy zákazníka Liquid, ktoré možno použiť v šablónach baliacich listov
Premenná	Opis
shipping_address.address1 billing_address.address1	Adresa zákazníka.
shipping_address.address2 billing_address.address2	Byt alebo apartmán zákazníka.
shipping_address.first_name billing_address.first_name	Krstné meno zákazníka.
shipping_address.last_name billing_address.last_name	Priezvisko zákazníka.
shipping_address.name billing_address.name	Celé meno zákazníka.
shipping_address.phone billing_address.phone	Telefónne číslo zákazníka.
shipping_address.company billing_address.company	Názov spoločnosti zákazníka pre dodaciu adresu.
shipping_address.city billing_address.city	Mesto zákazníka.
shipping_address.province_code billing_address.province_code	Kód štátu alebo provincie zákazníka. Kód provincie Ontário je napríklad ON.
shipping_address.province billing_address.province	Štát alebo provincia zákazníka.
shipping_address.zip billing_address.zip	Kód ZIP alebo poštové smerovacie číslo zákazníka.
shipping_address.country_code billing_address.country_code	Kód krajiny vášho zákazníka. Kód krajiny pre Kanadu je napríklad CA.
shipping_address.country billing_address.country	Krajina zákazníka.
shipping_address.summary billing_address.summary	Úplná adresa zákazníka.

Premenné pre samostatné položky v zásielke

Pomocou premenných v tejto tabuľke môžete na baliaci list pridať detaily produktu. Ak chcete zobraziť produkty v objednávke, prejdite na stránku Objednávky v administrátorovi Shopify a kliknite na číslo objednávky.

Popis premenných Liquid pre samostatné položky v zásielke, ktoré môžete použiť v šablónach baliacich listov
Premenná	Opis
line_items_in_shipment	Zoznam samostatných položiek, ktoré spoločne patria do zásielky. Jednotlivé samostatné položky môžu byť v slučke ako line_item: `{% for line_item in line_items_in_shipment %} {{ line_item.image }} {{ line_item.title }} ... {% endfor %}` Všetky dostupné atribúty premennej line_item sú uvedené nižšie: `line_item.image` – obrázok produktu (ak existuje). `line_item.title` – názov produktu. Ak má produkt viacero variantov, zahrnie sa aj názov variantu. `line_item.variant_title` – názov variantu produktu. `line_item.vendor` – dodávateľ produktu. `line_item.sku` – SKU produktu. `line_item.quantity` – celkové množstvo pre daný produkt. `line_item.shipping_quantity` – množstvo daného produktu, ktoré sa vybavuje v rámci zásielky. `line_item.properties` – vlastnosti produktu. `line_item.groups` – zoznam skupín samostatných položiek, do ktorých produkt patrí (napríklad balíky alebo doplnky). Každá skupina má nasledujúce atribúty: `group.title` – zobrazovaný názov skupiny. `group.deliverable?` – vráti hodnotu `true`, ak je samostatná položka doplnkom nadradeného produktu, alebo `false`, ak je súčasťou balíka.
includes_all_line_items_in_order	Boolovská hodnota Ak je hodnota `true`, v zásielke sú zahrnuté všetky položky z objednávky. Ak je hodnota `false`, v zásielke nie sú zahrnuté všetky položky z objednávky.

Obrázky

Sú povolené iba obrázky z domény https://cdn.myshopify.com/. Všetky ostatné obrázky sa vyfiltrujú. Môžete zahrnúť akýkoľvek obrázok, ktorý ste nahrali na stránku Súbory v administrátorovi Shopify.

Ak chcete na baliaci list pridať obrázky alebo miniatúry produktov, použite premennú line_item.image.

Príklady premenných baliaceho listu

Nasledujúce príklady ukazujú, ako môžete použiť niektoré premenné baliaceho listu.

now

Na zobrazenie aktuálneho času a dátumu môžete použiť nasledujúci formát:

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

Výstup je:

2018-09-10 14:23

line_items_in_shipment

Premenná line_items_in_shipment zobrazuje pole samostatných položiek, ktoré sú zahrnuté v zásielke.

Napríklad:

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

Polia vrátené v každom zázname line_item sú nasledujú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

Ak váš obchod používa balíky alebo doplnky, môžete zobraziť informácie o skupine pre každú samostatnú položku:

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

line_item.image

Obrázky samostatných položiek môžete zobraziť pomocou nasledujúceho formátu:

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

Množstvo a prepravované množstvo pre samostatné položky môžete zobraziť v nasledujúcom formáte:

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

Napríklad sa môže zobraziť toto:

2 of 5

includes_all_line_items_in_order

Pomocou tejto premennej môžete zobraziť správu, ak doručujete iba niektoré položky z objednávky. Napríklad:

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