説明
bool switch_to_locale( string $locale )
ロケールを切り替える。
パラメータ
- $locale'ja'、'en_US'、'fr_FR'などのロケールを指定。
返り値
ロケールを切り替えできた場合はtrueを、切り替えできなかった場合はfalseを返す。
注意
ロケールの切り替えにより、ページの途中で翻訳内容を変更できる。切り替え前のロケールに戻す場合は restore_previous_locale関数を使用する。
日本語環境において英語、フランス語の順に切り替えながら'English'の翻訳を出力してみる。
var_dump( __( 'English' ) );
switch_to_locale( 'en_US' ); // 日本語から英語へ
var_dump( __( 'English' ) );
switch_to_locale( 'fr_FR' ); // 英語からフランス語へ
var_dump( __( 'English' ) );
restore_previous_locale(); // フランス語から英語へ
var_dump( __( 'English' ) );
restore_previous_locale(); // 英語から日本語へ
var_dump( __( 'English' ) );
上記コードの実行結果は次の通り。
string(6) "英語"
string(7) "English"
string(7) "Anglais"
string(7) "English"
string(6) "英語"
使用例
- ロケールを'en_US'へ切り替える。
<?php switch_to_locale( 'en_US' ); ?>
フィルター
実行するフィルターはありません。アクション
実行するアクションはありません。ソースファイル
/wp-includes/l10n.php最終更新 : 2018年11月21日 16:23
関連
お勧め
query_posts（WP_Queryクラス）でカテゴリーを絞り込む（2011年9月14日 更新）
久しぶりに query_posts関数を見直してみると、見知らぬパラメータがいくつか追加されていた。気になったのでカテゴリー関係の指定を'tax_query'パラメータを交えて整理してみた。the_date関数で投稿日を確実に表示する（2011年12月20日 更新）
投稿記事の投稿日時を表示する際、 the_date関数を使用することが多いだろう。このthe_date関数はphpのdate関数と同じパラメータを指定することで、好みの日時フォーマットで投稿日時を表示できるのだが、ある条件の場合に投稿日時を表示しない。最初にこの現象に遭遇したときは、ちょっと悩まされた。スクリプトファイルのバージョンパラメータを変更する（2018年5月27日 更新）
Java Scriptやスタイルシートの指定を直接head要素内に記述せず、wp_enqueue_scriptsフィルターなどを使って指定する場合、WordPressのバージョン番号が付与されている。このバージョン番号は、妥当なんだろうか。
ログアウト後はいつもサイトトップ（2018年5月27日 更新）
ログアウト後に表示（リダイレクト）されるページは、標準ではログインページ（wp-login.php）である。4.2.0ではログアウト処理後のページリダイレクト前に呼び出されるフィルターが追加された。
カレンダーウィジェットをAjaxで切り替える（2011年8月22日 更新）
ウィジェットベースでテーマを構築していてカレンダーを表示してみた。標準では、前月や次月のリンク先はそれぞれの月のアーカイブページとなっているのだが、記事を探すだけであればカレンダー部分だけを更新するほうが便利なのではと考え、そのアイデアを実装してみた。