انتقل إلى المحتوى

Twig

Twig محرك قوالب مرن وسريع وآمن لـ PHP. يتيح للمطورين كتابة أكواد موجزة وسهلة القراءة في القوالب، مما يعزز الإنتاجية وقابلية الصيانة. يدعم Twig مجموعة متنوعة من الميزات المصممة لجعل إنشاء القوالب قويًا وسهلًا، ما يجعله مثاليًا للمشروعات التي تتطلب قوالب متينة وقابلة لإعادة الاستخدام.

الإعداد

لاستخدام قوالب Twig مع Blockstudio، عليك تثبيت الحزمة timber/timber (التي تتضمن Twig) باستخدام Composer. سيتحقق Blockstudio تلقائيًا من تثبيت Timber ويفعّل قوالب Twig لكتلك.

سطر الأوامر
composer require timber/timber

بعد تثبيت Timber، سيتولى Blockstudio تلقائيًا عرض ملفات index.twig الموجودة داخل مجلدات الكتل.

متغيرات القالب

تتمتع جميع ملفات Twig بإمكانية الوصول إلى سياق Timber، الذي يتضمن بيانات ودوال WordPress شائعة، بالإضافة إلى متغيرات خاصة بـ Blockstudio:

المتغير الوصف
a اسم بديل لـ attributes
attributes سمات الكتلة
b اسم بديل لـ block
block بيانات متعلقة بالكتلة نفسها (تتضمن postId وpostType وcontext وغيرها)
c اسم بديل لـ context
context سياق الكتلة (e.g وpostId وpostType عند التكرار)
isEditor قيمة منطقية، تكون true إذا كانت الكتلة تُعرض في المحرر
isPreview قيمة منطقية، تكون true إذا كانت الكتلة تُعرض في معاينة أداة الإدراج

الاستخدام

لاستخدام Twig لقالب الكتلة، ما عليك سوى إنشاء ملف index.twig في مجلد الكتلة. وسيستخدم Blockstudio هذا الملف تلقائيًا لعرض الكتلة.

Twig
<div class="my-block">
  {% if a.title %}
    <h2>{{ a.title }}</h2>
  {% endif %}

  {% if a.content %}
    <p>{{ a.content }}</p>
  {% endif %}
</div>