Персонализирани 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.

Описание на променливите от най-високо ниво, налични за персонализиран блок на 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
Фамилното име на клиента.
email
Имейл адресът на клиента.
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, вижте Справочника за филтри.

Описание на филтрите, достъпни за персонализиран блок на 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 }}