wpml_browser_redirect_language_params
- Tipo
- filter
- Categoría
- Información de idioma de todo el sitio
- Versión de WPML
- 4.0.6
Descripción
Este filtro se puede utilizar cuando el desarrollador del tema desea usar un nombre de cookie diferente o ajustar el array languageUrls para usar URL distintas.
Utiliza el argumento $params, que es un array asociativo que contiene información sobre el idioma actual, los idiomas activos y la configuración de las cookies.
Argumentos
- pageLanguage
- Almacena el código del idioma actual.
- languageUrls
- Almacena una matriz asociativa que contiene todas las URL de traducción de la página actual. Las claves de la matriz son los códigos de idioma. El mismo idioma puede tener varias entradas para coincidir con una combinación diferente de códigos de idioma. Por ejemplo, en el caso de
en_US, la misma URL se repite tres veces con las siguientes claves:en_us,enyus. - cookie
- Almacena una matriz asociativa con la configuración de la cookie. Consulte Document.cookie (se abre en una pestaña nueva) para obtener más detalles. Las claves son:
- name: el nombre de la cookie (el valor predeterminado es
_icl_visitor_lang_js). - domain: el dominio en el que se debe usar la cookie (el valor predeterminado es el dominio actual y no está diseñado para cambiarse).
- path: la ruta de la cookie (el valor predeterminado es
/). - expiration: la caducidad en segundos se lee del valor establecido en Recordar la preferencia de idioma de los visitantes que se puede encontrar en Redirección por idioma del navegador en WPMLConfiguraciónIdiomas.
- name: el nombre de la cookie (el valor predeterminado es
Ejemplo de uso
Para usar este filtro, la Redirección por idioma del navegador debe estar activada en WPML → Configuración → Idiomas.
El siguiente código se puede utilizar para redirigir el navegador a la página de inicio para una entrada cuando el idioma se cambia a uno 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
Todos los 30 hooks de Información de idioma de todo el sitio