mce_css │ хук-фильтр │ WP 2.1.0

Предоставляет возможность добавить произвольные стили CSS (CSS-файл) для визуального редактора WordPress TinyMCE.

Функция передаёт параметр $mce_css, в котором через запятую указываются URL-адреса CSS-файлов.

Кроме файла .css можно указать URL-адрес файла .php, когда нужно динамически создавать стили.

Этот хук следует применять при написании плагина. Если вам нужно добавить файл стилей из темы, то используйте специальную функцию add_editor_style().

Использование

add_filter( 'mce_css', 'wp_kama_mce_css_filter' );

/**
 * Function for `mce_css` filter-hook.
 * 
 * @param string $stylesheets Comma-delimited list of stylesheets.
 *
 * @return string
 */
function wp_kama_mce_css_filter( $stylesheets ){

	// filter...
	return $stylesheets;
}

$mce_css(строка)

URL-адреса CSS-файлов, разделённые запятыми.

Примеры

#1 Подключение шрифта от Google

Так как mce_css — это строка URL-адресов, разделённых запятыми, в добавляемом URL-адресе запятых быть не должно. Но они есть в ссылке на шрифт от Google, когда подключаются несколько типов одного шрифта, например: 'http://fonts.googleapis.com/css?family=Lato:300,400,700'. Чтобы подключить эту ссылку, нужно кодировать URL-адрес или заменить запятые на знак "%2с":

add_filter( 'mce_css', 'plugin_mce_css' );
function plugin_mce_css( $mce_css ) {
	if ( ! empty( $mce_css ) ) $mce_css .= ',';

	$font_url = 'http://fonts.googleapis.com/css?family=Lato:300,400,700';
	// $mce_css .= urlencode( $font_url ); // или следующая строка
	$mce_css .= str_replace( ',', '%2C', $font_url );

	return $mce_css;
}