Как добавить и использовать хуки WordPress: actions и filters на простых примерах

Если нужно изменить поведение темы или плагина в 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 это почти всегда более надёжный путь.

Как удалить старые ревизии постов в WordPress из базы данных
18.09.2026
Как очистить базу данных WordPress от мусора
23.10.2026
Автоматическое удаление неактивных пользователей WordPress: практическое руководство
13.09.2026
Как создать собственный тип записи (Custom Post Type) в WordPress с примером кода
02.10.2026
Как найти и удалить битые ссылки в WordPress
13.10.2026
×
Дай суперсилу своему сайту!

WordPress

-20% на топовые темы и плагины

Создай сайт своей мечты ⋙