WordPress. Добавление кнопок в HTML-редактор

Добавление кнопок на панель инструментов текстового (HTML) редактора WordPress с помощью Quicktags API. Для пользователей плагина «Classic Editor».

Оператор QTags.addButton

Quicktags API позволяет добавлять новые кнопки на панель инструментов текстового (HTML) редактора WordPress. После внедрения в WordPress блочного редактора Gutenberg, HTML-редактор в классическом стиле стал доступен только при активированном плагине «Classic Editor».

Для создания дополнительных кнопок используется оператор QTags.addButton:

Параметры оператора QTags.addButton:

Параметр Описание
id Обязательный параметр. Уникальный идентификатор кнопки.
display Обязательный параметр. Название кнопки, отображаемое на панели инструментов (на кнопке).
arg1 Обязательный параметр. Открывающий тег (произвольная строка), который будет вставляться при нажатии кнопки слева от курсора или выделения.
arg2 Необязательный параметр. Закрывающий тег (произвольная строка), который будет вставляться при нажатии кнопки справа от курсора или выделения.
access_key Необязательный параметр. Клавиша быстрого доступа для кнопки.
title Необязательный параметр. Заголовок, который будет отображаться при наведении на кнопку курсора.
priority Необязательный параметр. Число, задающее желаемое положение кнопки на панели инструментов: 1-9 = первое место, 11-19 = второе место, 21-29 = третье место и т. д.
instance Необязательный параметр. Задает конкретный экземпляр класса Quicktags, в который следует поместить кнопку.

Если параметр priority не указан, дополнительные кнопки будут добавлены после кнопок по умолчанию и в порядке, соответствующем порядку следования строк с оператором QTags.addButton, создающих их.

Добавление кнопок в HTML-редактор

Пример добавления кнопок, вставляющих горизонтальную линию, кавычки «Ёлочки», теги заголовков h2, h3, h4 и h5:

Данный код вставляется в файл functions.php дочерней темы.

Перед объявлением функции appthemes_add_quicktags нет открывающего тега <?php, так как обычно он уже есть выше. Закрывающий тег ?> в конце файлов .php не ставится, так как любой случайно введенный символ после закрывающего тега, например, перевод строки, приведет к неработоспособности сайта.

Скриншот файла functions.php с кодом добавления новых кнопок на панель инструментов текстового редактора WordPress:

Скриншот панели инструментов HTML-редактора WordPress с добавленными кнопками при активированном плагине «Classic Editor»:


Другие статьи:
WordPress. Изображение от размера экрана
WordPress. Создание рекламных баннеров
WordPress. Заголовки безопасности (security headers)
WordPress. Admitad Teleport Script (установка на сайт)

Наши сайты размещены на виртуальном хостинге от провайдеров Beget и Timeweb.

Добавить комментарий

Ваш комментарий будет опубликован после прохождения обязательной модерации. Исходящие ссылки не допускаются. Время модерации составит от нескольких минут до нескольких часов в зависимости от времени суток и занятости модератора.