يتيح لك WPML تخصيص مبدل اللغة لتلبية احتياجاتك الخاصة من خلال ضبط الإعدادات في ملف wpml-config.xml.
إن wpml-config.xml هو ملف تكوين يتيح لك تخصيص كيفية ظهور مبدل لغة WPML وعمله على موقعك. يمكنك تكوين عدد من الخصائص، مثل أنماط CSS، وإعدادات العرض، والأكواد المختصرة.
هذا الدليل مخصص للمطورين الذين يرغبون في تخصيص مبدل لغة WPML المدمج. إذا كنت ترغب في بناء واحد مخصص، اقرأ صفحتنا حول إنشاء مبدل لغة مخصص.
هل تحتاج إلى إنشاء ملف wpml-config.xml؟ تفضل بزيارة دليلنا التفصيلي حول الإنشاء التلقائي لملف التكوين باستخدام إضافة Multilingual Tools.
ما الذي يمكنني تخصيصه في مبدل اللغة الخاص بي؟
يتيح لك WPML تخصيص عدد من المتغيرات في مبدل اللغة الخاص بك. يشمل ذلك:
- أنماط CSS المضمنة – إضافة CSS مخصص مباشرةً إلى مبدل اللغة
- رابط إلى المحتوى غير المترجم – تحديد ما إذا كنت تريد إظهار أو إخفاء الروابط المؤدية إلى المحتوى غير المترجم
- معلمات URL المراد نسخها – تحديد معلمات URL التي يجب نسخها عند التبديل بين اللغات
- مبدل اللغة في الشريط الجانبي / التذييل – تكوين مظهر مبدل اللغة في الشريط الجانبي والتذييل، بما في ذلك:
- ما إذا كان سيتم عرض الأعلام و/أو أسماء اللغات
- ما إذا كان يجب عرض اللغة الحالية كرابط
- تعيين عنوان لودجت مبدل اللغة
- اختيار قالب لتخطيط مبدل اللغة
- تخصيص ألوان النص، والخلفية، والحدود باستخدام أكواد الألوان السداسية (hex)
- إجراءات الأكواد المختصرة – تحديد مظهر مبدلات اللغة المضافة عبر الأكواد المختصرة
مثال على إضافة تكوين مخصص لمبدل لغة WPML المدمج
<wpml-config>
<language-switcher-settings>
<key name="additional_css">{inline CSS styles}</key>
<key name="link_empty">{0 or 1}</key>
<key name="copy_parameters">{parameter1, parameter2}</key>
<key name="sidebars">
<key name="{sidebar slug}">
<key name="display_flags">{0 or 1}</key>
<key name="display_names_in_current_lang">{0 or 1}</key>
<key name="display_names_in_native_lang">{0 or 1}</key>
<key name="display_link_for_current_lang">{0 or 1}</key>
<key name="widget_title">{widget title}</key>
<key name="template">{template slug}</key>
<!-- color picker keys -->
<key name="background_normal">#{hex color}</key>
<key name="border_normal">#{hex color}</key>
<key name="font_current_normal">#{hex color}</key>
<key name="font_current_hover">#{hex color}</key>
<key name="background_current_normal">#{hex color}</key>
<key name="background_current_hover">#{hex color}</key>
<key name="font_other_normal">#{hex color}</key>
<key name="font_other_hover">#{hex color}</key>
<key name="background_other_normal">#{hex color}</key>
<key name="background_other_hover">#{hex color}</key>
</key>
</key>
<key name="statics">
<key name="footer">
<key name="show">{0 or 1}</key>
<key name="display_flags">{0 or 1}</key>
<key name="display_names_in_current_lang">{0 or 1}</key>
<key name="display_names_in_native_lang">{0 or 1}</key>
<key name="display_link_for_current_lang">{0 or 1}</key>
<key name="template">{template slug}</key>
<!-- color picker keys -->
<key name="background_normal">#{hex color}</key>
<key name="border_normal">#{hex color}</key>
<key name="font_current_normal">#{hex color}</key>
<key name="font_current_hover">#{hex color}</key>
<key name="background_current_normal">#{hex color}</key>
<key name="background_current_hover">#{hex color}</key>
<key name="font_other_normal">#{hex color}</key>
<key name="font_other_hover">#{hex color}</key>
<key name="background_other_normal">#{hex color}</key>
<key name="background_other_hover">#{hex color}</key>
</key>
<key name="post_translations">
<key name="show">{0 or 1}</key>
<key name="display_flags">{0 or 1}</key>
<key name="display_names_in_current_lang">{0 or 1}</key>
<key name="display_names_in_native_lang">{0 or 1}</key>
<key name="display_link_for_current_lang">{0 or 1}</key>
<key name="display_before_content">{0 or 1}</key>
<key name="display_after_content">{0 or 1}</key>
<key name="template">{template slug}</key>
<key name="availability_text">{string like "See post translations: %s"}</key>
</key>
<key name="shortcode_actions">
<key name="display_flags">{0 or 1}</key>
<key name="display_names_in_current_lang">{0 or 1}</key>
<key name="display_names_in_native_lang">{0 or 1}</key>
<key name="display_link_for_current_lang">{0 or 1}</key>
<key name="template">{template slug}</key>
<!-- color picker keys -->
<key name="background_normal">#{hex color}</key>
<key name="border_normal">#{hex color}</key>
<key name="font_current_normal">#{hex color}</key>
<key name="font_current_hover">#{hex color}</key>
<key name="background_current_normal">#{hex color}</key>
<key name="background_current_hover">#{hex color}</key>
<key name="font_other_normal">#{hex color}</key>
<key name="font_other_hover">#{hex color}</key>
<key name="background_other_normal">#{hex color}</key>
<key name="background_other_hover">#{hex color}</key>
</key>
</key>
</language-switcher-settings>
</wpml-config>ليس من الضروري أن تكون كل هذه الأقسام موجودة في ملف التكوين الخاص بك. فقط الأقسام التي تنطبق على إضافتك أو قالبك.
إعادة تعيين مبدل لغة WPML إلى الإعدادات الافتراضية
يمكنك أيضاً استخدام wpml-config.xml لإعادة تعيين تكوين مبدل اللغة إذا تم تغييره من الواجهة الخلفية (من قيمه الأولية).
لرؤية التغييرات الجديدة، تأكد من النقر على زر «استعادة الافتراضي» (Restore default) أسفل صفحة WPML → إعدادات → مبدلات اللغة .
موارد إضافية
لمعرفة المزيد حول ملف wpml-config.xml، تفضل بزيارة دليل ملفات تكوين اللغة.
لتخصيص عناصر أخرى باستخدام ملف wpml-config.xml، تفضل بزيارة أدلتنا الإضافية:
- ترجمة الأكواد المختصرة المخصصة باستخدام WPML
- تسجيل محتوى أداة بناء الصفحات للترجمة
- تسجيل ودجات أداة بناء الصفحات المخصصة للترجمة
- تعيين خيارات الترجمة للحقول المخصصة باستخدام ملف تكوين WPML
- تسجيل المصطلحات، و Types، والتصنيفات المخصصة كقابلة للترجمة
- جعل كتل Gutenberg المخصصة قابلة للترجمة
- ترجمة النصوص التي يحفظها القالب والإضافات في wp_options