يختار ووردبريس ملف القالب بتجربة قائمة بالترتيب وأخذ أول ملف موجود فعلا. لتدوينة واحدة القائمة هي single-{post_type}-{slug}.php، ثم single-{post_type}.php، ثم single.php، ثم singular.php، ثم index.php. لا شيء يُوجَّه ولا شيء يُسجَّل: اسم الملف نفسه هو التوجيه.
وهذا يعني أن index.php هو الملف الوحيد الذي يحتاجه القالب فعلا، إلى جانب style.css لأجل تعليق الترويسة الذي يسمي القالب. كل ملف آخر هو استثناء يعترض القائمة قبل ذلك، وإضافة ملف جديد هي كيف تجعل نوعا واحدا من المحتوى مختلف الشكل دون لمس أي شيء يعمل أصلا.
القوائم التي تستحق الحفظ عن ظهر قلب
- صفحة: {مخصص}.php من إعداد القالب الخاص بالصفحة، ثم page-{slug}.php، ثم page-{id}.php، ثم page.php، ثم singular.php، ثم index.php
- أرشيف: archive-{post_type}.php، ثم archive.php، ثم index.php
- صفحة غائبة: 404.php، ثم index.php
- singular.php هو البديل المشترك بين تدوينة واحدة وصفحة، وهو الملف الذي يجب أن يملكه أغلب القوالب ولا يملكونه
بدائل الرقم التعريفي والاسم المستعار أعلى القائمة هي المخرج، وتستحق استعمالا نادرا: قالب باسم رابط صفحة واحدة يختفي أثره في اللحظة التي يُعاد فيها تسمية تلك الصفحة، فيعود التصميم إلى الشكل الافتراضي بصمت تام.
حقيقتان تكملان الصورة. ملف القالب يُضمَّن لا يُستدعى، فكل ما هو متاح في تلك اللحظة يبقى متاحا: $post، والاستعلام، وأي شيء أعدته إضافة على خطاف أسبق. والحلقة صريحة لا ضمنية، وهذا سبب أن قالبا ينسى the_post() يعرض التدوينة نفسها مرارا أو لا يعرض شيئا.
نوعان من القوالب، وكيف تفرّق بينهما بنظرة واحدة
القالب الكلاسيكي ملفات PHP إلى جانب functions.php، وقائمة البدائل أعلاه هي نموذج التوجيه كله. قالب الكتل ملفات HTML داخل مجلد templates/ إلى جانب theme.json، يُحرَّر من محرر الموقع لا من ملف، والقائمة نفسها تنطبق مع .html بدل .php.
الفرق يظهر بنظرة واحدة إلى محتويات المجلد: وجود theme.json وtemplates/index.html معا يعني قالب كتل، ووجود index.php وfunctions.php فقط دون theme.json يعني قالبا كلاسيكيا.
الأداة التي تسمي القالب الجاري فعلا
قالب فرعي هو الأداة حين يكون القالب ملك غيرك، مجاني مع ووردبريس نفسه: مجلد بملف style.css يسمي القالب الأب وملف functions.php، وأي ملف قالب تضيفه يتجاوز نسخة الأب منه. حلّ محل تعديل القالب الأب، الذي يُلغى عند كل تحديث، وهو الاتفاق الأكثر فائدة في ووردبريس كله.
Query Monitor تسمي القالب الذي استُعمل فعلا للطلب الحالي، مجانية ومفتوحة المصدر، فتحوّل القائمة أعلاه من قراءة إلى ملاحظة مباشرة. حلّت محل إضافة echo داخل كل ملف مرشح لمعرفة أيها يعمل.
أين يتعثر الناس
مدرسة خاصة في الكويت لها قسم فعاليات، وحرّر مطور فيها single.php لتغيير عرض التاريخ فلم يتغير شيء، لأن قالبا فعليا آخر باسم single-event.php كان موجودا منذ أشهر ويسبقه في القائمة. لم يظهر أي خطأ، والتعديل لم يفشل فقط بقي بلا أثر، فكبّر المطور التعديل ظنا أن المشكلة أعمق.
قبل تعديل أي شيء اقرأ أي قالب قيد الاستعمال لذلك الرابط. سطر واحد في Query Monitor يزيل هذا الصنف كاملا من المشكلات. ما تستدعيه هذه القوالب من دوال موضوعه الإضافات، وما يُعرض عبر واجهة برمجية بدل هذه الملفات موضوعه واجهة ووردبريس، واللغة التي يُكتب بها كل هذا موضوعها أساسيات PHP.