مرجع متغيرات الإشعارات

تُعرَض الإشعارات المُرسلة من متجرك باستخدام Liquid. تعد Liquid لغة برمجة بسيطة وسهلة الاستخدام من Shopify. وهي لغة البرمجة نفسها التي تُبنى عليها القوالب من متجر القوالب.

لتعديل الإشعارات التي تُرسَل من متجرك، يمكنك إجراء تخصيصات أساسية على قوالب إشعاراتك. للوصول إلى القائمة الكاملة للإشعارات التي يمكنك تخصيصها، انتقل إلى صفحة الإشعارات في مسؤول Shopify.

للحصول على المساعدة في التغييرات الأكثر تقدمًا، أو لإجراء تغييرات على قوالب الإشعارات المخصصة، يمكنك التواصل مع المجتمع في المنتديات الخاصة بنا، أو يمكنك أيضًا الاستعانة بأحد شركاء Shopify لإجراء التخصيصات نيابةً عنك. تعرّف على المزيد حول الاستعانة بأحد شركاء Shopify.

في هذه الصفحة

خصائص الطلب

يتوفر العديد من خصائص الطلب مباشرةً باستخدام Liquid، وفي القوالب.

أوصاف خصائص Liquid التي يمكنك استخدامها مع كائن الطلب في قوالب الإشعارات
الخاصية	الوصف
`id`	مُعرّف فريد للطلب على مستوى النظام للاستخدام الداخلي. استخدم المثال التالي لإنشاء رابط للطلب في قسم المسؤول في متجرك. على سبيل المثال، يمكنك في قالب طلب جديد إضافة التعليمات البرمجية التالية: `عرض الطلب`
`email`	البريد الإلكتروني المرتبط بالطلب.
`name`	عادةً ما يكون هذا رمز المربع (#) متبوعًا بـ `order_number`. مثال: #1004
`order_name`	مماثل للاسم.
`order_number`	الرقم الفريد للطلب في المتجر، دون البادئة المربع #، أو أي بادئة أو لاحقة أضافها مالك المتجر إلى مُعرّف الطلب في تفضيلات متجره. مثال: 1004
`confirmation_number`	مُعرّف أبجدي رقمي أُنشئ عشوائيًا للطلب والذي قد يُعرض للعميل بدلاً من اسم الطلب المتسلسل. ليس مضمونًا أن تكون هذه القيمة فريدة. مثال: XPAV284CT
`created_at`	تاريخ ووقت إنشاء العميل للطلب. يمكنك تنسيق ذلك باستخدام عامل تصفية التاريخ. مثال: 2009-05-30T17:43:51+02:00
`payment_terms`	تُحدد شروط الدفع التاريخ المستحق فيه سداد مبلغ الطلب. تعرّف على كيفية إضافة شروط الدفع إلى فواتير الطلبات. لمزيد من التفاصيل، راجع مرجع Liquid لـ payment_terms.
`destination`	الوجهة التي يجب إرسال العناصر إليها.
`tags`	تُرجِع مصفوفة بجميع علامات الطلب. يتم إرجاع العلامات بترتيب أبجدي. قد لا تتوفر العلامات التي يتم تطبيقها ديناميكيًا بواسطة التطبيقات أو ميزات المنصة، مثل علامة `Shopify Collective`، عند إنشاء رسالة البريد الإلكتروني للإشعار. لاكتشاف عناصر من ميزة معينة، تحقق من العلامات على مستوى المنتج لكل عنصر من عناصر الطلب بدلاً من ذلك. راجع وثائق Liquid المرجعية لمزيد من التفاصيل.
`transactions`	تُرجِع مصفوفة بـ المعاملات من الطلب.
`tax_price`	إجمالي الضرائب المجمعة لجميع العناصر في الطلب.
`tax_lines`	الضرائب مقسّمة حسب نوع الضريبة: `{% for tax_line in tax_lines %} {{ tax_line.title }} ({{ tax_line.rate_percentage }}%) : {{ tax_line.price \| money_with_currency }} {% endfor %}`
`tax_line.title`	اسم الضريبة. على سبيل المثال، QST أو VAT.
`tax_line.price`	مبلغ الضريبة.
`tax_line.rate`	معدل الضريبة كعدد عشري. سيُرجِع 0.175 إذا كان 17.5%.
`tax_line.rate_percentage`	معدل الضريبة بصيغة مقروءة. سيُرجِع 17.5 إذا كان المعدل 0.175.
`customer`	كائن العميل الذي يحتوي على سمات مُخرجات العميل.
`billing_address`	عنوان إرسال الفواتير.
`billing_address.first_name`	الاسم الأول للعميل.
`billing_address.last_name`	الاسم الأخير للعميل.
`billing_address.company`	اسم الشركة لإرسال الفواتير.
`billing_address.phone`	رقم الهاتف من عنوان إرسال الفواتير.
`shop.name`	اسم متجرك.
`shop.phone`	رقم هاتف متجرك.
`subtotal_price`	مجموع أسعار عناصر الطلب بعد خصم أي خصم على العنصر أو خصم على سلة التسوق. لا يشمل المجموع الفرعي الضرائب (ما لم تكن الضرائب مشمولة في الأسعار)، أو تكاليف الشحن، أو الإكراميات.
`discounts`	قائمة بـ الخصومات.
`discounts_amount`	مبلغ الخصم المُطبّق بواسطة جميع الخصومات. مثال: +$5.00
`discounts_savings`	مبلغ المدخرات الناتج عن جميع الخصومات. مثال: -$5.00
`total_price`	إجمالي الطلب (المجموع الفرعي + تكلفة الشحن - خصم الشحن + الضريبة).
`financial_status`	حالة الدفع الحالية. إحدى القيم التالية: nil، `pending`، `authorized`، `paid`، `voided`، `refunded`.
`requires_shipping`	(قيمة منطقية) تُرجِع true إذا كان هناك عنصر واحد على الأقل في الطلب يتطلب الشحن.
`shipping_method.title`	اسم سعر الشحن. في الإشعارات الموجهة للعملاء، تتم ترجمة اسم سعر الشحن إلى اللغة التي أتم بها العميل عملية الدفع، عندما تكون اللغة مختلفة عن اللغة الافتراضية للمتجر. مثال: الشحن العادي
`shipping_method.price`	سعر الشحن شاملاً أي خصم على الشحن. مثال: `{{ shipping_method.price \| money }}`
`shipping_price`	سعر الشحن. مثال: `{{ shipping_price \| money }}`
`shipping_address`	عنوان الشحن.
`shipping_address.first_name`	الاسم الأول لعنوان الشحن.
`shipping_address.company`	اسم الشركة لعنوان الشحن.
`shipping_address.phone`	رقم الهاتف من عنوان الشحن.
`line_items`	قائمة بجميع عناصر الطلب.
`line_items_including_zero_quantity`	قائمة بجميع عناصر الطلب، بما في ذلك العناصر التي كميتها صفر. تكون كمية عناصر الطلب صفرًا عند استرداد قيمتها بالكامل.
`line_item_groups`(Orders and POS only)	قائمة بجميع مجموعات عناصر الطلب التي تحتوي على مكونات عنصر الطلب.
`item_count`	مجموع كميات جميع العناصر.
`fulfillment_status`	حالة التنفيذ الحالية للطلب. إحدى القيم التالية: `unfulfilled`، `partial`، `fulfilled`.
`note`	الملاحظة المُرفقة بالطلب. يمكن الحصول على الملاحظة من العميل و/أو تعديلها في شاشة تفاصيل الطلب ضمن واجهة المسؤول.
`attributes`	أي سمات تم إرفاقها بالطلب. مثال: `{{ attributes.gift-note }}`
`metafields`	أي حقول وصفية في الطلب. استخدم الصيغة التالية: metafields.NAMESPACE.KEY
`referring_site`	يحتوي على رابط URL لمصدر الإحالة الذي جلب العميل إلى متجرك. مثال: `https://www.google.com/?s=great+products`
`landing_site`	يحتوي على مسار صفحة الهبوط التي استخدمها العميل. هذه هي الصفحة الأولى التي رآها العميل عند وصوله إلى المتجر. مثال: `/products/great-product?ref=my-tracking-token`
`landing_site_ref`	يراجع صفحة الهبوط ويستخرج معلمة مرجعية منها. يمكن أن تكون المعلمات المرجعية: `ref`، `source`، `r`. إذا كانت `landing_site` هي `/products/great-product?ref=my-tracking-token`، فإن `landing_site_ref` هو `my-tracking-token`. يمكنك تنفيذ إجراء معين إذا كانت قيمة ref الخاصة بك تساوي قيمة معينة: `{% if landing_site_ref == 'my-tracking-token' %} الإجراء الخاص بي... {% endif %}`
`cancelled`	(قيمة منطقية) تُرجِع true إذا تم إلغاء الطلب.
`cancelled_at`	وقت إلغاء الطلب.
`cancel_reason`	السبب المحدد عند إلغاء الطلب. إحدى القيم التالية: `inventory`، `customer`، `declined`، `fraud`، أو `other`.
`has_high_risks?`(deprecated)	تُرجِع true إذا كان الطلب عالي المخاطر
`unique_gateways`	تُرجِع قائمة بمزودي الدفع الفريدين في الطلب. على سبيل المثال، إذا دفع شخص ما باستخدام Visa وMastercard ونقدًا، فستكون القائمة المُرجعة هي `shopify_payments, cash`.
`location`(POS only)	تعرض الموقع الفعلي للطلب. تتوفر العديد من خصائص الموقع المدرجة هنا. يمكنك تكوين المواقع في قسم المواقع في المسؤول.
`order_status_url`	تُرجِع رابطًا إلى صفحة حالة الطلب لهذا الطلب.
`fulfilled_line_items`(deprecated)	قائمة بـ عناصر الطلب التي تم تنفيذها.
`unfulfilled_line_items`(deprecated)	قائمة بـ عناصر الطلب التي لم يتم تنفيذها بالكامل.
`b2b?`	يُرجع القيمة true إذا كان الطلب طلب B2B. استخدِم الخاصية مع متغيرات B2B لعرض المعلومات ذات الصلة، مثل اسم الشركة، وموقع الشركة، والعنوان في رسائل البريد الإلكتروني. على سبيل المثال، في طلبات B2B، يمكنك إضافة ترويسة إلى قالب يتضمن المعلومات التالية: `{% if b2b? %} <p> Customer: {{ customer.name }} <p> Company: {{ company.name }} <p> Location: {{ company_location.name }} {% endif%}`
`company`	الشركة التي تبيع لها في طلب B2B.
`company.name`	اسم الشركة في طلب B2B.
`company.id`	معرّف الشركة في طلب B2B.
`company_location`	موقع الشركة في طلب B2B. يمكن أن يكون للشركة التي تشتري منك أكثر من موقع واحد.
`company_location.name`	اسم موقع الشركة في طلب B2B.
`company_location.id`	رقم معرّف موقع الشركة في طلب B2B.
`company_location.shipping_address`	عنوان الشحن لموقع الشركة في طلب B2B.
`company_location.billing_address`	عنوان إرسال الفواتير لموقع الشركة في طلب B2B.
`customer_order_url`	صفحة حالة الطلب الجديدة الخاصة بطلبٍ طلبَ العميل إرجاعه باستخدام حسابات العملاء.

خصائص مسودة الطلب

أوصاف خصائص Liquid التي يمكنك استخدامها مع كائن مسودة الطلب في قوالب الإشعارات
الخاصية	الوصف
`id`	معرّف فريد لمسودة الطلب للاستخدام الداخلي.
`invoice_url`	رابط يمكن للعميل اتباعه لدفع الفاتورة باستخدام صفحة الدفع الآمنة من Shopify.
`reserve_inventory_until`	التاريخ والوقت اللذان تُحجز حتى حلولهما عناصر السطر في المسودة، على سبيل المثال، `2015-05-30T17:43:51+02:00`. يمكنك تنسيق التواريخ باستخدام عامل تصفية التاريخ في Liquid.
`user`	آخر موظف قام بتعديل مسودة الطلب.
`user.name`	اسم آخر موظف قام بتعديل مسودة الطلب.
`user.email`	عنوان البريد الإلكتروني لآخر موظف قام بتعديل مسودة الطلب.
`email`	عنوان البريد الإلكتروني المرتبط بمسودة الطلب.
`name`	الـ `number` الفريد لمسودة الطلب، مسبوقًا بعلامة الرقم `#`.
`number`	الرقم الفريد لمسودة الطلب بدون بادئة أو لاحقة الطلب.
`created_at`	التاريخ والوقت اللذان أنشأ فيهما العميل مسودة الطلب، على سبيل المثال، `2009-05-30T17:43:51+02:00`. يمكنك تنسيق التواريخ باستخدام عامل تصفية التاريخ في Liquid.
`tags`	يُرجع مصفوفة تتضمن جميع إشارات الطلب. يتم إرجاع الإشارات بترتيب أبجدي. راجع وثائق مراجع Liquid للحصول على مزيد من التفاصيل.
`tax_price`	إجمالي الضرائب المجمعة لجميع العناصر في مسودة الطلب.
`tax_lines`	الضرائب مفصلة حسب نوع الضريبة: `{% for tax_line in tax_lines %} {{ tax_line.title }} ({{ tax_line.rate_percentage }}%) : {{ tax_line.price \| money_with_currency }} {% endfor %}`
`tax_line.title`	اسم الضريبة. أمثلة: QST أو VAT
`tax_line.price`	مبلغ الضريبة.
`tax_line.rate`	معدّل الضريبة في شكل عشري. على سبيل المثال، معدل ضريبة بنسبة 17.5% سيُرجع القيمة `0.175`.
`tax_line.rate_percentage`	معدّل الضريبة في شكل نسبة مئوية. على سبيل المثال، `rate` بقيمة 0.175 سيُرجع `17.5`.
`customer`	كائن العميل الذي يحتوي على سمات مُخرجات العميل.
`billing_address`	عنوان إرسال الفواتير لمسودة الطلب.
`billing_address.first_name`	الاسم الأول للعميل.
`billing_address.last_name`	الاسم الأخير للعميل.
`billing_address.company`	اسم الشركة في عنوان إرسال الفواتير.
`billing_address.phone`	رقم الهاتف في عنوان إرسال الفواتير.
`shop.name`	اسم متجرك.
`shop.phone`	رقم هاتف متجرك.
`subtotal_price`	مجموع أسعار عناصر السطر في مسودة الطلب بعد خصم أي خصومات على عناصر السطر أو خصومات سلة التسوق. لا يشمل الإجمالي الفرعي الضرائب (ما لم تكن الضرائب مشمولة في الأسعار) أو تكاليف الشحن.
`discounts`	قائمة بـ الخصومات.
`discounts_amount`	مبلغ الخصم المُطبَّق بفعل جميع الخصومات. مثال: +$5.00
`discounts_savings`	مبلغ التوفير الناتج عن جميع الخصومات. مثال: -$5.00
`total_price`	السعر الإجمالي للطلب (الإجمالي الفرعي + تكلفة الشحن - خصم الشحن + الضريبة).
`amount_due_now`	المبلغ المطلوب في فاتورة مسودة الطلب.
`requires_shipping`	يُرجع القيمة `true` إذا كان هناك عنصر واحد على الأقل في مسودة الطلب يتطلب الشحن. ويُرجع القيمة `false` إذا لم تكن هناك أي عناصر في مسودة الطلب تتطلب الشحن.
`shipping_method.title`	اسم سعر الشحن. مثال: شحن عادي
`shipping_method.price`	سعر طريقة الشحن. يُرجع نفس المعلومات مثل `shipping_price`.
`shipping_price`	سعر الشحن. يمكنك تنسيق هذا المبلغ باستخدام عوامل تصفية الأموال في Liquid.
`shipping_address`	عنوان الشحن. ملاحظة: على عكس الطلبات العادية، قد يكون عنوان الشحن الخاص بمسودة الطلب غير مكتمل.
`shipping_address.first_name`	الاسم الأول لعنوان الشحن.
`shipping_address.company`	اسم الشركة في عنوان الشحن.
`shipping_address.phone`	رقم الهاتف في عنوان الشحن.
`line_items`	قائمة بجميع عناصر السطر في مسودة الطلب.
`item_count`	مجموع كافة كميات العناصر في مسودة الطلب.
`note`	الملاحظة المرفقة بمسودة الطلب. يمكن الحصول على الملاحظة من العميل وتعديلها أيضًا في شاشة تفاصيل مسودة الطلب في مسؤول Shopify.
`metafields`	أي حقول وصفية في مسودة الطلب. استخدِم البنية التالية: metafields.NAMESPACE.KEY
`location`	الموقع الفعلي للطلب. تتوفر العديد من خصائص الموقع. يمكنك تكوين المواقع في صفحة المواقع ضمن مسؤول Shopify الخاص بك.
`b2b?`	يُرجع القيمة true إذا كان الطلب طلب B2B. استخدِم الخاصية مع متغيرات B2B لعرض المعلومات ذات الصلة، مثل اسم الشركة، وموقع الشركة، والعنوان في رسائل البريد الإلكتروني. على سبيل المثال، في طلبات B2B، يمكنك إضافة ترويسة إلى قالب يتضمن المعلومات التالية: `{% if b2b? %} <p> Customer: {{ customer.name }} <p> Company: {{ company.name }} <p> Location: {{ company_location.name }} {% endif%}`
`company`	الشركة التي تبيع لها في طلب B2B.
`company.name`	اسم الشركة في طلب B2B.
`company.id`	معرّف الشركة في طلب B2B.
`company_location`	موقع الشركة في طلب B2B. يمكن أن يكون للشركة التي تشتري منك أكثر من موقع واحد.
`company_location.name`	اسم موقع الشركة في طلب B2B.
`company_location.id`	رقم معرّف موقع الشركة في طلب B2B.
`company_location.shipping_address`	عنوان الشحن لموقع الشركة في طلب B2B.
`company_location.billing_address`	عنوان إرسال الفواتير لموقع الشركة في طلب B2B.
`payment_methods`	قائمة بطرق الدفع المحفوظة والمتاحة لمعالجة إجمالي المسودة.
`payment_method.payment_instrument`	وسيلة الدفع، التي تحتوي على تفاصيل حول طريقة الدفع المحفوظة.
`payment_method.payment_instrument.payment_type`	نوع طريقة الدفع المحفوظة. على سبيل المثال "credit_card, apple_pay"
`payment_method.payment_instrument.credit_card_brand`	العلامة التجارية للبطاقة، عندما تكون قيمة `payment_type` هي "credit_card"
`payment_method.payment_instrument.credit_card_company`	شركة البطاقة، عندما تكون قيمة `payment_type` هي "credit_card"
`payment_method.payment_instrument.credit_card_company`	آخر 4 أرقام من البطاقة، عندما تكون قيمة `payment_type` هي "credit_card"

خصائص جدول الدفع

أوصاف خصائص Liquid التي يمكنك استخدامها مع كائن جدول الدفع في قوالب الإشعارات
الخاصية	الوصف
`payment_schedule.amount_due`	المبلغ المستحق الدفع لجدول الدفع. يمكنك تنسيق المبالغ مع العملات باستخدام فلتر money الخاص بـ Liquid.
`payment_schedule.due_at`	تاريخ استحقاق جدول الدفع. يمكنك تنسيق التواريخ باستخدام عامل تصفية التاريخ في Liquid.
`payment_schedule.due_in_days`	عدد الأيام المتبقية حتى تاريخ الاستحقاق إذا كان جدول الدفع لا يزال مستحقًا (غير مدفوع).
`payment_schedule.due_later?`	يعرض القيمة true (صحيح) إذا لم يتم دفع جدول الدفع وكان تاريخ استحقاقه في المستقبل.
`payment_schedule.number_of_days_overdue?`	عدد الأيام التي انقضت من تاريخ الاستحقاق عندما يكون جدول الدفع متأخرًا.
`payment_schedule.overdue?`	يعرض القيمة true (صحيح) إذا لم يتم دفع جدول الدفع وانقضى تاريخ استحقاقه.

خصائص حالة الدفع

أوصاف خصائص Liquid التي يمكنك استخدامها مع كائن حالة الدفع في قوالب الإشعارات
الخاصية	الوصف
`has_pending_payment`	(قيمة منطقية) يعرض القيمة true (صحيح) إذا كان الطلب يحتوي على معاملة بدفع معلق. تعرّف على المزيد حول المدفوعات المعلقة.
`buyer_action_required`	(قيمة منطقية) يعرض القيمة true (صحيح) إذا كان الطلب يحتوي على معاملة بدفع معلق، ويتطلب الأمر اتخاذ المشتري لإجراء لإلغاء حظر الدفع. عندما تعرض هذه القيمة true (صحيح) وتدعم طريقة الدفع تعليمات الدفع، فإن `buyer_pending_payment_instructions` يوفر تفاصيل يمكن للعميل استخدامها لإكمال عملية الشراء دون اتصال بالإنترنت. تعرّف على المزيد حول كائن transaction في Liquid.

خصائص مكوّن الحزمة

يحتوي كل bundle_component في قائمة line_item.bundle_components على الخصائص التالية. (الطلبات المسودة فقط)

أوصاف خصائص Liquid التي يمكنك استخدامها مع كائن مكوّن الحزمة في قوالب الإشعارات
الخاصية	الوصف
`bundle_component.image_url`	عنوان URL لصورة مكوّن الحزمة.
`bundle_component.product.title`	عنوان منتج مكوّن الحزمة.
`bundle_component.quantity`	كمية مكوّن الحزمة.
`bundle_component.variant.title`	الأسماء الحالية لقيم خيارات متغيّر مكوّن الحزمة، مفصولة بأحرف `/`. مثال: صغير / أحمر

خصائص المكوّن

يحتوي كل component في قائمة line_item.components على الخصائص التالية. (عمليات الدفع المتروكة فقط) `

أوصاف خصائص Liquid التي يمكنك استخدامها مع كائن المكوّن في قوالب الإشعارات
الخاصية	الوصف
`component.image_url`	عنوان URL لصورة المكوّن.
`component.product.title`	عنوان منتج المكوّن.
`component.quantity`	كمية المكوّن.
`component.variant.title`	الأسماء الحالية لقيم خيارات متغيّر المكوّن، مفصولة بأحرف `/`. مثال: صغير / أحمر

خصائص عنصر السطر

يحتوي كل line في قائمة line_items أو subtotal_line_items على الخصائص التالية.

أوصاف خصائص Liquid التي يمكنك استخدامها مع كائن عنصر السطر في قوالب الإشعارات
الخاصية	الوصف
`line.applied_discounts`(POS and draft orders only)	قائمة الخصومات المطبقة على هذا العنصر (يحتوي كل خصم على الخصائص `title` و`code` و`amount` و`savings` و`type`).
`line.bundle_components`(Draft orders only)	قائمة بعناصر السطر التي تمثل مكوّنات حزمة لهذا العنصر. يتم عرض قائمة فقط إذا كان عنصر السطر هذا عبارة عن منتج حزمة.
`line.bundle_parent?`(Draft orders only)	(قيمة منطقية) يعرض القيمة true (صحيح) إذا كان عنصر السطر عبارة عن منتج حزمة.
`line.components`(Abandoned checkout only)	قائمة بعناصر السطر التي تمثل مكوّنات لهذا العنصر.
`line.parent?`(Abandoned checkout only)	(قيمة منطقية) يعرض القيمة true (صحيح) إذا كان عنصر السطر يحتوي على مكوّنات.
`line.custom`(Draft orders only)	(قيمة منطقية) يعرض القيمة true (صحيح) إذا كان العنصر عبارة عن عنصر سطر مخصص لطلب مسودة.
`line.delivery_agreement`	اتفاقية التسليم المرتبطة بعنصر السطر هذا.
`line.grams`	وزن العنصر الواحد.
`line.groups`	مجموعة عناصر السطر للعنصر.
`line.image`	يعرض عنوان URL للصورة المرتبطة بعنصر السطر هذا. يمكنك أيضًا استخدام فلتر img_url للحصول على أحجام صور محددة، على سبيل المثال `{{ line.image \| img_url: 'small' }}`
`line.line_price`	السعر مضروبًا في كمية ذلك العنصر.
`line.original_line_price`	السعر المجمّع لكمية العناصر المضمّنة في السطر، قبل تطبيق الخصومات.
`line.final_line_price`	السعر المجمّع لجميع العناصر في عنصر السطر، بما في ذلك جميع مبالغ الخصم على مستوى السطر.
`line.pre_tax_price`	السعر قبل الضريبة لعناصر السطر، مضروبًا في كمية عنصر السطر المشتراة.
`line.price`	سعر العنصر الواحد.
`line.product.metafields`	أي حقول وصفية على مستوى المنتج. استخدِم البنية التالية: line.product.metafields.NAMESPACE.KEY
`line.product.title`	الاسم الحالي للمنتج.
`line.product.vendor`	مورّد العنصر.
`line.properties`	يعرض مصفوفة من المعلومات المخصصة لعنصر ما. يتم تحديد خصائص عنصر السطر بواسطة العميل في صفحة المنتج، قبل إضافة منتج إلى سلة التسوق.
`line.quantity`	كمية ذلك العنصر.
`line.current_quantity`	الكمية الحالية للعنصر بعد عمليات الإزالة.
`line.requires_shipping`	(قيمة منطقية) يعرض القيمة true (صحيح) إذا كان متغيّر العنصر يحتوي على إعداد منتج مادي مفعّلًا في صفحة المنتج.
`line.selling_plan_allocation`	يعرض كائن `selling_plan_allocation`، والذي يصف كيفية تأثير خطة البيع مثل الاشتراك على عنصر السطر.
`line.taxable`	(قيمة منطقية) يعرض القيمة true (صحيح) إذا كان مربع الاختيار "فرض ضرائب على هذا المنتج" محددًا لمتغيّر العنصر في صفحة المنتج.
`line.title`	اسم المنتج وقت البيع، متبوعًا بشرطة واسم المتغيّر وقت البيع. لا يتم تضمين اسم المتغيّر عندما يكون "العنوان الافتراضي" (Default Title). في الإشعارات الموجهة للعملاء، تتم ترجمة اسم المنتج واسم المتغيّر إلى اللغة التي أتم بها العميل عملية الدفع، وذلك عندما تكون اللغة مختلفة عن لغة المتجر الافتراضية.
`line.url`	عنوان URL النسبي لمتغيّر عنصر السطر. لا يشتمل عنوان URL النسبي على عنوان URL الأساسي لمتجرك (`mystore.myshopify.com`).
`line.variant.barcode`	الباركود المرتبط بمتغيّر المنتج.
`line.variant.compare_at_price`	سعر المقارنة المرتبط بمتغيّر المنتج.
`line.variant.image`	صورة متغيّر المنتج. يعرض صورة فقط إذا كانت هناك صورة محددة معينة للمتغيّر في عنصر السطر.
`line.variant.metafields`	أي حقول وصفية على مستوى المتغيّر. استخدِم البنية التالية: line.variant.metafields.NAMESPACE.KEY
`line.variant.sku`	رمز SKU المرتبط بمتغير المنتج.
`line.variant.title`	الأسماء الحالية لقيم خيارات المتغير، مفصول بينها بعلامات `/`. مثال: صغير / أحمر
`line.refunded.quantity`(within refund notifications)	كمية العنصر المراد استرداد قيمته. يمكنك استخدام هذه الخاصية لإضافة معرّف للعناصر المستردة في الطلب. على سبيل المثال: `{% if line.refunded_quantity > 0 %}Refunded line identifier{% endif %}`

اكتشاف عناصر Shopify Collective في قوالب الإشعارات

تُطبَّق الإشارة Shopify Collective على الطلب بعد إرسال رسالة البريد الإلكتروني لتأكيد الطلب، لذلك لا تكون القيمة {% if tags contains 'Shopify Collective' %} مساوية لـ true أبدًا في قالب تأكيد الطلب. لاكتشاف عناصر Shopify Collective، تحقق من الإشارات على مستوى المنتج لكل عنصر سطر بدلاً من ذلك:

{% assign has_collective_item = false %}
{% for line in line_items %}
  {% if line.product.tags contains 'Shopify Collective' %}
    {% assign has_collective_item = true %}
  {% endif %}
{% endfor %}

{% if has_collective_item %}
  <!-- Collective-specific content -->
{% endif %}

خصائص مجموعة عناصر السطر

تحتوي كل line_item_group في قائمة line_item_groups على الخصائص التالية.

أوصاف خصائص Liquid التي يمكنك استخدامها مع كائن مجموعة عناصر السطر في قوالب الإشعارات
الخاصية	الوصف
`line_item_group.display_title`	عنوان مجموعة عناصر السطر.
`line_item_group.components`	قائمة بـ مكونات عنصر السطر المنتمية للمجموعة.
`line_item_group.image`	صورة مجموعة عناصر السطر.
`line_item_group.product_id`	معرّف المنتج لمجموعة عناصر السطر.
`line_item_group.variant`	كائن المتغير لمجموعة عناصر السطر.
`line_item_group.variant_id`	معرّف المتغير لمجموعة عناصر السطر.

خصائص الاسترداد

أوصاف خصائص Liquid التي يمكنك استخدامها مع كائن الاسترداد في قوالب الإشعارات
الخاصية	الوصف
`amount`	المبلغ المالي المسترد.
`refund_line_items`	قائمة بـ عناصر سطر الاسترداد المراد استرداد قيمتها.

خصائص Refund_line_item

يحتوي كل refund_line في قائمة refund_line_items على الخصائص التالية:

أوصاف خصائص Liquid التي يمكنك استخدامها مع كائن عناصر سطر الاسترداد في قوالب الإشعارات
الخاصية	الوصف
`refund_line.line_item`	الـ line_item الذي يُسترد مبلغه. يتيح ذلك الوصول إلى جميع خصائص line_item.
`refund_line.quantity`	كمية عنصر السطر المراد استرداد مبلغه.

خصائص التلبية

أوصاف خصائص Liquid التي يمكنك استخدامها مع كائن التلبية في قوالب الإشعارات
الخاصية	الوصف
`service_name`	اسم الخدمة المخصصة كما هو محدد في صفحة الإعدادات > الشحن والتسليم. (طلب التلبية فقط)
`fulfillment.estimated_delivery_at`	تاريخ التسليم المُقدّر بناءً على رقم التتبع (إن وُجد) المُقدّم من قِبل إحدى شركات الشحن التالية: USPS أو FedEx أو UPS أو Canada Post (كندا فقط). لا تتوفر هذه الخاصية إلا عند استخدام أسعار شركات الشحن المحتسبة.
`fulfillment.fulfillment_line_items`	قائمة بـ عناصر سطر التلبية المراد تلبيتها.
`fulfillment.item_count`	مجموع كميات جميع العناصر. إجمالي عدد العناصر التي تتم تلبيتها.
`fulfillment.requires_shipping`	(منطقية) تُرجع القيمة true إذا كان طلب التلبية هذا يتطلب شحنًا.
`fulfillment.tracking_company`	الشركة التي تقوم بالتتبع.
`fulfillment.tracking_numbers`	قائمة بأرقام التتبع.
`fulfillment.tracking_urls`	قائمة بمسارات URL للتتبع.
`items_to_fulfill`(deprecated)	قائمة بـ عناصر السطر المراد تلبيتها بواسطة خدمة التلبية المخصصة هذه. (طلب التلبية فقط)
`items_to_fulfill_count`(deprecated)	إجمالي عدد العناصر المراد تلبيتها بواسطة هذا الطلب. (طلب التلبية فقط)

خصائص Fulfillment_line_item

يحتوي كل fulfillment_line في قائمة fulfillment_line_items على الخصائص التالية.

أوصاف خصائص Liquid التي يمكنك استخدامها مع كائن عناصر سطر التلبية في قوالب الإشعارات
الخاصية	الوصف
`fulfillment_line.line_item`	الـ line_item الذي تتم تلبيته. يتيح ذلك الوصول إلى جميع خصائص line_item.
`fulfillment_line.quantity`	كمية عنصر السطر الذي تتم تلبيته.

خصائص الطرد المُجهّز

يشتمل الطرد المُجهّز على العناصر المحددة كجاهزة للاستلام.

أوصاف خصائص Liquid التي يمكنك استخدامها مع كائن الطرد المُجهّز في قوالب الإشعارات
الخاصية	الوصف
`item_count`	مجموع كميات جميع العناصر في الطرد المُجهّز.
`prepared_package_line_items`	قائمة بـ عناصر سطر الطرد المُجهّز.

خصائص Prepared_package_line_item

يحتوي كل prepared_package_line_item في قائمة prepared_package_line_items على الخصائص التالية.

أوصاف خصائص Liquid التي يمكنك استخدامها مع كائن عنصر سطر الطرد المُجهّز في قوالب الإشعارات
الخاصية	الوصف
`line_item`	الـ line_item المرتبط. يتيح ذلك الوصول إلى جميع خصائص line_item.
`quantity`	كمية عنصر السطر المحدد كجاهز للاستلام.

خصائص التسليم

أوصاف خصائص Liquid التي يمكنك استخدامها مع كائن التسليم في قوالب الإشعارات
الخاصية	الوصف
`delivery_agreements`	قائمة بجميع اتفاقيات التسليم الخاصة بالطلب.
`delivery_instructions`	معلومات التسليم المحلي لمشاركتها مع العميل. يتم التحكم في هذه المعلومات من خلال حقل معلومات التسليم في إعدادات التسليم المحلي الخاصة بك.
`consolidated_estimated_delivery_time`	معلومات تواريخ تسليم الطلب لمشاركتها مع العميل. يتم التحكم في هذه المعلومات من خلال إعداد وقت المعالجة الذي قمت بإعداده في صفحة الشحن والتسليم. عندما يحتوي الطلب على طرق تسليم متعددة، يتم عرض قائمة بطرق وتواريخ التسليم.
`has_multiple_delivery_methods`	(منطقية) تُرجع القيمة true إذا كان الطلب يحتوي على طرق تسليم متعددة.

خصائص اتفاقية التسليم

أوصاف خصائص Liquid التي يمكنك استخدامها مع كائن اتفاقية التسليم في قوالب الإشعارات
الخاصية	الوصف
`delivery_agreement.delivery_method_type`	نوع طريقة التسليم.
`delivery_agreement.delivery_method_name`	نوع طريقة التسليم مترجمًا إلى لغة إتمام الدفع التي استخدمها المشتري، عندما تكون اللغة مختلفة عن لغة المتجر الافتراضية.
`delivery_agreement.line_item_groups`	قائمة بجميع مجموعات عناصر السطر التي تحتوي على مكونات عناصر السطر المجمعة في اتفاقية التسليم.
`delivery_agreement.line_items`	قائمة بجميع عناصر السطر المرتبطة باتفاقية التسليم هذه.

خصائص الخصم

يوجد نوعان من خصائص الخصم.

تشرح discount_applications سبب وكيفية تطبيق الخصم على العنصر.

تصف discount_allocations كيف يؤثر خصم معين على عنصر السطر وكيف يقلل السعر. يجب عليك استخدام هذه الخاصية على مستوى عنصر السطر.

يمكنك الجمع بين هذه الخصائص لعرض معلومات الخصم على مستوى عنصر السطر أو الطلب.

مثال

يتحقق هذا المثال مما إذا كان قد تم تطبيق خصم على عنصر السطر. إذا لم يتم تطبيق الخصم على مستوى الطلب (all)، فسيتم عرض اسم الخصم ومبلغه.

{% if line.discount_allocations %}
	{% for discount_allocation in line.discount_allocations %}
    	{% if discount_allocation.discount_application.target_selection != 'all' %}
        	{{ discount_allocation.discount_application.title | upcase }}
        	(-{{ discount_allocation.amount | money }})
    	{% endif %}
	{% endfor %}
{% endif %}

قد تكون النتيجة مشابهة لما يلي:

SPRING5 (-$5.00)

خصائص Discount_allocation

يحتوي كل discount_allocation في قائمة discount_allocations على الخصائص التالية.

أوصاف خصائص Liquid التي يمكنك استخدامها مع كائن discount_allocation في قوالب الإشعارات
الخاصية	الوصف
`discount_allocation.amount`	مبلغ المال الذي يوفّره العميل في عنصر سطر. يجب إدخاله في حلقة (loop) إذا كنت تريد السماح بأكواد خصم متعددة.
`discount_allocation.discount_application`	تطبيق الخصم الذي يخصص المبلغ على عنصر السطر.

خصائص Discount_application

يحتوي كل discount_application في قائمة discount_applications على الخصائص التالية.

أوصاف خصائص Liquid التي يمكنك استخدامها مع كائن discount_application في قوالب الإشعارات
الخاصية	الوصف
`discount_application.target_selection`	يصف كيف يحدد الخصم عناصر السطر في سلة التسوق لتطبيق الخصم عليها. وهو إحدى القيم التالية: `all`: ينطبق الخصم على جميع عناصر السطر. `entitled`: ينطبق الخصم على مجموعة فرعية معينة من عناصر السطر، وغالبًا ما يتم تحديدها بواسطة شرط. `explicit`: ينطبق الخصم على عنصر سطر محدد أو سطر شحن محدد.
`discount_application.target_type`	نوع العنصر الذي ينطبق عليه الخصم (`line_item` أو `shipping_line`).
`discount_application.title`	اسم الخصم المعروض للعميل. أمثلة: Welcome10 أو CBBWQQAKYBYY
`discount_application.total_allocated_amount`	المبلغ الإجمالي الذي يتم به تقليل سعر الطلب بموجب الخصم.
`discount_application.type`	نوع الخصم. وهو إما: `automatic`، أو `discount_code`، أو `manual`، أو `script`.
`discount_application.value`	قيمة الخصم.
`discount_application.value_type`	نوع قيمة الخصم. إما: `fixed_amount` أو `percentage`.

خصائص الاشتراك

تتوفر تفاصيل عقد الاشتراك، ودورة الفوترة الحالية، وعناصر السطر الخاصة بها، وطريقة التسليم، وطريقة الدفع لجميع قوالب البريد الإلكتروني للاشتراك.

لتعديل قوالب إشعارات الاشتراك، ثبّت تطبيق Shopify Subscriptions، ثم ابحث عن القالب بالانتقال إلى الإعدادات > الإشعارات ضمن قسم Subscriptions.

خصائص دورة فوترة عقد الاشتراك

للوصول إلى خصائص عقد الاشتراك ودورة الفوترة الخاصة به، استخدم كائن subscription_contract_billing_cycle.

مثال

{% assign contract = subscription_contract_billing_cycle %}
This contract is currently {{ contract.status }}.

النتيجة:

This contract is currently paused.

الخصائص

أوصاف خصائص Liquid التي يمكنك استخدامها مع كائن دورة فوترة عقد الاشتراك في قوالب الإشعارات
الخاصية	الوصف
`status`	حالة العقد. وهي إحدى الحالات التالية: `active`، أو `paused`، أو `cancelled`، أو `failed`، أو `expired`، أو `stale`،
`delivery_method`	طريقة تسليم الاشتراك. إذا كان الاشتراك خاصًا بـ خدمة أو منتج رقمي، فسيتم إرجاع القيمة `nil`.
`billing_frequency`	معدل تكرار فوترة الاشتراك.
`delivery_frequency`	معدل تكرار تسليم الاشتراك.
`origin_order`	الطلب الأصلي الذي أدى إلى إنشاء الاشتراك في البداية. إذا لم يتم إنشاء الاشتراك من طلب Shopify، فسيتم إرجاع القيمة `nil`.
`customer`	عميل الاشتراك.
`line_items`	عناصر السطر في دورة فوترة الاشتراك.
`product_names`	قائمة بأسماء المنتجات المشمولة في دورة فوترة الاشتراك.
`update_payment_method_url`	رابط URL الذي يمكن للعميل استخدامه لتحديث طريقة الدفع لهذا العقد.
`shipping_address`	عنوان شحن الاشتراك. إذا كان الاشتراك خاصًا بـ خدمة أو منتج رقمي، فسيتم إرجاع القيمة `nil`.
`billing_address`	عنوان فوترة الاشتراك.
`subtotal_price`	المجموع الفرعي لسعر عناصر سطر الاشتراك.
`shipping_price`	سعر شحن الاشتراك.
`total_tax`	إجمالي ضريبة الاشتراك.
`total_price`	السعر الإجمالي للاشتراك.
`total_discounts`	إجمالي خصومات الاشتراك.
`customer_self_serve_url`	رابط URL للخدمة الذاتية الذي يمكن للعميل استخدامه لإدارة اشتراكاته.
`billing_attempt_expected_date`	تاريخ الفوترة لدورة الفوترة هذه.
`next_billing_date`	تاريخ الفوترة التالي الذي لم يتم تخطيه بعد دورة الفوترة هذه.
`last_attempted_billing_date`	تاريخ آخر محاولة فوترة لدورة الفوترة.
`days_overdue`	عدد أيام التأخير في الفوترة لدورة الفوترة هذه.
`payment_instrument`	أداة الدفع المرتبطة بعقد الاشتراك. تُستخدم أداة الدفع هذه لفوترة العميل.

خصائص عنصر سطر عقد الاشتراك

خصائص كل عنصر سطر مضمّن في دورة الفوترة. قم بالوصول إلى خصائص عنصر سطر العقد من خلال الخاصية الأصل subscription_contract_billing_cycle.line_items.

مثال

{% for line_item in subscription_contract_billing_cycle.line_items %}
  {{ line_item.url }}
{% endfor %}

أوصاف خصائص Liquid التي يمكنك استخدامها مع كائن عنصر سطر عقد الاشتراك في قوالب الإشعارات
الخاصية	الوصف
`url`	رابط URL لصفحة تفاصيل المنتج لمتغير منتج عنصر السطر.
`requires_shipping`	ما إذا كان عنصر السطر يتطلب شحنًا فعليًا.
`unit_price_measurement`	قياس سعر الوحدة لعنصر السطر.
`selling_plan_allocation`	تخصيص خطة البيع لعنصر السطر.

خصائص طريقة تسليم عقد الاشتراك

خصائص طريقة التسليم المستخدمة في دورة الفوترة هذه. قم بالوصول إلى خصائص طريقة التسليم من خلال الخاصية الأصل subscription_contract_billing_cycle.delivery_method.

مثال

{% if subscription_contract_billing_cycle.delivery_method != blank %}
  Delivery method: {{ subscription_contract_billing_cycle.delivery_method.title }}
{% endif %}

أوصاف خصائص Liquid التي يمكنك استخدامها مع كائن طريقة تسليم عقد الاشتراك في قوالب الإشعارات
الخاصية	الوصف
`title`	عنوان خيار الشحن المرتبط بطريقة التسليم.
`type`	نوع طريقة التسليم. أحد الخيارات `shipping` (شحن)، أو `local` (محلي)، أو `pick-up` (استلام).

خصائص أداة الدفع لعقد الاشتراك

تفاصيل حول أداة الدفع الخاصة بعقد الاشتراك. تُستخدم أداة الدفع هذه لتحصيل الرسوم من العميل. يمكنك الوصول إلى خصائص أداة الدفع من خلال الخاصية الأصلية subscription_contract_billing_cycle.payment_instrument.

مثال

{% assign instrument = subscription_contract_billing_cycle.payment_instrument %}

<img src="{{ instrument.payment_type | payment_type_img_url }} "  alt="{{ instrument.credit_card_company }}" />
{{ instrument.credit_card_company }} ending with {{ instrument.credit_card_last_four_digits }}

أوصاف خصائص Liquid التي يمكنك استخدامها مع كائن أداة الدفع لعقد الاشتراك في قوالب الإشعارات
الخاصية	الوصف
`payment_type`	نوع طريقة الدفع الذي تمثله أداة الدفع. استخدم عوامل تصفية الدفع لعرض عنوان URL لصورة أو ملف SVG.
`credit_card_brand`	العلامة التجارية لبطاقة الائتمان.
`credit_card_company`	اسم شركة بطاقة الائتمان.
`credit_card_last_four_digits`	آخر 4 أرقام من بطاقة الائتمان.

خصائص إشعارات البريد الإلكتروني

أوصاف خصائص Liquid التي يمكنك استخدامها مع كائن إشعارات البريد الإلكتروني في قوالب الإشعارات
الخاصية	الوصف
`shop.email_logo_url`	عنوان url للشعار المحدد في قسم تخصيص قوالب البريد الإلكتروني في المسؤول.
`shop.email_logo_width`	عرض الشعار (بالبكسل) المحدد في قسم تخصيص قوالب البريد الإلكتروني في المسؤول.
`shop.email_accent_color`	رمز HEX للون التمييز المحدد في قسم تخصيص قوالب البريد الإلكتروني في المسؤول.

خصائص رصيد المتجر

الخصائص التي تحتوي على تفاصيل حول إصدار رصيد المتجر.

أوصاف خصائص Liquid التي يمكنك استخدامها مع كائن رصيد المتجر الصادر في قوالب الإشعارات
الخاصية	الوصف
`issued_store_credit.amount`	مبلغ رصيد المتجر الذي تم إصداره. يمكنك تنسيق هذا المبلغ باستخدام عوامل تصفية الأموال في Liquid.
`issued_store_credit.expires_at`	تاريخ ووقت انتهاء صلاحية رصيد المتجر الصادر. يمكنك تنسيق هذا المبلغ باستخدام عوامل تصفية التاريخ في Liquid.
`issued_store_credit.balance_after_transaction`	رصيد حساب رصيد المتجر بعد إصدار الرصيد. يمكنك تنسيق هذا المبلغ باستخدام عوامل تصفية الأموال في Liquid.
`customer`	كائن العميل الذي يحتوي على سمات مُخرجات العميل.