كتل 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 على الخصائص التالية. يُدرج رصيد المتجر المنفَق على الطلب كعملية دفع باسم رصيد المتجر. رصيد المتجر المتبقي للعميل غير متاح كمتغير.

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 }}