load_plugin_textdomain

パラメータ

• $domain
  ドメイン名を指定。
• $abs_rel_path $deprecated
  2.7以降は使用が推奨されておらず、falseを指定。
• $plugin_rel_path
  プラグインの相対パス名（プラグインのディレクトリ名など）を指定（省略時はfalse）。

返り値

注意

ドメイン名は、__関数や_e関数といった翻訳テキストを使用する際のパラメータとして指定する。
パラメータを$plugin_rel_pathを省略した場合、プラグインディレクトリにあるドメイン名-ロケール情報.moファイルがロードされる。例）ドメイン名が'mydomain'、ロケール情報が'ja'の場合

パラメータを$plugin_rel_pathを指定した場合、自プラグインにあるドメイン名-ロケール情報.moファイルがロードされる。例）ドメイン名が'mydomain'、プラグインの相対パス名が'myplugin'、ロケール情報が'ja'の場合

[4.6.0]国際化用ファイルをロードするディレクトリの優先度が変更になり、パラメータ$plugin_rel_pathよりも定数WP_LANG_DIR（標準では/wp-content/languages/）の示すディレクトリが優先されるようになった。プラグインのバージョンアップ直後などは、新しいプラグインの国際化用ファイルが読み込まれないケースがあるかもしれない。なお国際化用ファイルがWP_LANG_DIRが示すディレクトリ（プラグインであれば/wp-content/languages/plugins）以下にある環境で__関数や_e関数などの翻訳テキストを取得する関数が呼ばれた場合、国際化用ファイルがロードされていない場合は自動的にロードされるため、本関数を使用する必要はない。

[4.7.0]管理者ページの言語がサイトの言語設定よりユーザの言語設定が優先されるように仕様が変更され、'plugin_locale'フィルターの第1パラメータ$localeの内容はリクエストが管理者ページの場合には get_user_locale関数で取得できるユーザの言語が適用される。ここで注意しなければならないのが本関数を呼び出すタイミングである。プラグインがロードされたタイミングでは、 wp_get_current_user関数を定義しているwp-includes/pluggable.phpがロードされていないため、ログインしているユーザの言語設定を取得できず、サイトの言語設定が適用されてしまう。正しくユーザの言語設定にするためには、'admin_menu'アクションなどの実際に翻訳テキストを使用する直前で本関数を呼び出さなければならない。

[6.7.0]翻訳データのロードは、本関数の実行時からジャスト・イン・タイムローディング機構（翻訳テキストがはじめて要求された時）へ切り替わった。

使用例

• プラグインの国際化用ファイル（MOファイル）をロードする。
  <?php load_plugin_textdomain( 'mydomain' ); ?>
• プラグインのプラグインディレクトリ内の国際化用ファイル（MOファイル）をロードする。
  <?php load_plugin_textdomain( 'mydomain', false, basename( __DIR__ ) . '/languages' ); ?>

フィルター

$locale = apply_filters( 'plugin_locale', $locale, $domain );

アクション

ソースファイル