ضبط توافق WPML مع قوالب وإضافات WordPress - الإعدادات وملف wpml-config.xml المخصص

هذه الصفحة موجودة من أجل البقية: القوالب والإضافات الأقل شيوعاً، والإصدارات الحديثة جداً التي أصدرها مطوّر القالب قبل أن يواكبها توافق WPML، وعدد قليل من الأدوات المساعدة العامة للمواقع التي تواجه أعراضاً محددة. لا يزور معظم العملاء هذه الصفحة أبداً. وعندما تفعل ذلك، فعادةً ما يكون ذلك لأن دعم WPML قد وجّهك إلى خيار تبديل محدد أو إلى wpml-config.xml للصقه.

تغطي صفحتان فرعيتان من الإعدادات موضوع التوافق، وتغطي هذه الصفحة كلتيهما:

تحتوي WPMLإعداداتالتوافق على خيارات التبديل للأعراض الشائعة.
WPMLإعداداتتكوين XML مخصص هي المكان الذي تكتب فيه wpml-config.xml الخاص بك – وهي مشروحة في النصف الثاني من هذه الصفحة.

توجد واجهة المستخدم للإعدادات الافتراضية الأكثر شيوعاً (تفضيلات الترجمة لكل نوع منشور، ولكل تصنيف، ولكل حقل) في صفحة إعدادات منفصلة مشروحة في ما الذي تتم ترجمته – وما الذي لا تتم ترجمته؛ يستخدم معظم العملاء تلك الواجهة ولا يأتون إلى هنا إلا عندما لا تلبي احتياجاتهم.

خيارات تبديل التوافق

افتح WPMLإعداداتالتوافق.

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

خيارات التعريب – للقوالب والإضافات التي لا يتم تحميل ترجماتها

عندما يتضمن قالب أو إضافة ترجمات واجهة المستخدم الخاصة به (ملفات .mo في مجلد /languages/) ولكن هذه الترجمات لا تظهر على موقعك، فإن بطاقة خيارات التعريب تحتوي على ثلاثة خيارات تبديل تساعد WPML في العثور عليها وتطبيقها.

تحميل ملف .mo الخاص بالقالب تلقائياً باستخدام load_textdomain. يُجبر WPML على استدعاء load_textdomain() لنطاق نص القالب. استخدمه عندما تكون ترجمات القالب موجودة على القرص ولكنها لا تظهر.
أدخل نطاق النص. لتجاوز نطاق النص المكتشف تلقائياً. تُسجل بعض القوالب نطاق النص الخاص بها بطرق غير قياسية؛ يتيح لك هذا الحقل تحديده صراحةً.
استخدام نطاقات نص القالب أو الإضافة عندما لا تستخدم استدعاءات gettext سلسلة حرفية. علامة توافق للقوالب/الإضافات التي تستخدم استدعاءات __() مع وسيطات متغيرة بدلاً من السلاسل الحرفية. لا يمكن لـ WPML اكتشافها تلقائياً، ويساعد هذا الخيار في تطبيق الترجمات على أي حال.

إذا وجّهك دعم WPML إلى هنا، فسيخبرونك بخيار التبديل ونطاق النص الذي يجب تعيينه.

جعل القوالب تعمل بلغات متعددة

ضبط المعرفات للوظائف متعددة اللغات. طبقة توافق للقوالب التي تبرمج افتراضات اللغة الواحدة برمجياً (على سبيل المثال، قالب يخزن «معرف الصورة البارزة» مرة واحدة ويستخدم نفس الصورة عبر كل لغة).

لا تحتاج معظم القوالب الحديثة المتوافقة مع WPML إلى هذا. بينما تحتاجه أحياناً القوالب الأقدم أو الأقل توافقاً مع WPML. قم بتشغيله إذا رأيت مراجع المحتوى (الصور، القوائم، العناصر البارزة) تتسرب عبر اللغات بشكل غير صحيح.

تصفية اللغة لعمليات AJAX

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

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

السماح بترجمة صفحات تسجيل الدخول والتسجيل. لا تُعد شاشة /wp-login.php المدمجة في WordPress وشاشة التسجيل جزءاً من المحتوى العادي الذي يترجمه WPML. فهي توجد خارج سلسلة قوالب التصميم. يضيف هذا الخيار هذه الصفحات إلى مجموعة الصفحات القابلة للترجمة في WPML.

إذا كان موقعك يعمل على خادم nginx، فإن خيار التبديل يتطلب أيضاً تعديلاً في تكوين الخادم. ترتبط الصفحة بدليل nginx الخاص بـ WPML مع كتلة التكوين الدقيقة.

نصوص القوالب والإضافات – الإعدادات هنا، والماسح الضوئي في مكان آخر

ينقسم العمل على نوعين من السلاسل النصية للقوالب/الإضافات عبر شاشتين:

الإعدادات في هذه الصفحة. تتعامل مع التوافق للترجمات التي يتضمنها القالب/الإضافة بالفعل: load_textdomain، وتجاوز نطاق النص، واستدعاءات gettext غير الحرفية.
الماسح الضوئي في شاشة خاصة به. عندما تحتاج إلى العثور على السلاسل النصية للقوالب والإضافات التي لم تُسجل بعد للترجمة، استخدم شاشة ترجمة نصوص المسؤول. يمكن الوصول إليها من علامة التبويب السلاسل في الترجمات ضمن قسم «ألا ترى السلاسل النصية التي تبحث عنها؟».

للاطلاع على سير العمل الكامل للمسح الضوئي للسلاسل النصية، راجع ترجمة السلاسل النصية.

ملف wpml-config.xml مخصص

تأتي القوالب والإضافات المتوافقة مع WPML مزودة بملف wpml-config.xml يخبر WPML بالضبط بأي من حقولها، وأنواع منشوراتها، وتصنيفاتها، وأكوادها المختصرة، ومفاتيحها الوصفية يجب أن يكون قابلاً للترجمة. يقرأه WPML عند التفعيل. بالنسبة لكل قالب وإضافة شائعة ورئيسية، يعني هذا أن الترجمة تعمل بشكل صحيح وجاهزة للاستخدام فوراً. لا تحتاج إلى القيام بأي شيء.

عندما لا يكون ملف wpml-config.xml المرفق مع القالب أو الإضافة كافياً لموقعك، يمكنك كتابة ملفك الخاص. يطبقه WPML فوق كل ما يوفره القالب أو الإضافة.

متى تكتب ملف wpml-config.xml الخاص بك

ثلاثة سيناريوهات.

حقل تحتاج إلى ترجمته غير موجود في ملف wpml-config.xml المرفق. لم يعلن مطوّر القالب أو الإضافة أن الحقل المخصص قابل للترجمة، ولكنك تحتاج إلى ترجمته على موقعك.
حقل له إعداد افتراضي خاطئ. يحدد ملف wpml-config.xml المرفق شيئاً ما على أنه نسخ وأنت تريده ترجمة، أو العكس.
أنت تبني قالباً أو إضافة مخصصة وتريد إعلان سلوك الترجمة الخاص بها من صفحة إعدادات WPML بدلاً من إرفاق ملف wpml-config.xml مع الكود الخاص بك.

في كل حالة، قد يوجّهك دعم WPML إلى هنا مع كود wpml-config.xml الدقيق للصقه. في الغالب يكون هذا الإجراء بتوجيه من الدعم، وأحياناً بتوجيه من المطوّر.

لماذا يتم تعديل wpml-config.xml في لوحة تحكم WPML بدلاً من ملف القالب

يمكنك تعديل ملف wpml-config.xml الخاص بالقالب أو الإضافة مباشرةً. لكن هذا التغيير يضيع في المرة القادمة التي يتم فيها تحديث القالب أو الإضافة. يضع محرر WPML داخل لوحة التحكم في WPMLإعداداتتكوين XML مخصص ملف wpml-config.xml الخاص بك فوق كل ما يوفره القالب أو الإضافة، ويصمد أمام التحديثات. إنه المكان المناسب للتعديلات الخاصة بالموقع.

شكل ملف wpml-config.xml

الصفحة عبارة عن محرر XML. الصق كتلة <wpml-config>...</wpml-config>، واحفظ، وسيطبق WPML ملف wpml-config.xml الخاص بك.

ملف wpml-config.xml بحد أدنى يعلن أن الكود المختصر قابل للترجمة:

<wpml-config>
  <shortcodes>
    <shortcode>
      <tag>add_to_cart_link</tag>
    </shortcode>
  </shortcodes>
</wpml-config>

أنواع العناصر التي تعلن عنها عادةً:

<custom-fields>. لتحديد حقل مخصص كـ translate أو copy أو copy-once أو nothing.
<custom-types>. للإعلان عن نوع منشور مخصص كقابل للترجمة.
<taxonomies>. للإعلان عن تصنيف مخصص كقابل للترجمة.
<shortcodes>. لسرد الأكواد المختصرة التي يجب على WPML ترجمة محتواها.
<custom-term-fields>. للبيانات الوصفية للمصطلح.

لكل عنصر سماته الخاصة (على سبيل المثال، action="translate" في حقل مخصص). للحصول على المرجع الكامل لملف wpml-config.xml (كل عنصر، وكل سمة، وكل قيمة مسموح بها)، راجع معلومات مطوّر WPML.

سير عمل عملي

إذا أعطاك دعم WPML كتلة wpml-config.xml للصقها:

افتح WPMLإعداداتتكوين XML مخصص.
الصق كود XML الخاص بهم داخل كتلة <wpml-config> الحالية (أو استبدل المحتويات إذا أعطوك الكتلة كاملة).
احفظ.
يطبق WPML ملف wpml-config.xml الخاص بك على الفور. إذا أعلن عن نوع منشور أو حقل جديد قابل للترجمة، فسيظهر الإدخال في WPMLإعداداتترجمة أنواع المنشورات أو WPMLإعداداتترجمة الحقول المخصصة فوراً.

إذا كنت تبني قالباً أو إضافة مخصصة وتريد إرفاق تكوين WPML الخاص بها مع الكود، فستضع نفس كتلة <wpml-config> في ملف wpml-config.xml في جذر القالب أو الإضافة بدلاً من ذلك. يقرأه WPML عند التفعيل. المحرر داخل لوحة التحكم مخصص للتعديلات الخاصة بالموقع؛ بينما الملف المرفق مخصص للإعدادات الافتراضية الخاصة بالقالب/الإضافة.