يتيح لك 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 لإعادة تعيين تكوين مبدل اللغة إذا تم تغييره من الواجهة الخلفية (عن قيمه الأولية).
لرؤية التغييرات الجديدة، تأكد من النقر على زر استعادة الافتراضي في أسفل صفحة WPML → اللغات .
موارد إضافية
لمعرفة المزيد حول ملف wpml-config.xml ، تفضل بزيارة دليل ملفات تكوين اللغة.
لتخصيص عناصر أخرى باستخدام ملف wpml-config.xml، تفضل بزيارة أدلتنا الإضافية:
- ترجمة الأكواد المختصرة المخصصة باستخدام WPML
- تسجيل محتوى أداة بناء الصفحات للترجمة
- تسجيل ودجات أداة بناء الصفحات المخصصة للترجمة
- تعيين خيارات الترجمة للحقول المخصصة باستخدام ملف تكوين WPML
- تسجيل المصطلحات المخصصة، وTypes، والتصنيفات كقابلة للترجمة
- جعل كتل Gutenberg المخصصة قابلة للترجمة
- ترجمة النصوص التي يحفظها القالب والإضافات في wp_options