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 quiere usar un nombre de cookie diferente o modificar el array languageUrls para usar URL diferentes.
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 un array asociativo que contiene todas las URL de traducción de la página actual. Las claves del array 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 un array asociativo con la configuración de la cookie. Consulte Document.cookie 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 WPML -> Idiomas.
- 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 -> Idiomas.
El siguiente código se puede usar para redirigir el navegador a la página de inicio de 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