get_locale() の使い方|説明・引数・注意点

説明

get_locale() は、現在のサイトの言語(ロケール)を返す関数です。

基本構文

get_locale(): string

引数

引数はありません。

戻り値

ロケール(例:ja)。

使い方(サンプル)

if ( 'ja' === get_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

コメント

タイトルとURLをコピーしました