انتقل إلى المحتوى الرئيسي

أساسيات Qalab

المفاهيم الأساسية للعمل مع قوالب Qalab.

المقابض (Handles)​

المقابض هي معرّفات صديقة لعناوين URL لموارد المتجر (المنتجات، المجموعات، الصفحات).

{{ product.handle }}        {# health-potion #}
{{ collection.handle }}     {# summer-sale #}

قواعد المقابض:

  • دائماً بأحرف صغيرة
  • المسافات تتحول إلى شرطات
  • يتم إزالة الأحرف الخاصة
  • يجب أن تكون فريدة (المكررات تحصل على -1، -2، إلخ.)

الوصول عبر المقبض​

{# طريقة الأقواس المربعة #}
{{ pages['about-us'].url }}

{# طريقة النقطة #}
{{ settings.header_color }}

المعاملات​

معاملات المقارنة​

المعاملالمعنى
==يساوي
!=لا يساوي
>أكبر من
<أصغر من
>=أكبر من أو يساوي
<=أصغر من أو يساوي

المعاملات المنطقية​

المعاملالمعنى
andكلاهما صحيح
orأحدهما صحيح
containsالنص/المصفوفة تحتوي على القيمة
{% if product.price > 100 and product.available %}
  منتج مميز متوفر
{% endif %}

{% if product.tags contains 'sale' %}
  معروض للبيع!
{% endif %}

أنواع البيانات​

النوعمثال
string"Hello" أو 'Hello'
number42، 3.14
booleantrue، false
nullقيمة غير معرّفة
array[1, 2, 3]

القيم الصحيحة والخاطئة (Truthy و Falsy)​

فقط false و null تُعتبر خاطئة. كل شيء آخر يُعتبر صحيحاً:

{# النص الفارغ يُعتبر صحيحاً - استخدم blank للتحقق #}
{% if settings.title != blank %}
  {{ settings.title }}
{% endif %}

{# الكائن الفارغ يُعتبر صحيحاً - استخدم empty للتحقق #}
{% if product != empty %}
  {{ product.title }}
{% endif %}

التحكم في المسافات البيضاء​

أضف شرطات لإزالة المسافات البيضاء:

{# مع المسافات البيضاء #}
{% if true %}
  مرحباً
{% endif %}

{# بدون المسافات البيضاء #}
{%- if true -%}
  مرحباً
{%- endif -%}