ملف تكوين لغة WPML

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

الغرض من ملف تكوين اللغة

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

اذهب إلى صفحة WPML → إعدادات.

تخبر هذه الصفحة WPML بكل ما يحتاج إلى معرفته، بما في ذلك الحقول المخصصة التي يجب ترجمتها أو مزامنتها، وأنواع المنشورات المخصصة والتصنيفات التي ينبغي أن تكون متعددة اللغات، وحتى نصوص المسؤول التي يجب ترجمتها.

يتضمن ملف تكوين اللغة هذه المعلومات حتى لا يضطر كل مستخدم إلى إدخالها يدوياً في صفحة لوحة التحكم.

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

يتيح لك WPML أيضاً تجاوز أي إعدادات يتم تحميلها بواسطة ملفات تكوين لغة القوالب والإضافات يدوياً. ينطبق هذا على كل من ملفات تكوين اللغة الموجودة داخل المجلد الجذري للقالب أو الإضافة وملفات تكوين اللغة المستضافة على خوادمنا.

إعداد خيارات الترجمة لقوالب وإضافات الأطراف الخارجية

يتوافق WPML مع العديد من القوالب والإضافات الشائعة، وبالنسبة لها، لن تحتاج إلى إنشاء ملف تكوين لغة.

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

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

إنشاء ملف wpml-config.xml تلقائياً

إذا لم تكن معتاداً على إنشاء ملفات XML، فقد أنشأ فريقنا إضافة Multilingual Tools التي تجعل هذه المهمة أسهل. على الرغم من أنها صُممت في البداية كأداة لمساعدة مطوّري القوالب والإضافات في جعل منتجاتهم جاهزة لتعدد اللغات (Multilingual Ready)، إلا أنه يمكن استخدامها بسهولة لإنشاء ملف wpml-config.xml الخاص بك.

لمعرفة المزيد حول إنشاء ملف wpml-config.xml الخاص بك، زُر صفحة إضافة Multilingual Tools. وتحديداً، انظر أسفل قسم كيف يمكنني إنشاء ملفات تكوين اللغة باستخدام Multilingual Tools؟.

بمجرد حصولك على ملف التكوين، أضفه إلى المجلد الجذري لقالبك. إذا كان لديك ملف بالفعل، فلا تستبدله. بدلاً من ذلك، قم بتعديل ملف XML الأصلي وأضف الكود الذي تم إنشاؤه باستخدام إضافة Multilingual Tools.

يُرجى ملاحظة أن هذه الإضافة غير مخصصة للاستخدام على المواقع المباشرة.

لقراءة هذا الدليل التعليمي وبناء ملفات تكوين اللغة لقوالبك وإضافاتك، يمكنك البدء بهذا الملف كمثال – wpml-config.zip.

ستحتاج إلى تعديله، ولكن يمكنك استخدام أقسام وهيكل هذا الملف.

الهيكل وبناء الجملة

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

• ترجمة الأكواد المختصرة المخصصة باستخدام WPML
• تسجيل محتوى أداة بناء الصفحات للترجمة
• تسجيل ودجات أداة بناء الصفحات المخصصة للترجمة
• تعيين خيارات الترجمة للحقول المخصصة باستخدام ملف تكوين WPML
• تسجيل المصطلحات المخصصة و Types والتصنيفات كقابلة للترجمة
• جعل كتل Gutenberg المخصصة قابلة للترجمة
• ترجمة النصوص التي تحفظها القوالب والإضافات في wp_options
• تخصيص مبدل لغة WPML باستخدام ملف تكوين WPML
• تمكين القيم الرقمية للترجمة

استخدام ملف تكوين لغة WPML مع القوالب الأبناء

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

دعنا نفكر في مثال حيث يقوم ملف تكوين اللغة الخاص بالقالب الأب بتعيين نوع المنشور المخصص «Property» ليكون قابلاً للترجمة.

إذا كنت تستخدم قالباً ابناً وتريد تعيين نوع المنشور المخصص «Property» ليكون غير قابل للترجمة، فانتقل إلى صفحة WPML → إعدادات وانقر على علامة التبويب تكوين XML مخصص. استخدم المحرر لتعيين نوع المنشور المخصص «Property» ليكون غير قابل للترجمة. ببساطة، اضبط قيمة السمة translate على 0 بدلاً من 1.

تُعطى الأولوية للإعدادات الموجودة في علامة التبويب تكوين XML مخصص على الإعدادات الموجودة في ملف تكوين اللغة في القالب الأب.