WPML

wpml_browser_redirect_language_params

Filtre l’argument $params qui est un tableau associatif contenant des informations sur la langue actuelle.

wpml_browser_redirect_language_params
Type
filter
Catégorie
Informations sur les langues à l’échelle du site
Version de WPML
4.0.6

Description

Ce filtre peut être utilisé lorsque le développeur du thème souhaite utiliser un nom de cookie différent ou modifier le tableau languageUrls pour utiliser des URL différentes.

Il utilise l’argument $params qui est un tableau associatif contenant des informations sur la langue actuelle, les langues actives et les paramètres du cookie.

Arguments

pageLanguage
Stocke le code de la langue actuelle.
languageUrls
Stocke un tableau associatif contenant toutes les URL de traduction de la page actuelle. Les clés du tableau sont les codes de langue. La même langue peut avoir plusieurs entrées pour correspondre à une combinaison différente de codes de langue. Par exemple, dans le cas de en_US, la même URL est répétée trois fois avec les clés suivantes : en_us, en et us.
cookie
Stocke un tableau associatif avec les paramètres du cookie. Veuillez consulter Document.cookie pour plus de détails. Les clés sont :
  • name : le nom du cookie (par défaut _icl_visitor_lang_js).
  • domain : le domaine dans lequel le cookie doit être utilisé (par défaut le domaine actuel, et n’est pas censé être modifié).
  • path : le chemin du cookie (par défaut /).
  • expiration : l’expiration en secondes est lue à partir de la valeur définie dans Se souvenir de la préférence de langue des visiteurs qui se trouve dans Redirection selon la langue du navigateur sur la page WPML -> Langues.

Exemple d’utilisation

Pour utiliser ce filtre, l’option Redirection selon la langue du navigateur doit être activée sur la page WPML -> Langues.

Le code suivant peut être utilisé pour rediriger le navigateur vers la page d’accueil pour un article lorsque la langue est changée vers une langue spécifique 

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 associés

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

Les 29 hooks de la catégorie Informations sur les langues à l’échelle du site →