تخصيص مبدل لغة WPML – الموضع والتصميم والسلوك

ما يمكن أن يفعله مبدل لغة WPML

دون إعدادات إضافية، يُنشئ WPML مبدل لغة يقوم بما يلي:

• يعرض كل لغة نشطة على موقعك، بالترتيب الذي تختاره.
• يُعنون كل لغة باسمها الأصلي (Deutsch، Français) أو بلغة الموقع الحالية (الألمانية، الفرنسية) – حسب اختيارك.
• يعرض الأعلام اختياريًا (صورة مجمعة تتناسب مع قالبك).
• يتعامل مع الترجمات المفقودة بسلاسة: إما بتخطي اللغة، أو بالربط بالصفحة الرئيسية لتلك اللغة.
• يمكن وضعه في أي قائمة من قوائم WordPress، أو في أي منطقة ودجت، أو في التذييل، أو مضمنًا أعلى المقالات وأسفلها.
• يأتي في كتلة Gutenberg لأي تخطيط لأداة بناء الصفحات.
• يمكن إخفاؤه في صفحات معينة حيث قد يكون عائقًا (404، إتمام الشراء، الحساب).
• يُخزن HTML المصرّف مؤقتًا لضمان سرعة تحميل الصفحة.

تستخدم معظم المواقع المواضع المدمجة والإعدادات الافتراضية. يمكن لمطوّري القوالب الذين يحتاجون إلى مزيد من التحكم بناء مبدل لغة مخصص في الكود باستخدام API الخاص بـ WPML.

أين توجد الإعدادات

افتح WPML > إعدادات > مبدلات اللغة. يتم تجميع الصفحة حسب السؤال، وليس حسب علامة تبويب واجهة المستخدم. اختر القسم الذي يطابق ما تريد تغييره.

ما اللغات التي تظهر وبأي ترتيب

تحتوي بطاقة خيارات مبدل اللغة على منطقة سحب وإفلات تسرد كل لغة نشطة. يحدد الترتيب هنا الترتيب في كل مبدل لغة على الموقع. اسحب اللغات لأعلى أو لأسفل واحفظ.

في نفس البطاقة، اختر:

• الاسم الأصلي مقابل لغة الموقع الحالية. اعرض Deutsch (الاسم الأصلي) أو German (لغة الموقع الحالية). الاسم الأصلي أكثر جاذبية للمتحدثين بتلك اللغة؛ ولغة الموقع الحالية أكثر وضوحًا للزوار لأول مرة.
• تشغيل الأعلام أو إيقافها، وتنسيق العلم.

ماذا يحدث عند غياب الترجمة

ليست كل صفحة مترجمة إلى كل لغة. يحدد خيار كيفية التعامل مع اللغات التي لا تحتوي على ترجمة ما يفعله مبدل اللغة للغة لا تحتوي على ترجمة للصفحة الحالية:

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

هذا الاختيار له آثار على تجربة المستخدم تستحق التفكير فيها بعناية.

أين يظهر مبدل اللغة

خمسة مواضع، يتم تبديل كل منها بشكل مستقل في صفحة الإعدادات نفسها:

• مبدل لغة القائمة. أضف مبدل اللغة في أي قائمة من قوائم WordPress (الترويسة، التذييل، الشريط الجانبي، أو أي مكان يعين فيه قالبك القوائم). أضف مبدلات متعددة إذا كنت تريد مواضع مختلفة لكل قائمة. يحصل كل مبدل لغة في القائمة على صف معاينة خاص به يوضح مكان وجوده.
• ويدجت مبدل اللغة. أضف مبدل اللغة إلى أي منطقة ودجت يسجلها قالبك: الأشرطة الجانبية، مناطق الترويسة، أعمدة التذييل.
• مبدّل اللغة في التذييل. زر تبديل عام واحد يعرض مبدل اللغة تلقائيًا في أسفل كل صفحة.
• روابط مضمنة لترجمات المقالات. مربع اختيار واحد يعرض روابط «هذه المقالة متاحة باللغة X» أعلى أو أسفل كل مقالة.
• مبدلات لغة مخصصة. عندما لا تكون المواضع المدمجة كافية، يمكن لمطوّري القوالب استدعاء API لمبدل لغة WPML من أي ملف قالب. تعرض صفحة الإعدادات زر تخصيص لخيارات العرض.

إخفاء مبدل اللغة في صفحات معينة

بعض الصفحات لا تحتاج إلى مبدل لغة: صفحة 404، شاشات الحساب، إتمام الشراء. تتيح لك قواعد العرض الشرطي في WPML إخفاء مبدل اللغة لكل صفحة دون اللجوء إلى display:none CSS في قالبك.

يمكنك تعيين قواعد لكل صفحة في نفس صفحة إعدادات > مبدلات اللغة. اختر الصفحات التي تريد إخفاء مبدل اللغة فيها؛ تنطبق القاعدة على كل موضع لمبدل اللغة في وقت واحد.

الاحتفاظ بمعلمات URL

عندما ينقر الزائر على مبدل اللغة، يعيد WPML بناء عنوان URL للغة الهدف. افتراضيًا، يتم إسقاط معلمات سلسلة الاستعلام (?utm_source=newsletter، معلمات المرشِّح، إلخ). يؤدي هذا إلى تعطل حملات التحليلات والقوائم المصفاة.

يسرد حقل الاحتفاظ بوسائط URL مفاتيح الاستعلام التي تريد الاحتفاظ بها عند التبديل. أي شيء تضعه هنا (واحد في كل سطر) ينتقل مع الزائر إلى عنوان URL المترجم.

CSS مخصص لمبدل اللغة

تُطبق منطقة نصية واحدة ضمن CSS إضافي التصميم على كل مبدل لغة في الموقع في وقت واحد. مفيد لمطابقة مبدل اللغة مع قالبك دون المساس بملفات القالب.

التخزين المؤقت لقالب مبدل اللغة

تحتوي بطاقة الأداء على مربع اختيار واحد: التخزين المؤقت لقوالب مبدل اللغة. عند تشغيله، يقوم WPML بتخزين HTML المصرّف لكل موضع لمبدل اللغة مؤقتًا، مما يسرّع تحميل الصفحات في المواقع المزدحمة.

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

مبدلات لغة مخصصة في كود القالب

بالنسبة للمواقع التي لا تناسبها المواضع المدمجة (مبدل لغة في موضع معين داخل ترويسة الصفحة، قائمة منسدلة مخصصة يعرضها قالبك، أي شيء خارج قائمة WordPress أو منطقة ودجت)، يوفر WPML واجهة برمجة تطبيقات (API) تتيح لمطوّري القوالب بناء مبدل لغة مخصص.

تحتوي بطاقة مبدلات لغة مخصصة على زر تبديل تمكين وزر تخصيص. بمجرد التمكين، يمكن لكود القالب عرض مبدل اللغة في أي مكان باستخدام API لـ PHP الموثق من WPML.