wp_register_tinymce_scripts()


WordPressのwp_register_tinymce_scripts()関数は、TinyMCEエディタにカスタムスクリプトを登録するために使用されます。プラグインやテーマでTinyMCEの機能を拡張する際に利用します。

構文

wp_register_tinymce_scripts( string $handle, string $src, array $deps = array(), string|bool|null $ver = false, array|bool $args = array() );

引数の説明:

  • $handle(string)—スクリプトの識別子。
  • $src(string)—スクリプトのURL。
  • $deps(array)—依存スクリプトの配列。
  • $ver(string|bool|null)—バージョン番号。
  • $args(array|bool)—追加の引数。

例1: 基本的なTinyMCEスクリプトの登録

カスタムスクリプトをTinyMCEに登録します。

wp_register_tinymce_scripts('custom-tinymce-script', get_template_directory_uri() . '/js/custom-tinymce.js');

例2: 依存関係を指定して登録

jQueryに依存するスクリプトを登録します。

wp_register_tinymce_scripts('tinymce-dep-script', plugins_url('js/editor.js', __FILE__), array('jquery'));

例3: バージョン番号を指定

スクリプトにバージョン番号を追加します。

wp_register_tinymce_scripts('versioned-script', get_stylesheet_directory_uri() . '/js/versioned.js', array(), '1.0.0');

例4: インラインスクリプトの登録

インラインスクリプトをTinyMCEに追加します。

wp_register_tinymce_scripts('inline-script', '', array(), false, array('in_footer' => true));

例5: 複数のスクリプトを一度に登録

複数のスクリプトをループで登録します。

$scripts = array('script1' => '/js/one.js', 'script2' => '/js/two.js'); foreach($scripts as $handle => $src) { wp_register_tinymce_scripts($handle, $src); }

例6: 条件付きでスクリプトを登録

特定の条件下でのみスクリプトを登録します。

if(is_admin()) { wp_register_tinymce_scripts('admin-only-script', get_template_directory_uri() . '/js/admin.js'); }

例7: 翻訳ファイルを読み込むスクリプト

翻訳ファイルをサポートするスクリプトを登録します。

wp_register_tinymce_scripts('i18n-script', get_template_directory_uri() . '/js/i18n.js', array(), false, array('in_footer' => true, 'textdomain' => 'my-textdomain'));

注意点

  • この関数はadmin_enqueue_scriptsフック内で使用する必要があります。
  • スクリプトの依存関係を正しく指定しないとエラーが発生する可能性があります。
  • TinyMCEのバージョン互換性に注意してください。

関連機能：