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 هذا الملف تلقائيًا لعرض الكتلة.
<div class="my-block">
{% if a.title %}
<h2>{{ a.title }}</h2>
{% endif %}
{% if a.content %}
<p>{{ a.content }}</p>
{% endif %}
</div>