Mukautetut Liquid-lohkot tulostetuille kuiteille

Mukautetun Liquid-lohkon avulla voit lisätä tulostetun kuitin ylä- tai alatunnisteeseen omaa sisältöäsi, kuten tilauksen tiedot, asiakastiedot, tuotteen ominaisuudet, metakentät ja viivakoodit.

Mukautetut Liquid-lohkot näkyvät valmiiden online- ja Point of Sale -tilausten tulostetuissa kuiteissa. Ne eivät näy tilauksissa, joissa käytetään offline-kassaa.

Voit lisätä mukautetun Liquid-lohkon kuitin visuaalisessa editorissa Shopifyn ohjausnäkymässä. Viittausarvot haetaan kuitin tiedoista tulostuksen yhteydessä. Esimerkiksi seuraava Liquid-koodi lisää tilausta koskevan huomautuksen kuittiin, jos huomautus on olemassa:

{% if order.note %}
  <p>Order note: {{ order.note }}</p>
{% endif %}

Tällä sivulla

Liquidin syntaksisäännöt

Käy läpi seuraavat syntaksisäännöt ennen mukautetun Liquid-lohkon rakentamista:

Muuttujien nimissä käytetään pieniä kirjaimia ja alaviivoja, mikä tunnetaan nimellä snake_case-muoto. Käytä esimerkiksi muotoja order.total_price, order.customer.display_name ja order.line_items.
Raha-arvot ovat pelkkiä numeroita. Muotoile ne money-suodattimella, esimerkiksi {{ order.total_price | money }}.
Suojaa valinnaiset arvot if-lausekkeella, jotta et tulosta tyhjää riviä, esimerkiksi {% if order.customer.email %}{{ order.customer.email }}{% endif %}.
Käy luettelot läpi for-lausekkeella, esimerkiksi {% for item in order.line_items %} ... {% endfor %}.
Joitakin Liquid-tunnisteita ei tueta. Et voi käyttää tunnisteita assign, capture, include, render, raw, increment tai decrement. Jos lohkosi käyttää tunnistetta, jota ei tueta, kuittiasi ei tallenneta ja näet virheilmoituksen.
Mukautettu Liquid-lohko voi sisältää enintään 50 kt koodia.

HTML ja CSS

Voit käyttää mukautetussa Liquid-lohkossa HTML-peruskoodia sisällön rakentamiseen. Näitä ovat esimerkiksi <p>, <br>, <strong>, <em>, otsikot, luettelot ja linkit. Sisältösi käyttää kuitin olemassa olevia fontteja ja kokoja.

Et voi muuttaa kuitin ulkoasua CSS:n avulla. <style>-lohkoja ja style-attribuutteja ei tueta, joten mukautettu Liquid-lohko ei voi muuttaa tai piilottaa sisältöä muualla kuitissa. <script>-tunnisteita, tapahtumakäsittelijöitä, kuten onclick, ja javascript:-linkkejä ei myöskään tueta.

Jos lohkossasi on HTML-koodia, jota ei tueta, kuittiasi ei tallenneta ja näet virheilmoituksen. Poista tukematon HTML-koodi ja tallenna uudelleen.

Muuttujat ja objektit

Mukautettu Liquid-lohko voi viitata seuraaviin objekteihin ja muuttujiin. Joitakin arvoja ei ole oletuskuiteissa, joten mukautettu Liquid-lohko on yksi tapa lisätä ne.

Ylätason muuttujat

Seuraavat ylätason muuttujat ovat käytettävissä mukautetussa Liquid-lohkossa.

Kuvaus mukautetun Liquid-lohkon käytettävissä olevista ylätason muuttujista
Muuttuja	Kuvaus
order	Tulostettava tilaus.
shop	Kauppa.
location	Kauppapaikka.
settings	Kuitin näyttöasetukset, jotka ovat editorissa määritetyt kytkimet.
purchased_gift_cards	Tässä tilauksessa ostetut lahjakortit.
staff_member_description	Vastuullinen henkilöstön jäsen, kun henkilöstön tiedot on asetettu näkyviin.
locale	Kuitin alue, kuten en.
is_pickup	Onko tilaus noutotilaus.
pickup_location	Noutopiste soveltuvin osin.

Tilausobjekti

Tilausobjektin kuvaus
Ominaisuus	Kuvaus
name	Tilauksen nimi, kuten #1001.
created_at	Tilauksen aikaleima. Käytetään `date`-suodattimen kanssa.
note	Tilauksen huomautus.
subtotal_price	Välisumma. Muotoile `money`-suodattimella.
total_price	Loppusumma. Muotoile `money`-suodattimella.
shipping_price	Veloitettu toimitus. Muotoile `money`-suodattimella.
total_tip_received	Juomarahan kokonaissumma. Muotoile `money`-suodattimella.
balance_due	Maksamatta oleva summa. Muotoile `money`-suodattimella.
change_due	Annettu vaihtoraha. Muotoile `money`-suodattimella.
taxes_included	Sisältyykö vero hintoihin.
receipt_number	Kuitin numero.
barcode_content	Viivakoodiin koodattava sisältö.
qr_code_content	QR-koodiin koodattava sisältö. Käytetään `qrcode`-suodattimen kanssa.
line_items	Ostetut tuotteet. Kunkin tuotteen ominaisuudet on lueteltu kohdassa tilauksen rivikohtaobjekti.
transactions	Maksut. Kunkin maksun ominaisuudet on lueteltu kohdassa tapahtumaobjekti.
discounts	Tilaustason alennukset. Kunkin alennuksen ominaisuudet on lueteltu kohdassa alennusobjekti.
tax_lines	Verorivit. Kunkin verorivin ominaisuudet on lueteltu kohdassa veroriviobjekti.
refunds	Tilauksen maksun palautukset.
shipping_address	Toimitusosoite. Osoitteen ominaisuudet on lueteltu kohdassa osoiteobjekti.
customer	Asiakkaan tiedot on lueteltu kohdassa asiakasobjekti.
metafields	Tilauksen metakentät.

Asiakasobjekti

order.customer -objekti sisältää asiakkaan tiedot.

Asiakasobjektin kuvaus
Ominaisuus	Kuvaus
display_name	Asiakkaan näyttönimi.
first_name	Asiakkaan etunimi.
last_name	Asiakkaan sukunimi.
email	Asiakkaan sähköpostiosoite.
phone	Asiakkaan puhelinnumero.
default_address	Asiakkaan oletusosoite.
metafields	Asiakkaan metakentät.

Tilauksen rivikohtaobjekti

Jokainen kohdan order.line_items kohde sisältää seuraavat ominaisuudet.

Tilauksen rivikohtaobjektin kuvaus
Ominaisuus	Kuvaus
name	Tuotteen tai rivin nimi.
variant_title	Versio, esimerkiksi suuri / sininen.
sku	SKU-koodi.
vendor	Myyjä.
quantity	Määrä.
price	Yksikköhinta. Muotoile `money`-suodattimella.
total_price	Rivin loppusumma. Muotoile `money`-suodattimella.
discounted_total_price	Rivin loppusumma alennusten jälkeen. Muotoile `money`-suodattimella.
discounted_unit_price	Yksikkökohtainen hinta alennusten jälkeen. Muotoile `money`-suodattimella.
discounts	Riviin sovelletut alennukset.
selling_plan_name	Mahdollisen toistuvan tilauksen tai myyntimallin nimi.
staff_member_description	Riviin liitetty henkilöstön jäsen.
custom_attributes	Rivikohdan ominaisuudet avaimen mukaan haettuna.
product_metafields	Tuotteen metakentät avaimen mukaan haettuna.
variant_metafields	Version metakentät avaimen mukaan haettuna.

Maksutapahtumaobjekti

Jokainen kohdan order.transactions maksu sisältää seuraavat ominaisuudet. Tilaukseen käytetty kauppakrediitti on lueteltu Store credit ‑nimisenä (Kauppakrediitti) maksuna. Asiakkaan jäljellä oleva kauppakrediitin saldo ei ole saatavilla muuttujana.

Maksutapahtumaobjektin kuvaus
Ominaisuus	Kuvaus
name	Maksun nimi, esimerkiksi Visa, käteinen tai kauppakrediitti.
payment_type	Maksutyypin koodi.
amount	Summa. Muotoile `money`-suodattimella.
kind	Maksutapahtuman tyyppi.
status	Maksutapahtuman tila.
credit_card_number	Piilotettu kortin numero, jos sovellettavissa.
created_at	Maksutapahtuman aikaleima.
additional_details	Maksun lisätietorivit.

Shop-objekti

shop -objekti sisältää kaupan tiedot.

Shop-objektin kuvaus
Ominaisuus	Kuvaus
name	Kaupan nimi.
domain	Kaupan verkkotunnus.
currency	Kaupan valuutta.
id	Kaupan tunnus.

Sijaintiobjekti

location -objekti sisältää myyntipaikan tiedot.

Sijaintiobjektin kuvaus
Ominaisuus	Kuvaus
name	Sijainnin nimi.
address1	Osoitteen ensimmäinen rivi.
address2	Osoitteen toinen rivi.
city	Kaupunki.
province	Maakunta tai osavaltio.
province_code	Maakunnan tai osavaltion koodi.
zip	Postinumero.
country	Maa.
phone	Puhelinnumero.
metafields	Sijainnin metakentät.

Osoiteobjekti

Osoite, kuten order.shipping_address tai order.customer.default_address, sisältää seuraavat ominaisuudet.

Osoiteobjektin kuvaus
Ominaisuus	Kuvaus
company	Yrityksen nimi.
name	Vastaanottajan nimi.
address1	Osoitteen ensimmäinen rivi.
address2	Osoitteen toinen rivi.
city	Kaupunki.
province	Maakunta tai osavaltio.
province_code	Maakunnan tai osavaltion koodi.
zip	Postinumero.
country	Maa.
country_code	Maakoodi.
phone	Puhelinnumero.

Alennusobjekti

Jokainen kohdan order.discounts tai item.discounts kohde sisältää seuraavat ominaisuudet.

Alennusobjektin kuvaus
Ominaisuus	Kuvaus
description	Alennuksen kuvaus.
amount	Alennuksen summa. Muotoile `money`-suodattimella.
percentage	Alennusprosentti.

Veroriviobjekti

Jokainen kohdan order.tax_lines kohde sisältää seuraavat ominaisuudet.

Veroriviobjektin kuvaus
Ominaisuus	Kuvaus
title	Veron nimi.
rate	Verokanta desimaalilukuna.
rate_percentage	Verokanta prosentteina.
price	Veron summa. Muotoile `money`-suodattimella.
taxable_amount	Verollinen summa. Muotoile `money`-suodattimella.

Lahjakorttiobjekti

Jokainen kohdan purchased_gift_cards kohde sisältää seuraavat ominaisuudet.

Lahjakorttiobjektin kuvaus
Ominaisuus	Kuvaus
code	Lahjakortin koodi.
masked_code	Peitetty lahjakortin koodi.
balance	Lahjakortin saldo. Muotoile käyttämällä `money`-suodatinta.
created_at	Lahjakortin aikaleima.
qr_code_content	QR-koodiin koodattava sisältö.

Metakentät ja ominaisuudet

Metakenttiä ja rivikohtien ominaisuuksia on kahdenlaisia.

Rivikohtien metakentät ja ominaisuudet on varustettu avaimella. Käytä arvoa suoraan sen avaimen perusteella:

{{ item.product_metafields.care_instructions }}
{{ item.custom_attributes.engraving }}

Tilauksen ja asiakkaan metakentät ovat luetteloita. Käy ne läpi silmukassa:

{% for m in order.metafields %}
  {{ m.namespace }}.{{ m.key }}: {{ m.value }}
{% endfor %}

Avaimet on normalisoitu käyttämään snake_case-muotoilua. Esimerkiksi avaimeen Care Instructions tai careInstructions viitataan muodossa care_instructions. Viittaa avainarvoihin aina pienaakkosilla ja alaviivoilla.

Tilauksen ja asiakkaan metakenttien saatavuus riippuu siitä, ovatko kyseiset metakentät olemassa tietueessa.

Liquid-suodattimet

Voit muotoilla mukautetun Liquid-lohkon tiedot suodattimien avulla. Voit käyttää suodatinta lisäämällä putkimerkin (|) ja sitten suodattimen Liquid-tulosteen sisään. Esimerkki: {{ order.total_price | money }}.

Myös tavalliset Liquid-suodattimet toimivat. Lisätietoja Liquid-suodattimista on suodattimien viiteoppaassa.

Mukautetussa Liquid-lohkossa käytettävissä olevien suodattimien kuvaus
Suodatin	Esimerkki	Kuvaus
money	{{ order.total_price \| money }}	Muotoilee summan kuitin valuutassa.
date	{{ order.created_at \| date: '%B %e, %Y' }}	Muotoilee päivämäärän tai ajan.
percent	{{ tax_line.rate \| percent }}	Muotoilee desimaaliluvun prosenttiosuutena, esimerkiksi 0,2 muotoon 20 %.
t	{{ 'receipt.total' \| t }}	Palauttaa käännetyn merkinnän.
barcode	{{ order.barcode_content \| barcode }}	Renderöi viivakoodin.
qrcode	{{ order.qr_code_content \| qrcode }}	Renderöi QR-koodin.

Esimerkkejä mukautetuista Liquid-lohkoista

Seuraavat esimerkit lisäävät sisältöä, joka ei sisälly oletusarvoiseen tulostetun kuitin malliin.

Lisää olemassa oleva tilausilmoitus seuraavalla Liquid-koodilla:

{% if order.note %}<p>Note: {{ order.note }}</p>{% endif %}

Lisää SKU kunkin tuotteen viereen seuraavalla Liquid-koodilla:

{% for item in order.line_items %}
  <p>{{ item.name }} — {{ item.sku }} ×{{ item.quantity }}</p>
{% endfor %}

Lisää rivikohdan ominaisuus, esimerkiksi kaiverrus, seuraavalla Liquid-koodilla:

{% for item in order.line_items %}
  {% if item.custom_attributes.engraving %}
    <p>{{ item.name }} — Engraving: {{ item.custom_attributes.engraving }}</p>
  {% endif %}
{% endfor %}

Lisää tuotteen metakenttä, esimerkiksi hoito-ohjeet, seuraavalla Liquid-koodilla:

{% for item in order.line_items %}
  {% if item.product_metafields.care_instructions %}
    <p>{{ item.name }}: {{ item.product_metafields.care_instructions }}</p>
  {% endif %}
{% endfor %}

Lisää asiakkaan metakenttä seuraavalla Liquid-koodilla:

{% for m in order.customer.metafields %}
  {% if m.key == 'loyalty_tier' %}<p>Loyalty tier: {{ m.value }}</p>{% endif %}
{% endfor %}

Lisää tilaukseen linkittävä QR-koodi seuraavalla Liquid-koodilla:

{{ order.qr_code_content | qrcode }}