load_script_textdomain()


WordPressのload_script_textdomain()関数は、スクリプトの翻訳ファイルを読み込むために使用されます。JavaScriptファイルの国際化（i18n）をサポートします。

構文

load_script_textdomain( string $handle, string $domain = 'default', string $path = '' );

引数の説明:

  • $handle (string) — 登録済みスクリプトのハンドル名
  • $domain (string) — 翻訳ドメイン。デフォルトは’default’
  • $path (string) — 翻訳ファイルのパス。デフォルトは空

例1: 基本的な翻訳ファイルの読み込み

スクリプト’my-script’の翻訳を読み込む。

load_script_textdomain( 'my-script', 'my-textdomain' );

例2: カスタムパスを指定して翻訳を読み込む

特定のパスから翻訳ファイルを読み込む。

load_script_textdomain( 'custom-script', 'custom-domain', get_template_directory() . '/languages' );

例3: プラグイン内で翻訳を読み込む

プラグインの言語ファイルを読み込む。

load_script_textdomain( 'plugin-script', 'plugin-domain', plugin_dir_path( __FILE__ ) . 'languages' );

例4: デフォルトドメインを使用する

デフォルトの翻訳ドメインを使用する。

load_script_textdomain( 'default-script' );

例5: 子テーマの翻訳を読み込む

子テーマの言語ファイルを読み込む。

load_script_textdomain( 'child-theme-script', 'child-theme', get_stylesheet_directory() . '/languages' );

例6: 複数のスクリプトの翻訳を読み込む

複数のスクリプトの翻訳を一度に読み込む。

load_script_textdomain( 'script-one', 'my-domain' ); load_script_textdomain( 'script-two', 'my-domain' );

例7: 翻訳パスを動的に生成する

動的に生成されたパスを使用する。

load_script_textdomain( 'dynamic-script', 'dynamic-domain', WP_LANG_DIR . '/plugins' );

注意点:

  • スクリプトはあらかじめwp_register_script()またはwp_enqueue_script()で登録されている必要があります
  • 翻訳ファイルは正しい形式(.json)で配置する必要があります
  • パスの指定はサーバーのファイルシステム構造に依存します

関連機能：