Если нужно изменить поведение темы или плагина в WordPress, но не хочется править ядро и терять изменения после обновления, почти всегда стоит начинать с хуков. Это встроенный механизм, через который WordPress и плагины «отдают точки входа» для вашего кода. С его помощью можно добавить текст, убрать лишний элемент, изменить заголовок, подменить ссылку или подключить свою логику в нужный момент.
У хуков есть два основных типа: actions и filters. Разница простая: action запускает ваш код в определённый момент, а filter даёт возможность изменить значение и вернуть его обратно. Ниже разберём, как это работает на практике, где писать код и как не сломать сайт.
Что такое хуки WordPress и зачем они нужны
Хуки — это точки, в которые WordPress «встраивает» внешний код. Разработчик темы или плагина заранее добавляет в код вызов вроде do_action() или apply_filters(), а вы подключаете свою функцию через add_action() или add_filter().
Это удобнее, чем править исходные файлы по трём причинам:
- обновление темы или плагина не затрёт ваши изменения;
- код можно отключить, просто убрав подключение;
- логика остаётся локальной и понятной, без переписывания чужих файлов.
На практике хуки чаще всего используют для таких задач:
- добавить текст или блок в шаблон;
- изменить вывод заголовка, ссылки, атрибута, класса CSS;
- подключить скрипт или стиль в нужный момент;
- убрать стандартное действие темы или плагина;
- изменить данные перед выводом или сохранением.
Чем action отличается от filter
Путаница между ними — самая частая проблема у тех, кто только начинает работать с хуками.
| Тип | Что делает | Что нужно вернуть | Пример задачи |
|---|---|---|---|
action | Запускает код в нужный момент | Ничего не возвращает | Подключить CSS, вывести уведомление, добавить блок |
filter | Передаёт значение в вашу функцию для изменения | Нужно вернуть изменённое значение | Изменить текст, заголовок, ссылку, класс |
Если коротко: action — «сделай что-то», filter — «измени это значение и верни обратно».
Куда добавлять свой код
Самый безопасный вариант — дочерняя тема или собственный небольшой плагин. Если вы добавите код прямо в файлы родительской темы, он исчезнет после обновления.
Для простых правок часто используют файл functions.php дочерней темы. Это нормально, если вы понимаете, что делаете и у вас есть резервная копия. Для более объёмной логики лучше вынести код в отдельный плагин, чтобы он не зависел от темы.
Если вы редактируете сайт на рабочем сервере, сначала проверьте изменения на тестовой копии. Ошибка в PHP-коде может привести к белому экрану или недоступности сайта.
Как добавить action: простой пример
Допустим, нужно вывести короткое сообщение после основного содержимого записи. Для этого можно использовать action, который срабатывает в шаблоне в нужной точке. Один из распространённых вариантов в теме — хук the_content не подходит, потому что это filter, а для вывода дополнительного блока удобнее использовать собственный action, если он предусмотрен темой. Но для примера возьмём стандартный action WordPress wp_footer, который срабатывает перед закрывающим тегом </body>.
Код можно добавить в functions.php дочерней темы:
add_action( 'wp_footer', 'wpfront_add_footer_note' );
function wpfront_add_footer_note() {
echo '<div class="site-note" style="text-align:center;padding:12px 0;">Спасибо, что читаете наш сайт!</div>';
}Что здесь происходит:
add_action()подключает вашу функцию к хукуwp_footer;wpfront_add_footer_note()выводит HTML прямо в футер;echoнужен, потому что action не возвращает значение, а просто выполняет код.
Проверить результат можно в исходном коде страницы или внизу сайта: блок должен появиться перед закрытием </body>.
Как использовать filter: изменить текст без правки шаблона
Теперь пример, где нужно изменить значение. Допустим, вы хотите заменить стандартный текст «Читать далее» на более понятный вариант. Для этого подходит filter excerpt_more, который влияет на окончание автоматического анонса записи.
Добавьте такой код:
add_filter( 'excerpt_more', 'wpfront_change_excerpt_more' );
function wpfront_change_excerpt_more( $more ) {
return '...';
}Здесь функция получает текущее значение $more, а затем возвращает новое. Если не вернуть значение, фильтр сломает вывод или оставит пустой результат.
Другой полезный пример — изменить заголовок сайта в браузерной вкладке через фильтр document_title_parts. Это уже зависит от темы и версии WordPress, но сам принцип тот же: вы получаете массив частей заголовка, меняете нужный элемент и возвращаете массив обратно.
add_filter( 'document_title_parts', 'wpfront_change_title_part' );
function wpfront_change_title_part( $title ) {
if ( ! is_admin() ) {
$title['site'] = 'Мой сайт';
}
return $title;
}Здесь важно вернуть весь массив $title, а не только изменённую часть.
Как понять, какой хук использовать
Если вы не уверены, нужен action или filter, смотрите на сам хук и на то, что ожидает WordPress:
- если в коде есть
do_action( 'hook_name' ), это action; - если есть
apply_filters( 'hook_name', $value ), это filter.
Когда работаете с темой или плагином, ищите эти вызовы в файлах шаблона или в документации разработчика. Если хук уже предусмотрен, лучше использовать его, чем придумывать обходной путь через правку шаблона.
Ещё один практический ориентир: если ваша функция должна что-то вывести в конкретном месте страницы, чаще нужен action. Если задача — изменить готовое значение, нужен filter.
Как убрать стандартное действие или фильтр
Иногда нужно не добавить, а отключить поведение темы или плагина. Для этого используют remove_action() и remove_filter(). Это полезно, когда разработчик уже повесил нужную функцию на хук, а вам нужно заменить её своей.
Пример: если тема выводит лишний блок в футере, можно снять его через remove_action(). Но для этого нужно знать точное имя функции, хук и приоритет, с которым она была добавлена. Без этих данных удаление не сработает.
Схема обычно такая:
remove_action( 'wp_footer', 'имя_функции', 10 );Третий параметр — приоритет. Если он не совпадает с тем, что использовался при добавлении, WordPress не найдёт нужную привязку. Поэтому при работе с чужим кодом сначала ищите, где именно функция подключается через add_action() или add_filter().
Что важно учитывать при работе с хуками
Есть несколько моментов, которые экономят время и помогают не ловить странные ошибки.
- Не используйте одинаковые имена функций. Если в теме уже есть функция с таким названием, будет конфликт. Безопаснее давать своим функциям уникальные префиксы.
- Следите за приоритетом. Третий параметр в
add_action()иadd_filter()определяет порядок выполнения. Чем меньше число, тем раньше сработает код. - Для filter всегда возвращайте значение. Даже если вы изменили только часть данных, вернуть нужно весь результат.
- Не вставляйте HTML в filter, если он ожидает строку или массив. Иначе можно сломать вывод или получить некорректную разметку.
- Проверяйте, где именно срабатывает хук. Некоторые хуки доступны только на фронтенде, другие — в админке, третьи — в обоих местах.
Как проверить, что хук работает
После добавления кода не ограничивайтесь визуальной проверкой страницы. Лучше проверить результат в нескольких местах:
- откройте страницу сайта в браузере и посмотрите, появился ли нужный элемент;
- если это filter, проверьте именно изменённое значение, а не соседние элементы;
- если это action, откройте исходный код страницы или используйте инструменты разработчика, чтобы найти вставленный HTML;
- посмотрите журнал ошибок сервера или лог WordPress, если сайт перестал открываться после правки.
Если код не сработал, обычно причина одна из трёх: хук не существует в этом месте, функция подключена не туда, или приоритет не совпадает с ожидаемым.
Практический вывод для обычной правки сайта
Хуки WordPress — это основной способ менять поведение темы и плагинов без правки ядра и без переписывания чужих файлов. Для вывода элементов используйте actions, для изменения значений — filters. Начинайте с простых задач: добавить блок в футер, изменить текст анонса, убрать лишний элемент, подменить заголовок или класс.
Если вы работаете с чужой темой, сначала найдите, какие хуки она уже предоставляет. Если нужного хука нет, иногда проще и безопаснее выбрать другой шаблонный файл или вынести логику в отдельный плагин, чем пытаться влезть в ядро темы. В WordPress это почти всегда более надёжный путь.