説明
get_locale() は、現在のサイトの言語(ロケール)を返す関数です。
基本構文
get_locale(): string
引数
引数はありません。
戻り値
ロケール(例:ja)。
使い方(サンプル)
if ( 'ja' === get_locale() ) {
// 日本語向けの処理
}
注意点
- 管理画面の言語とは別です。管理画面側は
get_user_locale()。
実務での使いどころ
- サイトの言語(
jaなど)を、取得するとき。 - 言語ごとに、読み込むファイルや、処理を、切り替えるとき。
よくあるミスと対処
- ログイン中のユーザーの言語だと、考えている。サイトの言語を返す。ユーザーごとの言語は、
get_user_locale()。 - 言語コードの形式を、決め打ちしている(
ja、en_USなど)。
NG例
if ( 'ja_JP' === get_locale() ) { // 日本語のロケールは、ja
// ...
}
OK例
if ( 'ja' === get_locale() ) {
// 日本語
}
使い分け早見表
| 関数 | 取得するもの |
|---|---|
get_locale() |
サイトの言語 |
get_user_locale() |
ユーザーの言語 |
load_theme_textdomain() |
テーマの翻訳を読み込む |
関連項目
determine_locale()、get_user_locale()、load_theme_textdomain()
公式リファレンス:get_locale() | Function | WordPress Developer Resources

コメント