wpml_browser_redirect_language_params
- Tipo
- filter
- Categoria
- Informações de idioma de todo o site
- Versão do WPML
- 4.0.6
Descrição
Este filtro pode ser usado quando o desenvolvedor do tema quiser usar um nome de cookie diferente ou ajustar o array languageUrls para usar URLs diferentes.
Ele usa o argumento $params, que é um array associativo contendo algumas informações sobre o idioma atual, os idiomas ativos e as configurações de cookie.
Argumentos
- pageLanguage
- Armazena o código do idioma atual.
- languageUrls
- Armazena um array associativo contendo todos os URLs de tradução da página atual. As chaves do array são os códigos de idioma. O mesmo idioma pode ter várias entradas para corresponder a uma combinação diferente de códigos de idioma. Por exemplo, no caso do
en_US, o mesmo URL é repetido três vezes com as seguintes chaves:en_us,eneus. - cookie
- Armazena um array associativo com as configurações de cookie. Consulte Document.cookie para obter mais detalhes. As chaves são:
- name: o nome do cookie (o padrão é
_icl_visitor_lang_js). - domain: o domínio no qual o cookie deve ser usado (o padrão é o domínio atual e não deve ser alterado).
- path: o caminho do cookie (o padrão é
/). - expiration: a expiração em segundos é lida a partir do valor definido em Lembrar a preferência de idioma dos visitantes, que pode ser encontrado em Redirecionamento de idioma do navegador em WPML -> Idiomas.
- name: o nome do cookie (o padrão é
Exemplo de uso
Para usar este filtro, o Redirecionamento de idioma do navegador deve estar ativado em WPML -> Idiomas.
O código a seguir pode ser usado para redirecionar o navegador para a página inicial de um post quando o idioma é alterado para um específico
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' );
Hooks relacionados
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