説明
パラメータ
- $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最終更新 : 2023年03月30日 12:40
関連
お勧め
query_posts(WP_Queryクラス)でカテゴリーを絞り込む(2011年9月14日 更新)
久しぶりに query_posts関数を見直してみると、見知らぬパラメータがいくつか追加されていた。気になったのでカテゴリー関係の指定を'tax_query'パラメータを交えて整理してみた。「順序」をtextからnumberに変更してみた(2018年5月27日 更新)
固定ページの編集画面の「投稿の属性」ウィジェットには、ページの並び替えに使用できる「順序」のinput要素がある。この「順序」のinput要素はtype属性が'text'となっており、編集の際にIMEが有効になってしまう場合がある。ページの編集頻度が多くなると、その都度IMEをオフにするのがやや面倒になってくる。
投稿内容のid属性などを保存するための対策(2012年6月15日 更新)
WordPress 3.4にアップデートしたとある環境で投稿記事を保存すると、divタグなどのid属性がクリアされて保存するようになった(id属性が保存できなくなった)。ここでは、その対策方法の1つを紹介しておく。oEmbedについて考えてみた(2018年5月27日 更新)
本サイト向けにテーマをリニューアルしようと思い一から作っている最中、ふと生成されているHTMLの中にあるoEmbedの記述が目についた。「この記述いつからだっけ」くらいに思いながらリンク先を開き、ちょっとモヤモヤしてしまった。
Google Mapsブロックを作る過程で悩んだ件(2022年8月23日 更新)
自分なりのGoogle Mapsブロックを作るべく、カスタムHTMLブロックをベースにいくつかのパラメータ要素をサイドバーに追加していく。Google Maps用のAPIキーについてはオプションデータ(wp_optionsテーブル)に格納して利用していこうと思ったのだが、その方法がさっぱりわからなかった。