apply_filters( 'wpml_language_codes_map', array $map )
- النوع
- filter
- إصدار WPML
- 5.0.0
الوصف
يُرشِّح خريطة رموز اللغات إلى الرموز التي يستخدمها WPML في عناوين URL.
للغة رمزان في WPML 5.0. language_code هو الرمز المُخزَّن، وهو لا يتغير أبداً. رمز URL هو الجزء الذي يراه الزائر، على سبيل المثال /de-de/. يختلف الرمزان عندما يُميّز WPML رمز URL، وهو ما يحدث عندما تضيف بلدين للغة واحدة في نفس الخطوة، وعندما يُعدّل مالك الموقع رمز URL.
هذا المرشِّح هو الخريطة التي يقرؤها مُحوّل URL نفسه، لذا لا يمكن أن يتعارض أبداً مع الروابط التي ينشئها WPML. استخدمه لمعرفة عنوان لغة ما. لقراءة جميع بيانات اللغات النشطة، بما في ذلك العَلَم وعنوان URL الكامل، استخدم wpml_active_languages.
أنت تنشئ الخريطة ويعيد WPML كتابتها. يستبدل WPML قيمة كل مفتاح يعرفه برمز URL لتلك اللغة، ويترك كل مفتاح آخر كما مررته. لا يضيف WPML أي لغة أبداً، لذا فإن المصفوفة الفارغة تعود فارغة. أنشئ الخريطة أولاً، مثل WPML code => WPML code، ثم طبّق المرشِّح. يفعل WPML الشيء نفسه في الكود الخاص به.
الوسائط
- المعلمات
-
- $map(مصفوفة) خريطة من
WPML code => codeتبنيها بنفسك. يستبدل WPML قيمة كل مفتاح يعرفه برمز URL الخاص بتلك اللغة. يحتفظ المفتاح الذي لا يعرفه WPML بالقيمة التي مررتها.
- $map(مصفوفة) خريطة من
- القيمة المرجعة
- (مصفوفة) نفس الخريطة، مع رمز URL لكل لغة يعرفها WPML. لا يضيف WPML أي مفاتيح، لذا مرر كل لغة تريد قراءتها.
مثال على الاستخدام
اقرأ الخريطة لمعرفة مقطع URL الذي تستخدمه لغة ما. يكتب المثال سطراً واحداً لكل لغة. يقرأ قائمة اللغات باستخدام wpml_active_languages، لذا فهو يعمل بعد الإجراء wp، مثل ذلك المرشِّح.
مثال
function my_language_url_codes() {
$codes = apply_filters( 'wpml_active_languages', null );
if ( empty( $codes ) ) {
return;
}
$identity = array_combine( array_keys( $codes ), array_keys( $codes ) );
$map = apply_filters( 'wpml_language_codes_map', $identity );
foreach ( $map as $language_code => $url_code ) {
echo esc_html( $language_code . ' is served at /' . $url_code . '/' ) . '<br />';
}
}
لتغيير رمز URL للغة ما، عدّله في WPML » إعدادات » اللغات. لا تستخدم هذا المرشِّح لنقل لغة إلى عنوان آخر: يقرأ WPML الخريطة عندما يحلل عنوان URL وارداً وعندما يبني رابطاً، لذا فإن القيمة التي لا تملكها أي لغة تنتج عناوين لا يستطيع WPML حلها.
الخطاطيف ذات الصلة
wpml_decode_custom_field, wpml_footer_language_selector, wpml_add_language_form_field, wpml_ls_exclude_in_menu, wpml_is_rtl, wpml_alternate_hreflang, wpml_head_langs, wpml_must_translate_canonical_url, wpml_browser_redirect_language_params, wpml_active_languages