Як ефективно використовувати редактор wp_editor

У цьому короткому посібнику ми позначимо, навіщо добре підійде wp_editor.

Що таке wp_editor?

Це функція WordPress, яка створює візуальний (WYSIWYG) редактор за типом того, що ви бачите на панелі адміністратора під час створення Записів чи Сторінок. Ця маленька зручна функція доступна, починаючи з WordPress 3.3.

Якщо вам потрібно більше інформації про wp_editor є докладна сторінка на Кодекс. WordPress використовує окрему версію редактора TinyMCE, її можна знайти тут. Щоб переглянути файли, зайдіть у папку wp-includes/js/tinymce у директорії установки WordPress.

Так виглядає стандартний редактор на панелі адміністратора.

Навіщо нам це потрібно?

Для того, щоб використовувати цю можливість також у темах та плагінах! Оформлення контенту може бути зручним у записах. Ми можемо використовувати різні редактори на одній сторінці, просто використовуючи змінні зміст и ID.

Приклади

Ця частина статті має на увазі, що у вас хоча б базові навички PHP програмування. Змінні $ зміст и $editor_id — обов'язкові, вони мають бути встановлені завжди. Змінна $налаштування - масив, в якому можливості редактора можуть бути увімкнені або вимкнені.

Будь ласка, зверніть увагу, що більшість пояснень у коментарях, прочитайте їх.

Наступні фрагменти коду (1, 2, 3 та 4) покажуть, як використовувати функцію.

/**
 * Обязательные переменные
 */
wp_editor( $content, $editor_id );
/**
 * Базовый синтаксис
 */
wp_editor( $content, $editor_id, $settings = array() );
/**
 * 1.
 * Первая переменная установит контент, который будет отображаться блоке,
 * вторая – содержит HTML атрибут редактора id
 * (символы в нижнем регистре без подчеркиваний или дефисов).
 */
wp_editor( 'Hello World! This is our first test! Enjoy!', 'ourmaineditor' );
/**
 * 2.
 * Этот код выводит блок редактора и кнопку Submit.
 * У блока будет 15 строк, квик-теги загружаться не будут.
 * Используется настройка PressThis.
 */
$args = array(
    'textarea_rows' => 15,
    'teeny' => true,
    'quicktags' => false
);
wp_editor( 'This is the default text!', 'editor', $args );
submit_button( 'Save content' );
/**
 * 3.
 * Мы можем пересоздать редактор записи с помощью функции get_post,
 * которая получит существующую запись (в данном случае 117)
 * из базы данных.
 */
$post = get_post( 117, 'OBJECT' );
wp_editor( $post, 'editor' );
/**
 * 4.
 * Пользовательские кнопки для редактора.
 * Это список, разделенный запятой после каждой опции,
 * например link, unlink, bold, ...
 */
$settings = array(
    'textarea_name' => 'content',
    'media_buttons' => false,
    'tinymce' => array(
        'theme_advanced_buttons1' => 'formatselect,|,bold,italic,underline,|,' .
            'bullist,blockquote,|,justifyleft,justifycenter' .
            ',justifyright,justifyfull,|,link,unlink,|' .
            ',spellchecker,wp_fullscreen,wp_adv'
    )
);
wp_editor( '', 'content', $settings );

Налаштування користувача редактора

Ви можете налаштувати можливості редактора за допомогою цього описи з Codex. Щоб покопатися глибше, ви можете також переглянути файл class-wp-editor.php в папці WP-включає в себе із кореневої директорії WordPress.

Джерело:WP.tutsplus.com

Олексій Шевченко

редактор wpcafe

Вивчає сайтобудування з 2008 року. Практикуючий вебмайстер, що спеціалізується на створенні сайтів WordPress. Задати питання Олексію можна на https://profiles.wordpress.org/wpthemeus/