説明
string|false load_script_textdomain( string $handle [ , string $domain = 'default' [ , string $path = null ] ] )
JavaScript向け翻訳ファイルを読み込む。
パラメータ
- $handleJavaScriptのハンドル名を指定。
- $domainドメイン名を指定（[5.1.0]省略時'default'）。
- $path翻訳ファイル（.json）があるディレクトリのフルパス名を指定（省略時null）。
返り値
翻訳ファイルが見つかった場合はその内容を返す。見つからなかった場合はfalseを返す。
注意
本関数はテーマやプラグインが wp_set_script_translations関数を使用した場合に呼び出される。JavaScript向け翻訳ファイルのファイル名は、「ドメイン名-ロケール名-ハンドル名.json」か「ドメイン名-ロケール名-md5ハッシュ値.json」となる（md5ハッシュ値は対象のJavaScriptファイルのパス名の一部から生成）。
[5.0.2]'script_loader_src'フィルターがなくなり、'load_script_textdomain_relative_path'フィルターが追加された。また翻訳ファイルの読み込みは load_script_translations関数が使用されるように変更された。
[5.1.0]第2パラメータ$domainが省略可能になった。
使用例
- プラグイン内のJavaScript向け翻訳ファイルを読み込む。
<?php $content = load_script_textdomain( 'myplugin-script', 'myplugin-domain', dirname( __FILE__ ) . '/languages' ); ?>
フィルター
[5.0.2]JavaScriptファイルの相対パス名を確定したら'load_script_textdomain_relative_path'フィルターを呼び出す。パラメータ$relativeにはJavaScriptファイルの相対パス名が、$srcにはJavaScriptファイルのURLが格納されている。$relative = apply_filters( 'load_script_textdomain_relative_path', $relative, $src );$src = esc_url( apply_filters( 'script_loader_src', $src, $handle ) );アクション
実行するアクションはありません。ソースファイル
/wp-includes/l10n.php最終更新 : 2019年02月26日 10:18
関連
お勧め
フィードにサムネイル画像を追加する（2022年11月7日 更新）
WordPressが出力するの標準のフィードには、各投稿のサムネイル画像の情報が含まれていない。ネットで検索してみるといくつかの方法があることがわかったので、その中から2つ試してみた。
ダッシュボードの「クイックドラフト」を「CodeMirror」に変更してみた（2019年11月5日 更新）
管理ページの「テーマエディター」では4.9以降「CodeMirror」が利用されている。今回はこの「CodeMirror」をプラグインで活用できないか調べた話である。
スマートフォン向けの振り分けを自前で行う（2012年1月23日 更新）
PC向けのサイトをスマートフォン対応する場合、WPtouchやktai styleに代表されるスマートフォン対応のテンプレート切り替えプラグインを使用するのが一般的。そういったプラグインはテンプレート切り替え以外の機能も備えており、そういった機能は必ずしも必要ではない。そんなわけで、ここでは超シンプルなスマートフォン向けのテンプレート切り替えを実現する方法を紹介する。ブロックエディターの文字サイズ設定を変えてみる（2019年12月12日 更新）
今回は「前回投稿した内容」の続きブロックエディターの文字サイズ設定を変えようと思う。参考にするテーマはもちろん「Twenty Twenty」である。
5.5の機能強化：コメントフォームのちょっとした改良（2020年8月12日 更新）
来月にリリースされるWordPress 5.5に向けてBeta 1、2、3と公開が続いている。「WordPress 5.5 Beta 3（以降Beta 3）」のソースコードを見ていくと、コメントフォームを表示する comment_form関数が機能拡張されていた。