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

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

Функция передает параметр $mce_css, в котором через запятую указываются УРЛы к css файлам.

Кроме файла .css можно указать УРЛ к файлу .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(строка)
УРЛы на css файлы, разделенные запятыми.

Примеры

1

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

Так как mce_css - это строка УРЛов, разделенных запятыми, в добавляемом УРЛ запятых быть не должно. Но они есть в ссылке на шрифт от Google, когда подключаются несколько типов одного шрифта, пр: 'http://fonts.googleapis.com/css?family=Lato:300,400,700'. Чтобы подключить эту ссылку, нужно кодировать УРЛ или заменить запятые на знак "%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;
}

Список изменений

С версии 2.1.0 Введена.

Где вызывается хук

_WP_Editors::editor_settings()
mce_css
wp-includes/class-wp-editor.php 600
$mce_css = trim( apply_filters( 'mce_css', $mce_css ), ' ,' );

Где используется хук в WordPress

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