説明
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
関連
お勧め
初期化に関連するアクションのおさらい（2013年11月27日 更新）
いつも何気なくfunctions.phpで使っているafter_setup_themeアクションやinitアクション。普段はあまり意識していなかったが、ふとしたことからどんな順番に呼び出されるのか気になってしまい、ちょっと調べてみた。WP_List_Tableクラスを使ってみた（2018年5月27日 更新）
WordPressの管理画面ではデータを一覧表示しているページがいくつもある。今回この仕組みを自分のプラグインでも使ってみたいと思い、調査しながらプラグインに組み込んでみた。
投稿ページでユニークなテンプレートを選択しよう（2018年5月27日 更新）
4.7の変更点に「投稿タイプテンプレート」がある。これは従来固定ページ（'page'）向けに任意のテンプレートを適用できる機能が拡張されたもので、投稿ページ（'post'）はもちろんカスタム投稿タイプのページにも適用可能になっている。
常時SSL接続に変更しました（2018年5月27日 更新）
先週末、本サイトを常時SSL接続に変更しました。本サイトは「さくらのVPS」（CentOS 6系、Apache 2.2系）上にWordPressのマルチサイト機能を使って構築しており、無償で使用できる「Let's Encrypt」を使って常時SSL接続に切り替えた手順をメモとして残しそうと思います。
テキストエディタの文字を変更する（2018年5月27日 更新）
テキストエディタ（投稿ページの「テキスト」タブのエディタ）に標準では備わっていない機能を追加する自作プラグイン「html entities button」がほぼ1年ぶりにアップデート。ここではバージョン2.0.0で追加したテキストエディタのフォント切り替え機能について紹介する。