تعريب قالب ووردبريس بـ Loco Translate وضبط RTL خطوة بخطوة

تعريب قالب ووردبريس لا يعني ترجمة الكلمات فقط؛ المطلوب عادة هو ترجمة النصوص الظاهرة للمستخدم والتأكد أن التصميم يعمل بصورة صحيحة من اليمين إلى اليسار RTL. في هذا الدليل سننفذ المسار العملي المناسب لمدير الموقع باستخدام Loco Translate، ثم نوضح متى تحتاج تدخلًا برمجيًا بدل الاستمرار في الترجمة من لوحة التحكم.

الإجابة السريعة: إذا كان القالب جاهزًا للترجمة، ابدأ بتعيين لغة الموقع إلى العربية، ثم استخدم Loco Translate لترجمة السلاسل النصية واحفظ ملفات اللغة في مسار آمن لا يختفي مع تحديث القالب. بعد ذلك اختبر RTL على الهيدر والقوائم والنماذج وWooCommerce والموبايل.

تعريب قالب ووردبريس عمليًا

ما معنى تعريب قالب ووردبريس؟

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

قبل البدء: هل القالب جاهز للترجمة؟

• غيّر لغة الموقع من الإعدادات إلى العربية واختبر هل جزء كبير من النصوص يترجم تلقائيًا.
• راجع وجود Text Domain صحيح في القالب؛ في القوالب الجاهزة للتوزيع يجب أن يتوافق عادة مع slug القالب.
• افحص هل العبارات مكتوبة عبر دوال الترجمة في WordPress بدل أن تكون Hardcoded داخل ملفات PHP.
• لا تعدّل ملفات القالب الأب مباشرة لمجرد تغيير نص؛ التحديث القادم قد يمسح التعديل.

للمطورين الذين يحتاجون فحص Text Domain ودوال i18n وملفات POT/PO/MO على مستوى الكود، يوجد شرح منفصل في تعريب قالب ووردبريس للمطورين.

الطريقة العملية: تعريب القالب باستخدام Loco Translate

1. خذ نسخة احتياطية واستخدم Staging عند الحاجة

الترجمة نفسها منخفضة المخاطر، لكن بعض القوالب والمتاجر تحتوي Templates وStrings كثيرة. في موقع تجاري أو WooCommerce يفضل اختبار التغييرات على Staging ثم نقل ملفات اللغة أو تنفيذها على الموقع الحي بعد التحقق.

2. ثبّت Loco Translate من المستودع الرسمي

من لوحة WordPress اذهب إلى إضافات ← أضف إضافة جديدة وابحث عن Loco Translate، ثم ثبّتها وفعّلها. إذا احتجت شرحًا أوسع للتثبيت راجع كيفية تثبيت إضافات ووردبريس.

3. افتح القالب المطلوب

اذهب إلى Loco Translate ← Themes واختر القالب النشط أو القالب الذي تريد تعريبه. إذا وجدت العربية موجودة بالفعل، افتحها وراجع السلاسل غير المترجمة. إذا لم تكن موجودة، أنشئ لغة جديدة واختر العربية.

4. اختر مسار حفظ آمن لملفات اللغة

تجنب حفظ ترجمتك المخصصة داخل مجلد قد يستبدله تحديث القالب. Loco Translate يوفر مسارات محمية داخل wp-content/languages/loco/، وهي مناسبة للترجمات المحلية التي تريد الحفاظ عليها بعيدًا عن ملفات القالب الأصلية.

5. ترجم السلاسل حسب السياق لا كلمة بكلمة

• ترجم أزرار المتجر مثل Add to cart بما يناسب تجربة الشراء.
• حافظ على المصطلحات التقنية المعروفة إذا كانت ترجمتها ستربك المستخدم.
• راجع Singular وPlural Forms عندما تكون السلسلة مرتبطة بعدد.
• لا تترجم placeholders أو متغيرات مثل %s و%d أو HTML داخل السلسلة بطريقة تكسرها.
• استخدم البحث داخل Loco للوصول إلى عبارة محددة بدل تصفح آلاف السلاسل.

6. احفظ واختبر الواجهة الأمامية

بعد الحفظ، افتح الصفحة التي تحتوي على النص المطلوب في نافذة خاصة أو بعد تفريغ الكاش. إذا لم يظهر التغيير، تأكد أولًا أن النص صادر من القالب فعلًا وليس من WooCommerce أو إضافة أخرى أو Page Builder.

كيف تعرف مصدر النص الذي لم يترجم؟

ليس كل ما تراه في الواجهة جزءًا من القالب. النص قد يأتي من WooCommerce، Elementor، إضافة عضويات، إضافة Checkout أو كود مخصص. إذا بحثت عن العبارة داخل ترجمة القالب ولم تجدها، افتح Loco Translate لقسم Plugins وحدد الإضافة المسؤولة بدل إنشاء ترجمة في المكان الخطأ.

كيف تجعل القالب يدعم RTL؟

عندما تكون لغة الموقع RTL، يستطيع WordPress تحميل ملف rtl.css في القوالب الكلاسيكية التي توفره. لكن وجود الملف وحده لا يضمن جودة التصميم؛ يجب اختبار المكونات الفعلية، خصوصًا القوائم، Breadcrumbs، Sliders، Forms، Icons، Product Gallery وCheckout.

• استخدم CSS logical properties مثل margin-inline وpadding-inline عندما يكون ذلك مناسبًا بدل تكرار left/right بلا داعٍ.
• لا تعكس كل الأيقونات تلقائيًا؛ سهم الرجوع قد يحتاج انعكاسًا بينما شعار أو أيقونة تشغيل لا تحتاج ذلك.
• اختبر القالب على Desktop وTablet وMobile.
• راجع عناصر WooCommerce الحساسة: السعر، الكمية، Cart Drawer، Checkout Fields ورسائل التحقق.
• لا تعدّل ملفات القالب الأب؛ استخدم Child Theme أو CSS مخصصًا عندما تكون المشكلة تصميمية فقط.

ماذا لو القالب غير جاهز للترجمة؟

إذا كانت النصوص Hardcoded أو Text Domain غير صحيح أو القالب لا يستخدم دوال الترجمة، فلن يحل Loco Translate المشكلة وحده. هنا تحتاج إلى تعديل القالب بطريقة صحيحة: تغليف النصوص بدوال i18n، ضبط Text Domain، إنشاء Template للترجمة، ثم تحميل ملفات اللغة. لا تنفذ ذلك داخل قالب تجاري أب إذا كان التحديث سيستبدل تعديلاتك.

مشاكل شائعة بعد تعريب قالب ووردبريس

الترجمة اختفت بعد تحديث القالب

غالبًا تم حفظ الملفات داخل مجلد القالب. استخدم مسارًا محميًا للترجمة المحلية واحتفظ بنسخة احتياطية قبل التحديثات.

بعض الكلمات ما زالت بالإنجليزية

حدد مصدر النص: القالب أم إضافة أم Widget أم JavaScript. بعض النصوص لا تأتي من ملف الترجمة الذي تعمل عليه.

العربية تعمل لكن التصميم مكسور

هذه مشكلة RTL وليست مشكلة ترجمة. افحص CSS واتجاه Flex/Grid والهوامش والـabsolute positioning والمكونات التي تستخدم JavaScript.

Loco لا يجد بعض العبارات

قد تكون السلسلة Hardcoded أو مولدة ديناميكيًا أو موجودة في JavaScript أو في إضافة أخرى. لا تنشئ ترجمة عشوائية قبل تحديد المصدر.

Checklist لاختبار التعريب قبل الإطلاق

• الهيدر والقائمة الرئيسية والقائمة على الموبايل.
• صفحة المقال والأرشيف والبحث و404.
• نماذج التواصل ورسائل الخطأ.
• صفحات WooCommerce: Shop وProduct وCart وCheckout وMy Account.
• الأزرار والـplaceholders ورسائل Validation.
• التواريخ والأرقام والعملات.
• RTL على الشاشات الصغيرة.
• الكاش وملفات CSS المجمعة بعد التعديل.

أسئلة شائعة

هل أحتاج Loco Translate دائمًا؟

لا. إذا كانت الترجمة الرسمية تغطي القالب بالكامل فلن تحتاج تعديلًا محليًا. استخدم Loco عندما تحتاج ترجمة مخصصة أو عندما توجد سلاسل غير مترجمة.

هل أترجم القالب من ملف functions.php؟

لا. ملف functions.php ليس مكانًا لكتابة ترجمة الواجهة يدويًا. المطلوب أن تكون السلاسل قابلة للترجمة عبر دوال WordPress، ثم تُدار الترجمات في ملفات اللغة.

هل RTL يعني direction: rtl فقط؟

لا. direction خطوة واحدة، لكن التصميم قد يحتاج معالجة المسافات والمحاذاة وترتيب العناصر والأيقونات وبعض المكونات التفاعلية.

الخلاصة

أفضل مسار لـتعريب قالب ووردبريس هو تحديد ما إذا كان القالب جاهزًا للترجمة، ثم ترجمة السلاسل من مصدرها الصحيح، وحفظ ملفات اللغة في مكان لا يتأثر بالتحديث، واختبار RTL على الصفحات المهمة. إذا اكتشفت أن المشكلة في بنية القالب نفسها، انتقل إلى المسار البرمجي بدل محاولة إجبار Loco Translate على ترجمة نصوص غير مهيأة أصلًا.