mce_css
Предоставляет возможность добавить произвольные 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 Подключение шрифта от 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 | Введена. |
Где вызывается хук
$mce_css = trim( apply_filters( 'mce_css', $mce_css ), ' ,' );