كيف اجعل قالب ووردبرس قابل للتعريب

يجب تحويل كافة النصوص ضمن القالب وتمريرها إلى أحد التابعين التاليين:

__('...')

أو

__e('...')

ولترتيب كافة النصوص ضمن القالب الخاص بك ليسهل ترجمها أختر اسم نطاق للنصوص خاص بالقالب يكون فريدًا وغير قابل للتكرار ومرره كمعامل ثانٍ للتوابع السابقة عند كل تحويل لنص ضمن القالب، مثال في حال اخترت اسم النطاق my-theme تصبح الاستدعاءات السابقة كالتالي

__('...', 'my-theme')

أو

__e('...', 'my-theme')

وضمن ملف التعريف بالقالب (غالبًا style.css) ضمن تعليق التعريف بالقالب أضف الخاصية Text Domain وقيمتها اسم النطاق المختار سابقًا كالتالي:

/*
* ....
* Text Domain: my-theme
*/

 بعدها ستجد النصوص ضمن القالب لديك قد ظهرت ضمن إضافة الترجمة ويمكنك ترجمتها وتخزين الترجمات ضمن الموقع

يمكنك تعريب القالب من خلال إنشاء مجلد باسم languages ووضع بداخله ملفات الخاصة باللغة مثل 

ar.mo
ar.po

en.mo
en.po

ويوجد برنامج باسم poedit يمكنك من التعديل على ملفات التي تكون بامتداد po.  و من خلاله يمكنك تعريب المفاتيح الخاصة باللغات و من ثم تستطعين توليد ملف ذا امتداد mo. من خلال هذا البرنامج, ثم يمكنك في ملف functions.php وضع السطر التالي 

load_theme_textdomain('assar', get_template_directory() . '/languages');

بحيث هذه الدالة تكون مسؤولة عن جلب ملف اللغة في حال تغيير اللغة و تأخذ متغيرين المتغير الأول اسم الدومين و من ثم المتغير الثاني يكون مسار مجلد اللغات , ومن ثم يمكنك استخدام الدالة التالية لجلب التعريب 

<?php esc_html_e('Read more', 'assar') ?>

بحيث المتغير الأول يكون مفتاح التعريب و المتغير الثاني يكون اسم الدومين الذي وضعناه من الدالة السابقة وهي 

load_theme_textdomain('assar', get_template_directory() . '/languages');