WPML

wpml_browser_redirect_language_params

تصفية الوسيط $params الذي يمثل مصفوفة ترابطية تحتوي على معلومات حول اللغة الحالية

wpml_browser_redirect_language_params
النوع
filter
الفئة
معلومات اللغة على مستوى الموقع
إصدار WPML
4.0.6

الوصف

يمكن استخدام هذا المرشِّح عندما يريد مطور القالب استخدام اسم مختلف لملف تعريف الارتباط أو تعديل المصفوفة languageUrls لاستخدام روابط URL مختلفة.

يستخدم الوسيطة $params وهي مصفوفة ترابطية تحتوي على بعض المعلومات حول اللغة الحالية، واللغات النشطة وإعدادات ملفات تعريف الارتباط.

الوسطاء

pageLanguage
يخزن رمز اللغة الحالية.
languageUrls
يخزن مصفوفة ترابطية تحتوي على جميع عناوين URL لترجمات الصفحة الحالية. مفاتيح المصفوفة هي رموز اللغات. يمكن أن يكون للغة نفسها إدخالات متعددة لتتطابق مع مجموعة مختلفة من رموز اللغات. على سبيل المثال، في حالة en_US، يتكرر عنوان URL نفسه ثلاث مرات باستخدام المفاتيح التالية: en_us و en و us.
cookie
يخزن مصفوفة ترابطية تحتوي على إعدادات ملفات تعريف الارتباط. يُرجى الرجوع إلى Document.cookie لمزيد من التفاصيل. المفاتيح هي:
  • name: اسم ملف تعريف الارتباط (الافتراضي هو _icl_visitor_lang_js).
  • domain: النطاق الذي يجب استخدام ملف تعريف الارتباط فيه (الافتراضي هو النطاق الحالي ولا يُفترض تغييره).
  • path: مسار ملف تعريف الارتباط (الافتراضي هو /).
  • expiration: تُقرأ مدة الصلاحية بالثواني من القيمة المحددة في تذكر تفضيلات لغة الزوار والتي يمكن العثور عليها في إعادة توجيه لغة المتصفح في WPML -> اللغات.

مثال على الاستخدام

لاستخدام هذا المرشِّح، يجب تمكين إعادة توجيه لغة المتصفح في WPML -> اللغات.

يمكن استخدام الكود التالي لإعادة توجيه المتصفح إلى الصفحة الرئيسية لمقالة عند تغيير اللغة إلى لغة محددة 

function example_callback( $params ) {
	global $post;
	// Redirect the French language to the home page if the current page ID is 123
	if ( $post->ID === 123 ) {
		$params['pageLanguage'] = 'en';
		$params['languageUrls'] = [ 'fr' => 'http://example.com/fr/' ];
	}
	return $params;
}
add_filter( 'wpml_browser_redirect_language_params', 'example_callback' );

خطاطيف ذات صلة

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_active_languages, wpml_encode_custom_field

جميع خطاطيف معلومات اللغة على مستوى الموقع البالغ عددها 29 →