مرشّحات Liquid

إلى جانب مرشّحات LiquidJS القياسية (upcase، date، default، plus، size…) تسجّل المنصّة المرشّحات التالية. الوضع صارم: مرشّح مجهول يفشل التصيير. كل مخرجات {{ }} تُهرَّب؛ المرشّحات المعلّمة آمنة أدناه هي وحدها التي تُصدر HTML خاماً.

المال#

money#

{{ product.price | money }}

المدخل كائن مال (أو عدد بالوحدات الصغرى فيُعامل بالدولار). المخرج آمن: <span class="money-value" data-amount-minor="250000" data-currency="SYP">…</span> بالنص المنسّق داخله. سمتا البيانات تسمحان لمحوّل العملة على المتصفح بإعادة العرض بعملة الزائر. الأرقام غربية، والرمز قبل المبلغ، ومغلّف ثنائي الاتجاه؛ مع إعداد arabic_numerals تصبح الأرقام مشرقية.

money_with_currency#

{{ cart.subtotal | money_with_currency }}

النص المنسّق نفسه بلا أي وسم. لا يتحوّل مع عملة الزائر؛ استخدمه في alt وtitle وأشباهها.

money_amount#

{{ product.price | money_amount }}

رقم عشري خام بالوحدات الكبرى ("185000" أو "12.50") بلا رمز ولا تغليف، للاستهلاك الآلي: JSON-LD والوسوم الوصفية. أرقامه غربية دائماً.

money_major: CURRENCY#

{{ theme_settings.free_shipping_threshold | money_major: cart.subtotal.currency }}

ينسّق عدداً بالوحدات الكبرى كتبه التاجر (حدّ شحن مجاني مثلاً) بالوسم نفسه الذي يُصدره money، فيتحوّل مع عملة الزائر أيضاً. آمن.

الوسائط والملفات#

img_url: WIDTH#

<img src="{{ product.image_url | img_url: 400 }}"
     srcset="{{ product.image_url | img_url: 400 }} 400w, {{ product.image_url | img_url: 800 }} 800w"
     sizes="(max-width: 600px) 100vw, 400px" alt="{{ product.name }}">

عقد شبكة الصور: على أصل وسائط المنصّة يُصدر رابطاً محوّلاً بعرض يُقرَّب لأعلى إلى سلّم ثابت (96، 128، 200، 400، 600، 800، 1200، 1600) بصيغة تلقائية وجودة 72؛ خارج ذلك الأصل يضيف تلميح ?w=. العرض الغائب يعني 400. لا تبنِ روابط التحويل يدوياً؛ الرابط شكل داخلي والمرشّح هو العقد.

asset_url#

<img src="{{ section.settings.image | asset_url }}" alt="{{ section.settings.image | file_alt }}">

الطريق الوحيد لتحويل مرجع ملف مخزّن (إعداد image أو video) إلى رابط. القيم المطلقة والبروتوكولات والتجاوز .. تعيد ""؛ وبلا أصل مضبوط تعيد "" فيقع الثيم في حالته البديلة.

file_alt وfile_focal_style#

<img src="{{ block.settings.image | asset_url }}" alt="{{ block.settings.image | file_alt }}"
     style="{{ block.settings.image | file_focal_style }}">

يقرآن النص البديل ونقطة التركيز (object-position: X% Y%) واللون الغالب (background-color) المضبوطة في مكتبة الوسائط لكل ملف. قيمة file_focal_style جاهزة لسمة style ومعقَّمة على الخادم.

النصوص#

t#

{{ 'product.add_to_cart' | t }}

بحث في جدول اللغة الحالية من locales/<locale>.json بمفاتيح منقّطة. المفتاح الغائب يعيد نص المفتاح نفسه ولا يرمي خطأ.

richtext#

<div class="prose">{{ section.settings.body | richtext }}</div>

الطريق الوحيد لإخراج HTML من قيمة كتبها التاجر. يعيد التعقيم عند التصيير مهما كان المصدر إلى المجموعة p br strong em u s ul ol li h2 h3 blockquote a مع dir وtext-align فقط على وسوم الكتل، وروابط https:/mailto:/tel:/مسارات مطلقة. آمن. الحد 10,000 حرف.

strip_html#

{{ product.description | strip_html | truncate: 160 }}

يزيل الوسوم ويفكّ الكيانات الأساسية ويطبّع المسافات؛ المخرج نص عادي يُهرَّب كأي مخرج. للأوصاف في JSON-LD والوسوم الوصفية.

json#

<script type="application/ld+json">{ "name": {{ product.name | json }} }</script>

يسلسل القيمة إلى JSON مع تهريب < و> و& وفواصل الأسطر U+2028/U+2029 كتسلسلات \u، فيصلح داخل كتلة JSON-LD وفي أي سياق. آمن.

الروابط#

tel_href وwa_href#

<a href="{{ theme_settings.phone | tel_href }}">{{ theme_settings.phone }}</a>
<a href="{{ store.whatsapp_number | wa_href }}">{{ 'contact.whatsapp' | t }}</a>

الطريق الوحيد لتحويل رقم هاتف إلى رابط: يختزل المدخل إلى أرقام (مع + واحدة في tel:) فلا يمكن لقيمة تاجر تهريب بروتوكول. فارغ في، فارغ خارج.

التواريخ#

date_localized: LOCALE#

{{ review.created_at | date_localized: request.locale }}

تاريخ YYYY-MM-DD إلى نص مقروء: أسماء أشهر شامية بالعربية، وإنجليزية عادية بغيرها. ما ليس بصيغة التاريخ يمرّ كما هو.

المعطَّل#

raw#

مرشّح LiquidJS المدمج raw معطَّل ويعيد قيمته كنص عادي يُهرَّب؛ وكتابة | raw في القالب أصلاً مرفوضة عند الدفع. لا يوجد أي طريق لإخراج HTML خام من بيانات الثيم أو المتجر خارج المرشّحات الآمنة أعلاه.