WPML

wpml_browser_redirect_language_params

Filtert das Argument $params, ein assoziatives Array, das Informationen über die aktuelle Sprache enthält.

wpml_browser_redirect_language_params
Typ
filter
Kategorie
Websiteübergreifende Sprachinformationen
WPML-Version
4.0.6

Beschreibung

Dieser Filter kann verwendet werden, wenn der Theme-Entwickler einen anderen Cookie-Namen verwenden oder das Array languageUrls anpassen möchte, um andere URLs zu nutzen.

Er verwendet das Argument $params, ein assoziatives Array, das einige Informationen über die aktuelle Sprache, die aktiven Sprachen und die Cookie-Einstellungen enthält.

Argumente

pageLanguage
Speichert den aktuellen Sprachcode.
languageUrls
Speichert ein assoziatives Array, das alle Übersetzungs-URLs der aktuellen Seite enthält. Die Schlüssel des Arrays sind die Sprachcodes. Dieselbe Sprache kann mehrere Einträge haben, um einer anderen Kombination von Sprachcodes zu entsprechen. Beispielsweise wird im Fall von en_US dieselbe URL dreimal mit den folgenden Schlüsseln wiederholt: en_us, en und us.
cookie
Speichert ein assoziatives Array mit den Cookie-Einstellungen. Weitere Details finden Sie unter Document.cookie. Die Schlüssel sind:
  • name: der Name des Cookies (standardmäßig _icl_visitor_lang_js).
  • domain: die Domain, in der das Cookie verwendet werden muss (standardmäßig die aktuelle Domain und nicht zur Änderung vorgesehen).
  • path: der Pfad des Cookies (standardmäßig /).
  • expiration: der Ablauf in Sekunden wird aus dem Wert gelesen, der unter Spracheinstellung der Besucher speichern festgelegt ist. Diesen finden Sie im Bereich Browser-Sprachumleitung unter WPML -> Sprachen.

Anwendungsbeispiel

Um diesen Filter zu verwenden, muss die Browser-Sprachumleitung unter WPML -> Sprachen aktiviert sein.

Der folgende Code kann verwendet werden, um den Browser für einen Beitrag zur Startseite umzuleiten, wenn die Sprache auf eine bestimmte Sprache geändert wird 

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' );

Verwandte Hooks

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

Alle 29 Websiteübergreifende Sprachinformationen-Hooks →