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
- Хранит ассоциативный массив с настройками файлов cookie. Для получения подробной информации обратитесь к Document.cookie. Доступные ключи:
- name: имя файла cookie (по умолчанию
_icl_visitor_lang_js). - domain: домен, в котором должен использоваться файл cookie (по умолчанию текущий домен, не предназначен для изменения).
- path: путь файла cookie (по умолчанию
/). - expiration: срок действия в секундах считывается из значения, установленного в параметре Запоминать языковые предпочтения посетителей, который находится в разделе Перенаправление по языку браузера в меню WPML -> Языки.
- name: имя файла cookie (по умолчанию
Пример использования
Чтобы использовать этот фильтр, необходимо включить Перенаправление по языку браузера в меню 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) →