wp_set_script_translations

パラメータ

• $handle
  JavaScriptのハンドル名を指定。
• $domain
  ドメイン名を指定（[5.1.0]省略時'default'）。
• $path
  翻訳ファイル（.json）があるディレクトリのフルパス名を指定（省略時null）。

返り値

翻訳ファイル情報を設定できた場合はtrueを返す。設定できなかった場合はfalseを返す。

注意

本関数はテーマやプラグインのJavaScriptファイル向けの翻訳ファイルを設定する。この関数は情報の設定だけであり、翻訳ファイルの読み込みは load_script_textdomain関数が行う。JavaScript向け翻訳ファイルのファイル名は、「ドメイン名-ロケール名-ハンドル名.json」か「ドメイン名-ロケール名-md5ハッシュ値.json」となる（md5ハッシュ値は対象のJavaScriptファイルのパス名の一部から生成）。

[5.1.0]第2パラメータ$domainが省略可能になった。

使用例

• プラグイン内のJavaScript向け翻訳ファイルを設定する。

  <?php wp_set_script_translations( 'myplugin-script', 'myplugin-domain', dirname( __FILE__ ) . '/languages' ); ?>

• プラグイン内のJavaScript向け翻訳ファイルを設定する。

  <?php
  $block_json = json_decode( file_get_contents( dirname( __FILE__ ) . '/build/blocks/myblock/block.json' ) );
  $script_handle = generate_block_asset_handle( $block_json->name, 'editorScript' );
  wp_set_script_translations( $script_handle, 'myplugin-domain', dirname( __FILE__ ) . '/languages' );
  ?>

フィルター

アクション

ソースファイル