wpml_browser_redirect_language_params
- タイプ
- filter
- カテゴリー
- サイト全体の言語情報
- WPMLバージョン
- 4.0.6
説明
このフィルターは、テーマ開発者が別のCookie名を使用したい場合や、異なるURLを使用するためにlanguageUrls配列を調整したい場合に使用できます。
現在の言語、有効な言語、およびCookie設定に関する情報を含む連想配列である$params引数を使用します。
引数
- pageLanguage
- 現在の言語コードを格納します。
- languageUrls
- 現在のページのすべての翻訳URLを含む連想配列を格納します。配列のキーは言語コードです。同じ言語でも、言語コードの異なる組み合わせに一致するよう複数のエントリを持つことができます。たとえば、
en_USの場合、同じURLがen_us、en、およびusのキーで3回繰り返されます。 - cookie
- Cookie設定を含む連想配列を格納します。詳細については、Document.cookieを参照してください。キーは以下のとおりです。
- name: Cookieの名前（デフォルトは
_icl_visitor_lang_js）。 - domain: Cookieを使用するドメイン（デフォルトは現在のドメインであり、変更することは想定されていません）。
- path: Cookieのパス（デフォルトは
/）。 - expiration: 秒単位の有効期限は、WPML -> 言語のブラウザ言語リダイレクトにある訪問者の言語設定を記憶するに設定された値から読み取られます。
- name: Cookieの名前（デフォルトは
使用例
このフィルターを使用するには、WPML -> 言語でブラウザ言語リダイレクトを有効にする必要があります。
以下のコードを使用すると、言語が特定の言語に変更された際に、投稿からホームページへブラウザをリダイレクトできます。
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' );
関連するフック
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