概要
load_script_translations 関数は、JavaScript向け翻訳ファイルを読み込むための機能を提供します。この関数は、特に WordPress プラグインやテーマの開発において、ユーザーインターフェースを多言語化する際に役立ちます。以下のような場面でよく使用されます。
- プラグインの管理画面の翻訳を適用する
- フロントエンドのインターフェースに翻訳を追加する
- カスタムテーマのスクリプトの翻訳を管理する
- 多言語サイト用のスクリプトの国際化
- JavaScriptでのエラーメッセージの翻訳をサポート
- AJAXリクエストに関連するメッセージの翻訳を取得
- ページの動的コンテンツに翻訳を適用
- 開発者向けのカスタムフィルターやアクションの翻訳を実装する
構文
load_script_translations( $handle, $domain, $plugin_dir );
パラメータ
$handle(string) – スクリプトのハンドル名。$domain(string) – テキストドメイン名。$plugin_dir(string) – プラグインのディレクトリパス（オプション）。
戻り値
- (bool) – 翻訳ファイルがロードされた場合は true、そうでない場合は false を返す。
関連する関数
使用可能なバージョン
- WordPress 4.8.0 以降
コアファイルのパス
wp-includes/script-loader.php
この関数のアクションでの使用可能性
| アクション | 使用例 |
|---|---|
| mu_plugin_loaded | |
| registered_post_type | |
| plugins_loaded | 〇 |
| wp_roles_init | |
| setup_theme | |
| after_setup_theme | |
| set_current_user | |
| init | |
| register_sidebar | |
| wp_loaded | |
| send_headers | |
| parse_query | |
| pre_get_posts | |
| wp | |
| template_redirect | |
| get_header | |
| wp_head |
この関数は、特定のWordPressバージョンで非推奨または削除されていません。