تشتمل العديد من قوالب WordPress على روابط مشفرة بشكل ثابت. على سبيل المثال، قد تبدو روابط التذييل التي تشير إلى صفحات الدعم وصفحات الاتصال بهذا الشكل:
<a href="/support/">Support</a> | <a href="/contact-us/">Contact us</a>
عند تشغيل الموقع متعدد اللغات يجب أن تتكيف هذه الروابط مع لغة العرض. يجب تغيير كل من نص الرابط (ما يراه الزائر) وعنوان URL (المكان الذي يشير إليه الرابط) عند تبديل اللغات.
ستُنتج دالة WPML icl_link_to_element() روابط مترجمة للصفحات ويجب استخدامها لهذا الغرض.
وصف الوظيفة
icl_link_to_element(المعرف، النوع، النص، الوسيطة، الرابط);
| الحجة | وصف | مطلوب/اختياري |
|---|---|---|
| بطاقة الهوية | معرّف المقالة أو الصفحة أو الوسم أو الفئة المراد الربط بها. | مطلوب |
| النوع | نوع الصفحة المراد الربط بها. يمكن أن يكون “منشور” أو “صفحة” أو “وسم” أو “فئة”. | اختياري، الافتراضي هو “النشر |
| النص | نص الرابط إذا لم يتم تحديده سينتج اسم العنصر باللغة الحالية. | اختياري، يتم تعيينه افتراضيًا إلى اسم العنصر. للترك على الوضع الافتراضي، أدخل خطأ. |
| الحجج | الوسيطات الاختيارية للرابط. عند استخدامها، يجب أن تكون مصفوفة PHP. | اختياري، افتراضي بدون وسيطات |
| مرساة | مرساة اختيارية للرابط. | اختياري، افتراضي على عدم وجود مرساة |
مثال على الاستخدام
| مثال على ذلك | الهدف | إنتاج HTML |
|---|---|---|
| <?php icl_link_to_element(10)؛ ?> | رابط الصفحة 10 (صفحة الدعم) | <a href=”/support/”>الدعم< /a> |
| <?’php icl_l_link_to_element(10,’post’,__(‘get help’))؛ ?> | رابط لصفحة الدعم مع نص رابط بديل | <a href=”/support/”>احصل على المساعدة</a> |
| <?’php icl_l_link_to_element(10,’post’,false, array(‘category’=>’products’,’priority’=>’high’)؛ ?> | الارتباط بصفحة الدعم وإضافة وسيطين | <a href=”/support/?category=products&products&propriority=high”>الدعم</a> |
| <?’php icl_link_to_element(10,’post’,false,’priority’=>’high’,’faq’)؛ ?> | ||
| <?’php icl_l_link_to_element(3,’tag’)؛ ?> | رابط الوسم بالمعرّف 3 (وسم “الأخبار” الخاص بنا) | <a href=”/tag/news/”>الأخبار< /a> |
كيف تعمل
يمكنك تحديد معرّف الصفحة/المشاركة/الوسم/الفئة بأي لغة. سيتحقق WPML من وجود ترجمة للغة الحالية. إذا كان الأمر كذلك، فإنه سينتج الرابط إليه. في حالة عدم وجود ترجمة، سيتم الربط بالصفحة باللغة الأصلية.
عند تحديد نص الرابط يدويًا، من الجيد أن تقوم بتغليفه في استدعاء gettext __()، بحيث يتم عرض النص باللغة الصحيحة. إذا لم تقم بتحديد أي نص رابط (كما في المثال الأول)، سيقوم WPML بإنتاج اسم تلك الصفحة.