Персонализирани Liquid блокове за отпечатани касови бележки
Можете да използвате персонализиран блок на Liquid, за да добавите собствено съдържание към заглавката или долния колонтитул на отпечатана разписка, като например подробности за поръчката, информация за клиента, свойства на продукта, метаполета и баркодове.
Персонализираните блокове на Liquid се визуализират върху отпечатаните разписки за завършени онлайн поръчки и поръчки през Point of Sale. Те не се визуализират за поръчки, които използват офлайн плащане.
Можете да добавите персонализиран блок с Liquid от визуалния редактор на разписки в администраторския си панел на Shopify. При отпечатване на разписката се използват стойностите, към които сте посочили препратки в нейните данни. Например следният код на Liquid добавя бележката към поръчката в разписката, ако има такава:
{% if order.note %}
<p>Order note: {{ order.note }}</p>
{% endif %}На тази страница
Правила за синтаксиса на Liquid
Прегледайте следните правила за синтаксиса, преди да създадете персонализиран блок на Liquid:
- Имената на променливите използват малки букви и долни черти – формат, известен като snake_case. Например използвайте
order.total_price,order.customer.display_nameиorder.line_items. - Паричните стойности са обикновени числа. Форматирайте ги чрез филтъра
money, като например{{ order.total_price | money }}. - Защитете незадължителните стойности с оператор
if, за да не отпечатате празен ред, като например{% if order.customer.email %}{{ order.customer.email }}{% endif %}. - Обхождайте списъци чрез оператор
for, като например{% for item in order.line_items %} ... {% endfor %}. - Някои тагове на Liquid не се поддържат. Не можете да използвате
assign,capture,cycle,decrement,ifchanged,include,increment,layout,raw,renderилиsection. Ако блокът Ви използва неподдържан таг, разписката няма да се запази и се показва грешка. - Персонализираният блок на Liquid може да съдържа до 50 КВ код.
Грешките в персонализиран блок на Liquid са маркирани в полето Код на Liquid. Ако кликнете върху Запазване, докато даден блок съдържа грешки, редакторът отваря блока с грешката, за да можете да я поправите.
HTML и CSS
Можете да използвате базов HTML в персонализиран блок на Liquid, за да структурирате съдържанието си, като например <p>, <br>, <strong>, <em>, заглавия, списъци и връзки. Вашето съдържание използва съществуващите шрифтове и размери на разписката.
Не можете да използвате CSS, за да промените външния вид на разписката. Блоковете <style> и атрибутите style не се поддържат, така че персонализираният блок на Liquid не може да променя стила или да скрива съдържание на други места в разписката. Таговете <script>, манипулаторите на събития, като onclick, и връзките javascript: също не се поддържат.
Ако блокът Ви съдържа неподдържан HTML, разписката няма да се запази и се показва грешка. Премахнете неподдържания HTML и след това запазете отново.
Променливи и обекти
Персонализираният блок на Liquid може да реферира следните обекти и променливи. Някои стойности не присъстват в разписката по подразбиране, затова персонализираният блок на Liquid е един от начините да ги добавите.
Променливи от най-високо ниво
Следните променливи от най-високо ниво са налични в персонализиран блок на Liquid.
| Променлива | Описание |
|---|---|
order | Поръчката, която се отпечатва. |
shop | Магазинът. |
location | Местоположението на магазина за търговия на дребно. |
settings | Настройките за показване на разписката, които са превключвателите, конфигурирани в редактора. |
purchased_gift_cards | Подаръчните карти, закупени с тази поръчка. |
staff_member_description | Членът на персонала, към когото е приписана поръчката, когато показването на персонала е включено. |
locale | Езикът и регионът на разписката, като например en. |
is_pickup | Дали поръчката е за получаване. |
pickup_location | Местоположението за вземане, когато е приложимо. |
Обект за поръчка
| Свойство | Описание |
|---|---|
name | Името на поръчката, като например #1001. |
created_at |
Клеймото за дата и час на поръчката. Използвайте с филтъра date.
|
note | Бележката към поръчката. |
subtotal_price |
Междинната сума. Форматирайте чрез филтъра money.
|
total_price |
Общата сума. Форматирайте чрез филтъра money.
|
shipping_price |
Таксуваната доставка. Форматирайте чрез филтъра money.
|
total_tip_received |
Общата сума на бакшиша. Форматирайте чрез филтъра money.
|
balance_due |
Дължимата сума. Форматирайте чрез филтъра money.
|
change_due |
Върнатото ресто. Форматирайте чрез филтъра money.
|
taxes_included | Дали данъкът е включен в цените. |
receipt_number | Номерът на разписката. |
barcode_content | Съдържанието, което да бъде кодирано в баркод. |
qr_code_content |
Съдържанието, което да бъде кодирано в QR код. Използвайте с филтъра qrcode.
|
line_items | Закупените артикули. Свойствата на всеки артикул са изброени в обекта за ред в поръчката. |
transactions | Плащанията. Свойствата на всяко плащане са изброени в обекта за транзакция. |
discounts | Отстъпките на ниво поръчка. Свойствата на всяка отстъпка са изброени в обекта за отстъпка. |
tax_lines | Редовете за данъци. Свойствата на всеки ред за данък са изброени в обекта за ред за данък. |
refunds | Възстановените суми за поръчката. |
shipping_address | Адресът за доставка. Свойствата на адреса са изброени в обекта за адрес. |
customer | Подробностите за клиента, изброени в обекта за клиент. |
metafields | Метаполетата на поръчката. |
Обект за клиент
Обектът order.customer обектът съдържа подробностите за клиента.
| Свойство | Описание |
|---|---|
display_name | Екранното име на клиента. |
first_name | Собственото име на клиента. |
last_name | Фамилното име на клиента. |
| Имейл адресът на клиента. | |
phone | Телефонният номер на клиента. |
default_address | Основният адрес на клиента. |
metafields | Метаполетата на клиента. |
Обект за ред от поръчка
Всеки артикул в order.line_items съдържа следните свойства.
| Свойство | Описание |
|---|---|
name | Името на продукта или реда. |
variant_title | Вариантът, като например Голям / Син. |
sku | Складовата единица на продукт (SKU). |
vendor | Доставчикът. |
quantity | Количеството. |
price |
Единичната цена. Форматирайте с филтъра money.
|
total_price |
Общата сума на реда. Форматирайте с филтъра money.
|
discounted_total_price |
Общата сума на реда след отстъпки. Форматирайте с филтъра money.
|
discounted_unit_price |
Единичната цена след отстъпки. Форматирайте с филтъра money.
|
discounts | Отстъпките, приложени към реда. |
selling_plan_name | Името на абонамента или плана за продажба, ако има такъв. |
staff_member_description | Членът на персонала, причислен към реда. |
custom_attributes | Свойствата на редовете, достъпни чрез техните точни имена. |
product_metafields | Метаполетата на продукта, достъпни чрез ключ. |
variant_metafields | Метаполетата на варианта, достъпни чрез ключ. |
Обект за транзакция
Всяко плащане в order.transactions съдържа следните свойства. Изразходваният за поръчката кредит в магазина се посочва като плащане с името „Кредит в магазина“. Оставащото салдо по кредита в магазина на клиента не е налично като променлива.
| Свойство | Описание |
|---|---|
name | Името на плащането, като например Visa, пари в брой или кредит в магазина. |
payment_type | Кодът на типа плащане. |
amount |
Сумата. Форматирайте с филтъра money.
|
kind | Видът на транзакцията. |
status | Състоянието на транзакцията. |
credit_card_number | Маскираният номер на картата, когато е приложимо. |
created_at | Клеймото за дата и час на транзакцията. |
additional_details | Допълнителни редове с подробности за плащането. |
Обект за магазин
Обектът shop обектът съдържа подробностите за магазина.
| Свойство | Описание |
|---|---|
name | Името на магазина. |
domain | Домейнът на магазина. |
currency | Валутата на магазина. |
id | Идентификаторът на магазина. |
Обект за местоположение
Обектът location обектът съдържа подробностите за местоположението на търговския обект.
| Свойство | Описание |
|---|---|
name | Името на местоположението. |
address1 | Първият ред на адреса. |
address2 | Вторият ред на адреса. |
city | Градът. |
province | Областта или щатът. |
province_code | Кодът на областта или щата. |
zip | Пощенският код. |
country | Държавата. |
phone | Телефонният номер. |
metafields | Метаполетата на местоположението. |
Обект за адрес
Адрес, като например order.shipping_address или order.customer.default_address, съдържа следните свойства.
| Свойство | Описание |
|---|---|
company | Името на компанията. |
name | Името на получателя. |
address1 | Първият ред на адреса. |
address2 | Вторият ред на адреса. |
city | Градът. |
province | Областта или щатът. |
province_code | Кодът на областта или щата. |
zip | Пощенският код. |
country | Държавата. |
country_code | Кодът на държавата. |
phone | Телефонният номер. |
Обект за отстъпка
Всяка отстъпка в order.discounts или item.discounts съдържа следните свойства.
| Свойство | Описание |
|---|---|
description | Описанието на отстъпката. |
amount | Сумата на отстъпката. Форматирайте с филтъра money. |
percentage | Процентът на отстъпката. |
Обект за данъчен ред
Всеки данъчен ред в order.tax_lines съдържа следните свойства.
| Свойство | Описание |
|---|---|
title | Името на данъка. |
rate | Данъчната ставка като десетична дроб. |
rate_percentage | Данъчната ставка като процент. |
price | Сумата на данъка. Форматирайте с филтъра money. |
taxable_amount | Сумата, подлежаща на облагане с данък. Форматирайте с филтъра money. |
Обект за подаръчна карта
Всяка подаръчна карта в purchased_gift_cards съдържа следните свойства.
| Свойство | Описание |
|---|---|
code | Кодът на подаръчната карта. |
masked_code | Маскираният код на подаръчната карта. |
balance | Салдото по подаръчната карта. Форматирайте с филтъра money. |
created_at | Клеймото за дата и час на подаръчната карта. |
qr_code_content | Съдържанието за кодиране в QR код. |
Метаполета и свойства
Метаполетата и свойствата на редовете се предлагат в две форми.
Метаполетата и свойствата на редовете са с ключове. Можете да осъществите директен достъп до стойност чрез нейния ключ:
{{ item.product_metafields.care_instructions }}
{{ item.custom_attributes['Engraving'] }}Метаполетата за поръчка и клиент са списъци. Обходете ги:
{% for m in order.metafields %}
{{ m.namespace }}.{{ m.key }}: {{ m.value }}
{% endfor %}Ключовете на метаполетата се нормализират до snake_case. Ключ като Care Instructions или careInstructions е достъпен като care_instructions. Винаги посочвайте ключовете на метаполетата с малки букви с долни черти.
Имената на свойствата на редовете не са нормализирани. Достъпвайте свойство с точното му име в скоби и кавички. Например, свойство с име Gift wrap е достъпно като item.custom_attributes['Gift wrap'].
Достъпността на метаполетата за поръчка и клиент зависи от това дали тези метаполета съществуват в записа.
Филтри на Liquid
Можете да използвате филтри, за да форматирате информацията във Вашия персонализиран блок на Liquid. За да приложите филтър, добавете символа вертикална черта | и след това филтъра в изхода на Liquid, като например {{ order.total_price | money }}.
Стандартните филтри на Liquid също работят. За да научите повече за филтрите на Liquid, вижте Справочника за филтри.
| Филтър | Пример | Описание |
|---|---|---|
money | {{ order.total_price | money }} | Форматира сума във валутата на разписката. |
date | {{ order.created_at | date: '%B %e, %Y' }} | Форматира дата или час. |
percent | {{ tax_line.rate | percent }} | Форматира десетична дроб като процент, например 0,2 като 20%. |
t | {{ 'receipt.total' | t }} | Връща преведен етикет. |
barcode | {{ order.barcode_content | barcode }} | Изобразява баркод. |
qrcode | {{ order.qr_code_content | qrcode }} | Изобразява QR код. |
Примери за персонализирани блокове на Liquid
Следните примери добавят съдържание, което не е в шаблона за отпечатана разписка по подразбиране.
За да добавите бележка към поръчката, когато има такава, използвайте следния код на Liquid:
{% if order.note %}<p>Note: {{ order.note }}</p>{% endif %}За да добавите складова единица на продукт до всеки артикул, използвайте следния код на Liquid:
{% for item in order.line_items %}
<p>{{ item.name }} — {{ item.sku }} ×{{ item.quantity }}</p>
{% endfor %}За да добавите свойство на ред, като например гравиране, използвайте следния код на Liquid:
{% for item in order.line_items %}
{% if item.custom_attributes['Engraving'] %}
<p>{{ item.name }} — Engraving: {{ item.custom_attributes['Engraving'] }}</p>
{% endif %}
{% endfor %}За да добавите метаполе на продукт, като например инструкции за грижа, използвайте следния код на Liquid:
{% for item in order.line_items %}
{% if item.product_metafields.care_instructions %}
<p>{{ item.name }}: {{ item.product_metafields.care_instructions }}</p>
{% endif %}
{% endfor %}За да добавите метаполе на клиент, използвайте следния код на Liquid:
{% for m in order.customer.metafields %}
{% if m.key == 'loyalty_tier' %}<p>Loyalty tier: {{ m.value }}</p>{% endif %}
{% endfor %}За да добавите QR код, който води към поръчката, използвайте следния код на Liquid:
{{ order.qr_code_content | qrcode }}