ملف index.php

نكمل مع بعض وندخل على ملف مهم جدًا في أي قالب ووردبريس:
🔥 ملف index.php – العمود الفقري لعرض المحتوى

1. مقدمة: يعني إيه ملف index.php؟

ببساطة، هو الملف الرئيسي في أي قالب ووردبريس.
لو مفيش ملفات تانية زي home.php أو single.php، ووردبريس هيرجع لـ index.php.

يعني هو الملاذ الأخير لعرض المحتوى.

2. أهميته في القالب

مفيش قالب ووردبريس بيشتغل من غير الملف ده.
حتى لو القالب فاضي، لازم يحتوي على style.css و index.php.

3. ترتيب الأولوية في ووردبريس (Template Hierarchy)

لما تفتح صفحة معينة، ووردبريس بيدور على الملف الأنسب:

• صفحة مقالة؟ يدور على single.php
• صفحة رئيسية؟ يدور على home.php أو front-page.php
• مش لاقي؟ يروح في الآخر لـ index.php

يعني هو الملف اللي عمره ما بيتساب ✌️

4. محتوى ملف index.php الأساسي

الملف بيكون عبارة عن:

• استدعاء الهيدر
• بداية الكونتينت
• الحلقة (Loop)
• استدعاء المقالات
• استدعاء الفوتر

5. استخدام الحلقة (The Loop)

الحلقة هي اللي بتعرض المقالات أو البوستات.

<?php if ( have_posts() ) : ?>
  <?php while ( have_posts() ) : the_post(); ?>
    <h2><a href="<?php the_permalink(); ?>"><?php the_title(); ?></a></h2>
    <div><?php the_excerpt(); ?></div>
  <?php endwhile; ?>
<?php else : ?>
  <p>مفيش محتوى لسه 🙁</p>
<?php endif; ?>

6. استدعاء ملفات الهيدر والفوتر

في بداية الملف:

<?php get_header(); ?>

وفي آخره:

<?php get_footer(); ?>

كده بتضمن تصميم موحّد لكل الصفحات.

7. تنسيق شكل المقالات

ممكن تضيف كود لتنسيق كل بوست، زي:

<article class="post">
  <h2><?php the_title(); ?></h2>
  <div class="post-meta"><?php the_date(); ?> - <?php the_author(); ?></div>
  <div class="post-content"><?php the_excerpt(); ?></div>
</article>

8. التعامل مع عدم وجود محتوى

لو مفيش مقالات، لازم تعرض رسالة:

<p>مافيش مقالات دلوقتي. تابعنا قريب 👀</p>

ده أحسن من صفحة فاضية تخوف الزائر 😅

9. الفرق بين index.php وملفات تانية

الملف	الاستخدام
index.php	ملف عام لعرض أي نوع محتوى
single.php	لعرض مقال واحد
archive.php	لعرض أرشيف تصنيفات أو وسوم
page.php	لعرض الصفحات الثابتة

10. مثال عملي لملف index.php

<?php get_header(); ?>

<div class="content-area">
  <main class="site-main">
    <?php if ( have_posts() ) : ?>
      <?php while ( have_posts() ) : the_post(); ?>
        <article class="post">
          <h2><a href="<?php the_permalink(); ?>"><?php the_title(); ?></a></h2>
          <div class="excerpt"><?php the_excerpt(); ?></div>
        </article>
      <?php endwhile; ?>
    <?php else : ?>
      <p>مافيش مقالات حالياً</p>
    <?php endif; ?>
  </main>
</div>

<?php get_footer(); ?>

11. استخدام get_template_part() للتنظيم

بدل ما تكتب كل كود المقال، ممكن تعمل ملف:

template-parts/content.php

وبعدين تستدعيه كده:

<?php get_template_part('template-parts/content'); ?>

ده بيخلي القالب منظم وأسهل في الصيانة.

12. تحسين الأداء والسيو من خلاله

• استخدم the_excerpt() بدل the_content() لسرعة التحميل
• خلي روابط العناوين SEO-Friendly
• أضف <article> و <section> علشان محركات البحث تفهم البنية

13. التوافق مع الجوال

✅ استخدم كلاس CSS زي responsive-grid
✅ خلي الخط كبير وواضح
✅ ما تستخدمش صور ضخمة
✅ خلّي التباعد كويس بين العناصر

14. ممارسات احترافية

• اختبر الملف على صفحة أرشيف، الرئيسية، وتصنيف
• فعّل صفحة بلوج من الإعدادات → قراءة
• استخدم قوالب منفصلة للمقالات لو المشروع كبير
• راعي بساطة الكود وعدم التكرار

15. مراجعة سريعة

• index.php هو الأساس لأي قالب ووردبريس
• بيحتوي على الحلقة Loop لعرض المحتوى
• لازم يحتوي على get_header() و get_footer()
• منظم وسهل التخصيص باستخدام get_template_part()
• خفيف وسهل على الزوار والموبايلات

✅ أسئلة شائعة

س: ينفع أعتمد على index.php بس في القالب؟
ج: أيوه، بس مش احترافي. يفضل تفصل كل نوع محتوى في ملفه.

س: إيه الفرق بين index.php و home.php؟
ج: home.php لو موجود بيستخدم في الصفحة الرئيسية. لو مش موجود، ووردبريس بيروح لـ index.php.

س: ينفع أستخدم the_content() بدل the_excerpt()؟
ج: ممكن، بس هيعرض المقال بالكامل، وده تقيل شوية على الصفحة.

🎯 نهاية الدرس: “القلب النابض اللي بيعرض محتواك”

لو header.php هو وجه الموقع، و footer.php هو وداعه،
فـ index.php هو الجسم اللي شايل كل حاجة.

لو أتقنت الملف ده، فهمك له هيساعدك تتوسع وتبني باقي ملفات القالب بسهولة.
وصدقني… أول مرة تشوف محتوى بيتعرض من كود أنت كاتبه، هتحس بالفخر الحقيقي 💪