الانتقال إلى المحتوى
المرجع

التسلسل الهرمي لقوالب البلوكات في ووردبريس

التسلسل الهرمي الكامل لقوالب قالب البلوكات (تحرير الموقع الكامل - FSE): لكل نوع طلب، القائمة المرتّبة للقوالب التي يبحث عنها ووردبريس، من الأكثر تحديدًا أولًا، وصولًا إلى index.html كخيار احتياطي. المكافئ لعصر البلوكات من مخطّط التسلسل الهرمي الكلاسيكي.

مع كل طلب، يبحث WordPress عن هذه القوالب بالترتيب — الأكثر تحديدًا أولًا — ويتوقف عند أول قالب موجود في مجلد /templates الخاص بقالبك. وتنتهي السلسلة دائمًا عند index.html.

الصفحة الأمامية

الصفحة الأمامية للموقع، سواء ضُبطت لعرض أحدث تدويناتك أو صفحة ثابتة.

  1. front-page.html
  2. home.html
  3. index.html

يتقدّم front-page.html بغضّ النظر عن اختيارك في الإعدادات ← القراءة. وإذا كانت الصفحة الأمامية صفحة ثابتة ولم يوجد front-page.html، فإنها تنتقل إلى سلسلة الصفحة الثابتة، وليس إلى home.html.

فهرس تدوينات المدونة

الصفحة التي تعرض أحدث تدويناتك (\"صفحة التدوينات\" في الإعدادات ← القراءة).

  1. home.html
  2. index.html

تدوينة مفردة

تدوينة فردية من المدونة.

  1. single-post-{slug}.html
  2. single-post.html
  3. single.html
  4. singular.html
  5. index.html

نوع منشور مخصّص مفرد

مدخل فردي من نوع منشور مخصّص (مثل \"كتاب\").

  1. single-{post-type}-{slug}.html
  2. single-{post-type}.html
  3. single.html
  4. singular.html
  5. index.html

لنوع منشور \"book\" باسمه اللطيف \"dune\": single-book-dune.html، ثم single-book.html، ثم single.html.

صفحة ثابتة

صفحة WordPress عادية.

  1. page-{slug}.html
  2. page-{id}.html
  3. page.html
  4. singular.html
  5. index.html

صفحة بقالب مخصّص

صفحة عُيِّن لها قالب مخصّص من لوحة القالب في المحرّر.

  1. {custom-template}.html
  2. page-{slug}.html
  3. page-{id}.html
  4. page.html
  5. singular.html
  6. index.html

تُعرَّف القوالب المخصّصة في مصفوفة customTemplates داخل theme.json وتوجد في /templates. ويتقدّم القالب المُعيَّن على سلسلة الصفحة بأكملها.

أرشيف التصنيف

الأرشيف الذي يعرض التدوينات ضمن تصنيف واحد.

  1. category-{slug}.html
  2. category-{id}.html
  3. category.html
  4. archive.html
  5. index.html

أرشيف الوسم

الأرشيف الذي يعرض التدوينات ذات وسم واحد.

  1. tag-{slug}.html
  2. tag-{id}.html
  3. tag.html
  4. archive.html
  5. index.html

أرشيف تصنيف مخصّص

أرشيف حدٍّ (term) ضمن تصنيف مخصّص.

  1. taxonomy-{taxonomy}-{term}.html
  2. taxonomy-{taxonomy}.html
  3. taxonomy.html
  4. archive.html
  5. index.html

أرشيف الكاتب

أرشيف تدوينات كاتب واحد.

  1. author-{nicename}.html
  2. author-{id}.html
  3. author.html
  4. archive.html
  5. index.html

أرشيف التاريخ

أرشيف بحسب السنة / الشهر / اليوم.

  1. date.html
  2. archive.html
  3. index.html

أرشيف نوع المنشور

فهرس أرشيف نوع منشور مخصّص مضبوط عليه has_archive.

  1. archive-{post-type}.html
  2. archive.html
  3. index.html

نتائج البحث

صفحة نتائج البحث داخل الموقع.

  1. search.html
  2. index.html

404 (غير موجود)

تُعرَض عندما لا يطابق أيّ محتوى عنوان URL.

  1. 404.html
  2. index.html

صفحة المرفق

صفحة مرفق وسائط مفرد.

  1. attachment.html
  2. single.html
  3. singular.html
  4. index.html

تعطّل كثير من المواقع صفحات المرفقات تمامًا (لكونها محتوى ضعيفًا). وإن أبقيتها، فهذه هي السلسلة.

صفحة سياسة الخصوصية

الصفحة المضبوطة كسياسة خصوصية للموقع في الإعدادات.

  1. page-privacy-policy.html
  2. privacy-policy.html
  3. page.html
  4. singular.html
  5. index.html

كيف يختلف هذا عن التسلسل الهرمي الكلاسيكي (PHP)

  • القوالب ملفات .html في /templates، وليست ملفات .php في جذر القالب. لا يوجد single.php — بل single.html.
  • المناطق القابلة لإعادة الاستخدام (الترويسة، التذييل) هي أجزاء قوالب (template parts) في /parts، يُشار إليها بكتلة wp:template-part، وليس عبر استدعاءات PHP مثل get_header() / get_footer().
  • لا توجد سلسلة get_template_part() ولا get_header()/get_footer(). يتم التركيب باستخدام كتلة Template Part داخل ملفات .html.
  • index.html مطلوب إلزاميًا. فأيّ block theme بلا templates/index.html ليس block theme صالحًا — إذ إنه البديل الاحتياطي الأخير الإلزامي لكل مسار أعلاه.
  • يُعتبر القالب block theme بوجود templates/index.html إلى جانب theme.json، وليس عبر أيّ راية في الترويسة.
  • يمكنك تحرير أيّ من هذه القوالب في محرّر الموقع (المظهر ← المحرّر) وحفظ التغييرات في قاعدة البيانات — وعندئذٍ تتقدّم هذه التغييرات على ملفات القالب حتى تمسح التخصيص. وهذا ما يفاجئ من يحاول تصحيح \"لماذا لا يُحدث تغييري في القالب أيّ أثر\".