wpml_browser_redirect_language_params

wpml_browser_redirect_language_params

סוג

filter

קטגוריה

מידע שפה ברחבי האתר

גרסת WPML

4.0.6

תיאור

ניתן להשתמש בפילטר זה כאשר מפתח ערכת העיצוב רוצה להשתמש בשם קובץ Cookie שונה או להתאים את המערך languageUrls כדי להשתמש בכתובות URL שונות.

הוא משתמש בארגומנט $params, שהוא מערך אסוציאטיבי המכיל מידע על השפה הנוכחית, השפות הפעילות והגדרות ה־Cookie.

ארגומנטים

pageLanguage

מאחסן את קוד השפה הנוכחית.

languageUrls

מאחסן מערך אסוציאטיבי המכיל את כל כתובות ה־URL של תרגומי העמוד הנוכחי. המפתחות של המערך הם קודי השפות. לאותה שפה יכולות להיות מספר רשומות כדי להתאים לשילוב שונה של קודי שפות. לדוגמה, במקרה של en_US, אותה כתובת URL חוזרת על עצמה שלוש פעמים עם המפתחות הבאים: en_us, en ו־us.

cookie

מאחסן מערך אסוציאטיבי עם הגדרות העוגייה. עיין ב־Document.cookie לפרטים נוספים. המפתחות הם:

• name: שם העוגייה (ברירת המחדל היא _icl_visitor_lang_js).
• domain: הדומיין שבו יש להשתמש בעוגייה (ברירת המחדל היא הדומיין הנוכחי, ואין לשנות זאת).
• path: הנתיב של העוגייה (ברירת המחדל היא /).
• expiration: התפוגה בשניות נקראת מהערך המוגדר תחת Remember visitors’ language preference, שניתן למצוא תחת הפנייה לפי שפת דפדפן במסך 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 ההוקים בקטגוריה מידע שפה ברחבי האתר →