كائنات Liquid
كل مفتاح في سياق التصيير v1 مع خصائصه وأنواعه ومتى يكون حاضراً.
في هذه الصفحة
هذا هو العقد الكامل للبيانات التي يراها الثيم (ThemeContextV1)؛ لا شيء آخر يصل إلى Liquid أبداً: لا طلبات ولا عملاء ولا أسرار. العقد إضافي فقط: تُضاف حقول ولا تُحذف ولا يتغيّر نوعها. أي صفحة يوجد فيها كل مفتاح في القوالب.
المال#
كل سعر كائن { amount_minor, currency } بلا decimals: الأس من جدول المنصّة (SYP 0، USD وEUR 2). لا تحسب في Liquid؛ اعرض بـ money.
store#
| الخاصية | النوع | المعنى |
|---|---|---|
id، name، slug |
نص | هوية المتجر |
description |
نص أو null |
الوصف العام |
url |
نص | المسار المطلق لواجهة المتجر (/stores/{slug}) |
logo_url |
نص أو null |
الشعار |
banner_urls |
مصفوفة نصوص | صور البانر |
social_accounts |
مصفوفة { platform_name, account_handle, url } |
حسابات التواصل |
whatsapp_number |
نص أو null |
رقم واتساب مطبّع؛ استخدم wa_href |
address |
نص أو null |
العنوان |
primary_color |
نص أو null |
لون التاجر الأساسي #rrggbb |
currency |
{ code, allowed[] } |
عملة العرض والعملات المسموحة (USD، EUR، SYP) |
payment_method_ids |
مصفوفة نصوص | معرّفات وسائل الدفع المفعّلة فعلاً عند الدفع (مثل cod)؛ لا تدّعِ وسيلة غير موجودة هنا |
theme_settings |
كائن | إعدادات الثيم المعتمدة على مخططك؛ متاح أيضاً كـ theme_settings مباشرة |
request#
| الخاصية | النوع | المعنى |
|---|---|---|
path |
نص | المسار الحالي |
page_type |
home، product، category، cart، search |
نوع الصفحة |
locale |
ar أو en |
لغة الزائر |
direction |
rtl أو ltr |
الاتجاه |
search |
نص أو null |
استعلام البحث المطبّع على صفحات القوائم |
categories وcategory#
categories كل التصنيفات العامة بترتيب لوحة التاجر؛ category التصنيف المعروض على صفحته.
| الخاصية | النوع | المعنى |
|---|---|---|
id، name، slug |
نص | الهوية |
url |
نص | مسار صفحة التصنيف |
parent_id |
نص أو null |
التصنيف الأب |
product_count |
عدد | عدد المنتجات في الشجرة |
image_url |
نص أو null |
صورة اللوحة المحلولة (صورة التاجر أو غلاف الأكثر مبيعاً في 30 يوماً)؛ null حالة دائمة طبيعية وبديل الحرف الأول إلزامي |
image_color |
نص أو null |
اللون الغالب #rrggbb للعنصر النائب |
image_alt |
نص أو null |
النص البديل، ويعود إلى اسم التصنيف |
image_focal_style |
نص أو null |
قيمة جاهزة لـ style مثل object-position: 50% 30% |
products، product، related_products#
| الخاصية | النوع | المعنى |
|---|---|---|
id، name |
نص | الهوية |
brand، description |
نص أو null |
العلامة والوصف (الوصف HTML معقَّم؛ اعرضه بـ richtext أو strip_html) |
url |
نص | مسار صفحة المنتج |
price |
مال | سعر البيع |
compare_at_price |
مال أو null |
السعر قبل العرض عند وجود عرض |
savings |
مال أو null |
compare_at_price − price محسوب على المنصّة؛ حاضر مع compare_at_price بالضبط |
available |
منطقي | التوفّر |
available_quantity |
عدد أو null |
يظهر فقط عندما يكون المتبقّي ≤ 5 (إشارة ندرة دون كشف المخزون) |
featured |
منطقي | منتج مميّز |
image_url |
نص أو null |
الصورة الرئيسية |
image_color |
نص أو null |
اللون الغالب للصورة الرئيسية |
images |
مصفوفة نصوص | معرض الصور (صفحة المنتج فقط؛ فارغة في غيرها) |
categories |
مصفوفة { id, name, url } |
تصنيفاته |
variants |
مصفوفة | راجع المتغيرات |
rating |
{ average_x10, count } أو null |
متوسط التقييم ×10 كعدد صحيح (43 = 4.3) من المراجعات المنشورة فقط |
sold_count |
عدد أو null |
الوحدات المباعة في طلبات حقيقية غير ملغاة؛ null تحت عتبة المصداقية |
المتغيرات#
| الخاصية | النوع | المعنى |
|---|---|---|
id |
نص | |
attributes |
كائن أو null |
سمات المتغير ({ "size": "50 ml" }) |
price، compare_at_price، savings |
مال | كما في المنتج |
available، available_quantity |
كما في المنتج | |
image_url |
نص أو null |
صورة المتغير |
pagination#
{ page, perPage, total, totalPages, hasNextPage, hasPrevPage } على صفحات القوائم. راجع التصفّح.
cart#
| الخاصية | النوع | المعنى |
|---|---|---|
lines |
مصفوفة | راجع أدناه |
item_count |
عدد | مجموع الكميات |
subtotal |
مال | المجموع قبل الشحن |
سطر السلة: id (مقبض وحدات الكمية والحذف)، product_id، variant_id، name، variant_label (نص أو null، مثل «50 مل»)، quantity، unit_price، line_total، image_url.
product_reviews#
حاضر على صفحة المنتج عند وجود مراجعات منشورة أو استعلام صفحة/ترتيب:
| الخاصية | النوع |
|---|---|
review_count، average_x10، recommend_percent |
عدد |
histogram |
[n1, n2, n3, n4, n5] عدد المراجعات لكل نجمة |
items |
مصفوفة مراجعات: id، author_name، rating، recommend، body، verified، helpful_count، created_at (YYYY-MM-DD) |
page، total_pages |
عدد |
sort |
newest، highest، lowest، helpful |
verified تقرّره المنصّة للمراجعات المؤكّدة بطلب؛ لا هاتف ولا معرّف طلب يصل إلى الثيم.
page_sections وsection#
page_sections مصفوفة المثيلات المحلولة المرئية بترتيب التاجر؛ داخل snippets/section-body.liquid يتوفّر المثيل الحالي كـ section:
| الخاصية | النوع | المعنى |
|---|---|---|
id، type |
نص | معرّف المثيل ونوعه |
settings |
كائن | إعدادات المثيل المعتمدة |
blocks |
مصفوفة { id, type, settings, products? } |
الكتل بترتيبها |
band |
منطقي (اختياري) | true عندما يعلنه التعريف |
products |
مصفوفة منتجات (اختياري) | المنتجات المحلولة من مصادر المثيل |
products_total |
مال (اختياري) | مجموع أسعار المتاحين منها |
راجع الأقسام.
theme_settings وeditor_chrome#
theme_settingsاختصار لـstore.theme_settingsتضيفه المنصّة لكل ثيم.editor_chromeيكونtrueفقط داخل لوحة المحرّر؛ لا تعتمد عليه لأي منطق عرض للزوار.