Персонализирани 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, include, render, raw, increment или decrement. Ако вашият блок използва неподдържан таг, разписката няма да се запази и ще видите грешка.
• Персонализираният Liquid блок може да съдържа до 50 КВ код.

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

is_pickup

pickup_location

Обект на поръчката

name

created_at

note

subtotal_price

total_price

shipping_price

total_tip_received

balance_due

change_due

taxes_included

receipt_number

barcode_content

qr_code_content

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

vendor

quantity

price

total_price

discounted_total_price

discounted_unit_price

discounts

selling_plan_name

staff_member_description

custom_attributes

product_metafields

variant_metafields

Обект за транзакция

Всяко плащане в order.transactions съдържа следните свойства. Изразходваният кредит в магазина за поръчката се посочва като плащане с име Store credit. Оставащото салдо по кредита в магазина на клиента не е налично като променлива.

name

payment_type

amount

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

percentage

Обект за данъчен ред

Всеки данъчен ред в order.tax_lines съдържа следните свойства.

title

rate

rate_percentage

price

taxable_amount

Обект за подаръчна карта

Всяка подаръчна карта в purchased_gift_cards съдържа следните свойства.

code

masked_code

balance

created_at

qr_code_content

Метаполетата и свойствата на редовете са два вида.

Метаполетата и свойствата на редовете имат ключове. Достъп до дадена стойност директно чрез нейния ключ:

{{ 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. Винаги използвайте малки букви с долни черти за препратки към стойности с ключове.

Наличието на метаполета за поръчка и клиент зависи от това дали тези метаполета съществуват в записа.

Можете да използвате филтри, за да форматирате информацията във Вашия персонализиран блок в 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 }}

t

{{ 'receipt.total' | t }}

barcode

{{ order.barcode_content | barcode }}

qrcode

{{ order.qr_code_content | qrcode }}

Следните примери добавят съдържание, което не присъства в стандартния шаблон за отпечатана разписка.

За да добавите бележка към поръчката, когато има такава, използвайте следния Liquid:

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

За да добавите SKU до всеки артикул, използвайте следния 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 }}