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הגדרותשפות.
- name: שם העוגייה (ברירת המחדל היא
דוגמת שימוש
כדי להשתמש בפילטר זה, הפנייה לפי שפת דפדפן חייבת להיות מופעלת ב־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