Как добавить JavaScript на страницы и записи WordPress
разбирает способы подключения скриптов и функции управления ими. Подходит, когда задача связана с поведением уже существующего интерфейса.
Читать материалВыбирайте способ расширения WordPress по результату: JavaScript меняет поведение страницы, SVG решает задачу векторной графики, собственный блок создаёт повторно используемый элемент редактора. Это разные уровни. Перед разработкой опишите одно действие посетителя или автора, которое должно стать возможным после изменения.
Выберите инструкцию под свою задачу. Ниже — подробный разбор выбора и проверки результата.
разбирает способы подключения скриптов и функции управления ими. Подходит, когда задача связана с поведением уже существующего интерфейса.
Читать материалобъясняет свойства векторного формата и способы его внедрения. Применяйте для графики, не предполагая, что смена формата сама по себе улучшит любую иллюстрацию.
Читать материалмаршрут для повторяющегося элемента редактора. Выбирайте его, если авторам нужен понятный способ создавать и настраивать такой элемент в разных публикациях.
Читать материалЕсли элемент должен повторяться, дайте редактору короткий пример правильного заполнения. Он помогает проверить, достаточно ли предусмотренных полей и не приходится ли каждый раз вручную исправлять разметку после сохранения. Именно это наблюдение может стать основанием для отдельного блока.
| Задача | Подход | Где проверять |
|---|---|---|
| Реакция на действие посетителя | JavaScript | На нужной странице в браузере |
| Масштабируемая иконка или иллюстрация | SVG | В местах вывода изображения |
| Элемент, который редактор настраивает многократно | Собственный блок | В редакторе и на опубликованной странице |
Например, раскрывающийся раздел относится к поведению, логотип — к графике, а карточка с обязательными полями и управляемыми настройками может стать задачей собственного блока. Один компонент иногда включает все три части. Но начинать полезно с главной потребности, чтобы не создавать новый инструмент редактирования ради единственной картинки.
Запишите область действия: одна запись, определённый тип страниц или весь сайт. Чем шире область, тем больше контрольных страниц понадобится. Если изменение нужно только одному материалу, подключение без различения страниц может создать лишнюю зависимость в остальных местах. Этот вопрос решается до выбора конкретной библиотеки.
Для скрипта запишите событие и ожидаемый результат. Для изображения — где оно используется и какое представление должно сохраняться при изменении размера. Для блока — обязательные поля, доступные настройки и вид после сохранения. Это небольшое описание позволяет сравнить реализацию с задачей, а не только с внешним впечатлением.
Собственный блок особенно требует проверки авторского сценария. Разработчик знает, какие поля нужно заполнить, а редактор может оставить поле пустым или вставить длинный текст. Включите эти случаи в контрольный пример. Сохранение без ошибки ещё не доказывает, что компонент будет понятно работать с реальным содержимым.
Разрабатывайте изменение на проверочной копии и сохраняйте исходную редакцию. После этого можно отдельно принять функцию и область её действия: нужный элемент работает, а страницы без него продолжают открываться ожидаемо. Такая проверка помогает обнаружить слишком широкое подключение или зависимость от конкретной разметки.
Начните с наименьшего изменения, которое закрывает задачу и проходит эти проверки. К разработке собственного блока стоит переходить ради повторяемого авторского действия, а не только ради возможности добавить ещё один тип элемента в редактор.