إذا كنت مطوّر إضافة WordPress وتتطلع إلى توسيع نطاق وصول إضافتك إلى جمهور عالمي، فإن جعلها جاهزة للترجمة يعد خطوة مهمة للغاية. تتيح الإضافات الجاهزة للترجمة للمستخدمين ترجمة الإضافة بسهولة إلى لغتهم الأصلية، مما يجعلها متاحة لجمهور أوسع. في هذه المقالة، سنناقش كيفية جعل إضافة WordPress الخاصة بك جاهزة للترجمة والوصول إلى جمهور عالمي.
4 خطوات بسيطة لإنشاء إضافة جاهزة للترجمة
- استخدم وظائف التدويل
- استخدم نطاق النص
- إنشاء ملفات الترجمة
- تضمين ملفات الترجمة في إضافتك
استخدم وظائف التدويل:
تتيح لك هذه الوظائف تغليف السلاسل النصية في إضافتك باستخدام وظائف الترجمة، مما يجعلها جاهزة للترجمة. وظائف التدويل الأكثر استخدامًا في WordPress هي:
- __() و _e(): تُستخدم هذه الوظائف لترجمة السلاسل النصية في كود PHP. تقوم الدالة __() بإرجاع السلسلة المترجمة، بينما تقوم الدالة _e() بعرض السلسلة المترجمة مباشرة.
- _x(): تُستخدم هذه الدالة لترجمة السلاسل النصية مع وجود سياق محدد. تأخذ وسيطًا إضافيًا للسياق، والذي يمكن أن يكون مفيدًا في الحالات التي يكون فيها للسلسلة ترجمات مختلفة اعتمادًا على سياق استخدامها.
- esc_html__() و esc_html_e() و esc_attr__() و esc_attr_e(): تُستخدم هذه الوظائف لترجمة وتهريب سمات HTML والنصوص البرمجية في HTML على التوالي. وهي تضمن تهريب السلاسل المترجمة بشكل صحيح لمنع الثغرات الأمنية.
استخدم نطاق النص:
نطاق النص هو معرّف فريد لترجمات الإضافة الخاصة بك. يساعد WordPress في تحديد الترجمات التي يجب تحميلها لإضافتك. لتعريف نطاق نص لإضافتك، تحتاج إلى استخدام الدالة load_plugin_textdomain() في الملف الرئيسي للإضافة. إليك مثالاً:
function my_plugin_load_textdomain()
{
load_plugin_textdomain( ‘my-plugin’, false, dirname( plugin_basename( __FILE__ ) ) . ‘/languages/’ );
}
add_action( ‘plugins_loaded’, ‘my_plugin_load_textdomain’ );إنشاء ملفات الترجمة:
تحتوي ملفات الترجمة على السلاسل النصية المترجمة الخاصة بالإضافة الخاصة بك. عادةً ما يتم تخزينها في مجلد منفصل داخل دليل الإضافة، ويُسمى غالبًا ‘languages’. يتبع WordPress أسلوب تسمية محددًا لملفات الترجمة، والذي يعتمد على نطاق النص واللغة المستهدفة. على سبيل المثال، إذا كان نطاق النص الخاص بإضافتك هو ‘my-plugin’ وتريد ترجمتها إلى الإسبانية، فيجب تسمية ملف الترجمة ‘my-plugin-es_ES.mo’ (لإسبانيا) أو ‘my-plugin-es_MX.mo’ (للمكسيك).
يتم تجميع ملفات الترجمة من الملفات المصدرية ذات الامتداد ‘.po’، والذي يرمز إلى Portable Object. يمكنك إنشاء ملفات ‘.po’ باستخدام محرر ترجمة مثل Poedit، والذي يتيح لك تحديد السلاسل الأصلية وترجماتها. بعد إنشاء ملفات ‘.po’، تحتاج إلى تجميعها وتحويلها إلى ملفات ‘.mo’، والتي ترمز إلى Machine Object، باستخدام إضافة مثل Automatic Translate Addon For Loco Translate.
تضمين ملفات الترجمة في إضافتك:
بعد إنشاء ملفات الترجمة، تحتاج إلى تضمينها في الإضافة الخاصة بك حتى يتمكن WordPress من تحميلها عند الحاجة. يمكنك القيام بذلك من خلال وضع ملفات ‘.mo’ في مجلد ‘languages’ الخاص بالإضافة واستخدام الدالة load_plugin_textdomain() لتحديد مسار المجلد. إليك مثالاً:
function my_plugin_load_textdomain()
{
load_plugin_textdomain( ‘my-plugin’, false, dirname( plugin_basename( __FILEالخاتمة
في الختام، يعد جعل إضافة WordPress الخاصة بك جاهزة للترجمة خطوة أساسية لضمان إمكانية ترجمة الإضافة بسهولة إلى لغات مختلفة وخدمة جمهور عالمي. من خلال اتباع الخطوات الموضحة في هذه المقالة، بما في ذلك استخدام وظائف التدويل، وتعريف نطاق النص، وإنشاء ملفات الترجمة، وتضمينها في الإضافة الخاصة بك، يمكنك جعل إضافتك جاهزة للترجمة وزيادة سهولة استخدامها للمستخدمين حول العالم.
يتيح توفير ترجمات لإضافتك الوصول إلى جمهور أوسع وجعل إضافتك أكثر سهولة في الاستخدام لغير الناطقين باللغة الإنجليزية. كما يُظهر ذلك اهتمامك بالشمولية وإمكانية الوصول، مما قد يساهم في نجاح وانتشار إضافتك. لذلك، إذا كنت تقوم بتطوير إضافة WordPress، فتأكد من بذل الجهد لجعلها جاهزة للترجمة وفتح إضافتك أمام قاعدة مستخدمين عالمية.
