load_theme_textdomain:WordPress私的マニュアル

(1.5.0以降)
load_theme_textdomain - テーマ用のMOファイルをロードする

bool load_theme_textdomain( string $domain [ , mixed $path = false ] )

テーマ用の国際化用ファイル（MOファイル）をロードする。

国際化用ファイル（MOファイル）をロードできた場合はtrueを、ロードできなかった場合はfalseを返す。

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

/wp-content/themes/mytheme/ja.mo

パラメータを$pathを指定した場合、そのパス名のディレクトリにあるロケール情報.moファイルがロードされる。例）ドメイン名が'mydomain'、$pathとしてget_template_directory関数の戻り値に'/languages'を追加し、ロケール情報が'ja'の場合

/wp-content/themes/mytheme/languages/mydomain-ja.mo

[4.6.0]従来テーマ内の(ロケール).moファイルよりも/wp-content/languages/themes/（ドメイン名）-(ロケール情報).moファイルが優先されるように変更された。

テーマ内の国際化用ファイル（MOファイル）をロードする。
<?php load_theme_textdomain( 'mydomain' ); ?>
テーマ内の'languages'ディレクトリにある国際化用ファイル（MOファイル）をロードする。
<?php load_theme_textdomain( 'mydomain', get_template_directory().'/languages' ); ?>

[3.0.0]冒頭でロケールを決定するため'theme_locale'フィルターを呼び出す。パラメータ$localeにはサイトのロケール（[4.7.0]$localeがログインしている場合はそのユーザーのロケールを優先）が、$domainには本関数が受け取った内容が格納されている。

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

実行するアクションはありません。

/wp-includes/l10n.php