تعريب ملفات ووردبرس: الدرس الثاني – index.php

هذا هو الدرس الثاني من سلسلة تعريب ملفات ووردبرس. وقد شرحت لك في الدرس الأول كيف تقوم بتعريب ملف الهيدر header.php. سأقوم في هذا الدرس شرح طريقة تعريب ثاني أهم ملفات ال php لووردبرس – index.php. وكما هو الحال مع ملف الهيدر، تختلف محتويات هذا الملف بإختلاف القالب. ولهذا، وكما قلت، سأعتمد في شرحي على نظرة عامة لدور ومحتويات كل ملف. الهدف هو شرح التقنية المستخدمة بطريقة سهلة تسمح لك بتعديل هذه الملفات لما يناسبك.

ملف index.php هو الملف الخاص بالصفحة الرئيسية لمدونتك. إلى هذا الملف يتم سحب بيانات التدوينات والملفات الأخرى من أجل عرضها. لمزيد من التوضيح تأمل الصورة التالية:

محتوى ملف index.php

ملف الصفحة الرئيسية هو نقطة دخول كل زائر لمدونتك وتعريبه بطريقة إحترافية يعتبر ضرورة قصوى. على أقل تقدير، يحتوي كل ملف من ملفات الصفحة الرئيسية على ما يلي:

1-دوّال (جمع دالة) لمحتويات الصفحة الأخرى (مثل الهدر والقائمة الجانبية)

2- الحلقة أو Loop باللغة الإنجليزية ومهمتها إخراج وعرض التدوينات من قائمة البيانات

3- جملة “If” الشّرطية

لنعالج هذه المحتويات بالتفصيل:

1- دوّال المحتويات الأخرى

يبدأ كل ملف index.php بالدالة التالية:

<?php get_header(); ?>

سطر الكود هذا يقوم بإخراج جميع المعلومات الموجودة في ملف header.php التابع لمدونتك ويعرضها. من دون هذا السطر فإن موقعك لن يعرض إسم المدونة أو الوصف الذي تستخدمه ولن يتبع الألوان والخلفيات كما هو محدد في ملف التصميم style.css.

لاحظ أيضاً أن كل ملف ينتهي كالتالي:

‭‬
<?php get_sidebar(); ?>      
<?php get_footer(); ?>
‭‬

وتقوم هذه الأكواد بعرض كل من القائمة الجانبية و أسفل الصفحة على التوالي.

بالطبع، الأكواد السابقة كلها لا تحتاج إلى تبديل أو تغير ويجب أن تبقى كما هي حتى يعمل القالب. ولكن، وبحسب القالب، لا بد وأنك ستجد أكواد أخرى تحت دالة الهيدر خاصة بطريقة العرض مثل تقسيمات <div> أو التصنيفات أو عرض بقائمة أفقية للصفحات. مثلاً قد تجد كود كالتالي:

<div class="nav">
<ul>
......
</ul>
</div>

إلا إذا إحتوى الكود على كلمات نصية أو كنت تعرف ماذا تعمل فأنا أنصحك بتركها كما هي.

2- الحلقة أو Loop

ثم يحتوي هذا الملف عادة على ما سأسميه “الحلقة” – Loop. هذا الكود مسؤول عن عرض جميع التدوينات أن وجدت.

إذا كنت من مستخدمي ووردبرس فلا بد أنك لاحظت أن الكثير من الإضافات والأكواد تعطيك تعليمات يجب وضعها داخل ال loop أو خارجها. المقصود هو أكواد هذه “الحلقة” التي سأشرحها هنا. وبالتالي فإن فهم الكود هذا أمر حيوي لفهم تعريب القوالب وتصميمها، لذا أنصحك بالتركيز والمتابعة!

في الحقيقة هناك عدة طرق أو أكواد يمكنك إستخدامها ولكني سأشرح الأكثر إستخداماً. لنأحذ الكود المستخدم في تصميمنا – وهو الأكثر إستعمالاً:

<?php while (have_posts()) : the_post(); ?>

وبعد عدة أسطر، ستجد الكود التالي الذي ينهي الحلقة:

<?php endwhile; ?>

يقول هذا الكود كله لووردبرس: “طالما هناك تدوينات أخرجها وإستعرضها على الصفحة الرئيسية كما هو محدد”. عملية “التحديد” هذه تقوم بها كل الأكواد الموجودة بين السطرين السابقين. وهذه الأكواد هي التي تحتاج إلى تعريب.

في العادة، هناك خمسة خصائص على الأكثر يتم عرضها في الصفحة الرئيسية:

- تاريخ التدوينة (أنظر المثال أو راجع هذه التدوينة)

- خدمة “إقرأ المزيد” (أنظر المثال)

- عدد التعليقات (أنظر المثال)

- التصنيفات / الأوسمة (أنظر المثال)

3- جملة “if” الشّرطية

لاحظ أن هذه الحلقة تأتي داخل ومباشرة تحت ما يعرف بجملة if الشّرطية. هذه الجملة تعمل كالأتي: إذا (شيئ ما) –> (إفعل هذا) –> وإلّا (إفعل هذا).

بكلمات أخرى، يسأل هذا الكود ووردبرس: “هل هناك تدوينات”؟ إذا نعم إفعل الحلقة (loop) وإذا لا:

‭
<h2‭ ‬class‭="‬center‭">Not Found‭</‬h2‭>‬
<p class‭="‬center‭">‬Sorry‭, ‬but you are looking for something that is not here‭.</‬p‭>‬
‬

حيث يعلن لك وجود خطأ “غير موجود”. عليك بالطبع تعريب كلمات الخطأ هذه.

لاحظ أخيراً أن هذا الوسم مثل “الحلقة” كما له بداية له نهاية:

<?php endif; ?>

مثال توضيحي

لنقوم الآن بتعريب هذا الملف. سأستخدم مثال الكود التالي…