mce_external_plugins │ filter-hook │ WP 2.5.0

Filters the list of TinyMCE external plugins.

The filter takes an associative array of external plugins for TinyMCE in the form 'plugin_name' => 'url'.

The url should be absolute, and should include the js filename to be loaded. For example: 'myplugin' => 'http://mysite.com/wp-content/plugins/myfolder/mce_plugin.js'.

If the external plugin adds a button, it should be added with one of the mce_buttons

Usage

add_filter( 'mce_external_plugins', 'wp_kama_mce_external_plugins_filter', 10, 2 );

/**
 * Function for `mce_external_plugins` filter-hook.
 * 
 * @param array  $external_plugins An array of external TinyMCE plugins.
 * @param string $editor_id        Unique editor identifier, e.g. 'content'. Accepts 'classic-block' when called from block editor's Classic block.
 *
 * @return array
 */
function wp_kama_mce_external_plugins_filter( $external_plugins, $editor_id ){

	// filter...
	return $external_plugins;
}

$external_plugins(array)

An array of external TinyMCE plugins.

$editor_id(string)

Unique editor identifier, e.g. 'content'. Accepts 'classic-block' when called from block editor's Classic block.

Changelog

Where the hook is called

$mce_external_plugins = apply_filters( 'mce_external_plugins', array(), $editor_id );

$external_plugins = apply_filters( 'mce_external_plugins', array(), 'classic-block' );

Where the hook is used in WordPress