Можно ли добавить пользовательский формат в панель форматирования текста?

В "классическом" редакторе TinyMCE есть два выпадающих списка: formatselect для стилей абзацев и styleselect для стилей символов — которые также могут содержать стили абзацев, что может вызвать путаницу. По умолчанию в WordPress отображается только выпадающий список формата. Если применить пользовательскую таблицу стилей к редактору, TinyMCE может использовать её для извлечения классов и добавления их в выпадающий список стилей — но у меня это срабатывало не всегда.

Начиная с версии 3.0, вы можете вызвать add_editor_style() в вашем functions.php, чтобы добавить таблицу стилей в редактор. По умолчанию используется файл editor-style.css в директории вашей темы. До версии 3.0 необходимо было использовать фильтр mce_css, чтобы добавить URL вашей таблицы стилей редактора. В итоге это попадает в значение конфигурации TinyMCE content_css.

Чтобы добавить выпадающий список стилей, опция styleselect должна быть указана в одном из массивов конфигурации панели кнопок (theme_advanced_buttons[1-4] в TinyMCE, фильтруемый через mce_buttons_[1-4] в WordPress). Список форматов блоков управляется опцией TinyMCE theme_advanced_blockformats, которую можно добавить в массив управления через фильтр tiny_mce_before_init. Если вы хотите настроить названия в выпадающем списке стилей (а не только имена CSS-классов), обратите внимание на опцию theme_advanced_styles. Также можно использовать более продвинутую опцию style_formats, которая предоставляет больше гибкости в определении стилей.

Соответствующий PHP-код со всеми хуками и конфигурацией по умолчанию находится в wp-admin/includes/post.php, в функции wp_tiny_mce(). В целом, ваша настройка может выглядеть так:

add_action( 'after_setup_theme', 'wpse3882_after_setup_theme' );
function wpse3882_after_setup_theme()
{
    add_editor_style();
}

add_filter('mce_buttons_2', 'wpse3882_mce_buttons_2');
function wpse3882_mce_buttons_2($buttons)
{
    array_unshift($buttons, 'styleselect');
    return $buttons;
}

add_filter('tiny_mce_before_init', 'wpse3882_tiny_mce_before_init');
function wpse3882_tiny_mce_before_init($settings)
{
    $settings['theme_advanced_blockformats'] = 'p,h1,h2,h3,h4';

    // Взято с http://tinymce.moxiecode.com/examples/example_24.php
    $style_formats = array(
        array('title' => 'Жирный текст', 'inline' => 'b'),
        array('title' => 'Красный текст', 'inline' => 'span', 'styles' => array('color' => '#ff0000')),
        array('title' => 'Красный заголовок', 'block' => 'h1', 'styles' => array('color' => '#ff0000')),
        array('title' => 'Пример 1', 'inline' => 'span', 'classes' => 'example1'),
        array('title' => 'Пример 2', 'inline' => 'span', 'classes' => 'example2'),
        array('title' => 'Стили таблицы'),
        array('title' => 'Строка таблицы 1', 'selector' => 'tr', 'classes' => 'tablerow1'),
    );
    // До версии 3.1 требовался специальный трюк для передачи этого массива в конфигурацию.
    // Смотрите историю изменений этого поста для предыдущих версий.
    $settings['style_formats'] = json_encode( $style_formats );

    return $settings;
}