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

Автор: Павел Попов | Опубликовано: 08.03.2026

Хуки (hooks) — это одна из базовых и самых мощных возможностей WordPress, которая позволяет разработчикам изменять поведение ядра, тем и плагинов без изменения исходного кода. В WordPress выделяют два основных типа хуков: actions и filters. Понимание различий и правильное использование этих хуков существенно расширяет возможности кастомизации и оптимизации сайта.

Что такое хуки в WordPress: actions и filters

Actions (действия) — это точки в коде, где WordPress вызывает пользовательские функции для выполнения дополнительного кода. Actions не изменяют данные, а просто позволяют добавить собственное поведение.

Filters (фильтры) — это хуки, которые принимают данные, изменяют их и возвращают обратно. Они позволяют модифицировать содержимое, параметры и другие данные до их вывода или обработки.

Например, если вы хотите изменить контент поста перед выводом, нужно использовать фильтр, а если хотите добавить дополнительный скрипт при загрузке страницы — action.

Как правильно создавать и подключать хуки в WordPress

Для добавления собственного действия или фильтра используется функция add_action() или add_filter(). Они принимают минимум два параметра: имя хука и имя вашей функции. Например:

add_action('wp_footer', 'wpall_add_custom_footer_text');
function wpall_add_custom_footer_text() {
    echo '<p>Спасибо, что посетили наш сайт!</p>';
}

Это добавит текст в футер сайта. Важно давать уникальные имена функциям, чтобы избежать конфликтов с другими плагинами или темой. Рекомендуется использовать префикс, связанный с доменом сайта, например, wpall_.

Параметры при добавлении хуков

Функции add_action и add_filter принимают дополнительно параметры приоритета (число) и количество аргументов, передаваемых в функцию. Это позволяет гибко управлять порядком вызова и доступом к данным.

Примеры использования хуков для решения конкретных задач

1. Изменение заголовка сайта через фильтр

Иногда нужно динамически менять заголовок сайта, например, добавлять дополнительный текст или информацию о категории.

add_filter('wp_title', 'wpall_modify_wp_title', 10, 2);
function wpall_modify_wp_title($title, $sep) {
    if (is_category()) {
        $title .= ' ' . $sep . ' Категории WordPress';
    }
    return $title;
}

Этот фильтр добавляет к заголовку сайта суффикс «Категории WordPress» при просмотре страниц категорий.

2. Добавление пользовательского класса к меню через фильтр

Для кастомизации классов меню можно использовать фильтр nav_menu_css_class:

add_filter('nav_menu_css_class', 'wpall_add_custom_menu_class', 10, 4);
function wpall_add_custom_menu_class($classes, $item, $args, $depth) {
    if ($args->theme_location == 'primary') {
        $classes[] = 'wpall-primary-menu-item';
    }
    return $classes;
}

Так можно добавить собственные CSS-классы к элементам меню, что полезно для стилизации.

3. Автоматическое добавление мета-тега в заголовок через action

Иногда требуется добавить в <head> дополнительные мета-теги для SEO или интеграций:

add_action('wp_head', 'wpall_add_custom_meta_tag');
function wpall_add_custom_meta_tag() {
    echo '<meta name="author" content="WPAll.ru">';
}

Этот action добавит мета-тег автора на все страницы сайта.

Лучшие практики при работе с хуками

Чтобы избежать проблем и конфликтов, следуйте нескольким рекомендациям:

Всегда используйте уникальные префиксы для своих функций, например, wpall_.
Не изменяйте поведение хуков ядра напрямую — используйте фильтры и действия.
Документируйте для чего предназначен каждый ваш хук.
Следите за приоритетом вызова функций, чтобы не перезаписать чужие изменения.
Используйте remove_action и remove_filter, если нужно отменить стандартное поведение.

Полезные плагины для работы с хуками и отладки

Для удобства разработки и отладки хуков можно использовать плагины:

Query Monitor — показывает все активные хуки на странице, их приоритет и функции.
Debug Bar — панель для отладки с информацией о хуках, запросах и ошибках.
Clearfy Pro — оптимизация и контроль за поведением WordPress, включая работу хуков.

Пример создания собственного фильтра в своем плагине

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

function wpall_apply_custom_filter($content) {
    /**
     * Фильтр для изменения контента перед выводом
     *
     * @param string $content
     * @return string
     */
    return apply_filters('wpall_custom_content_filter', $content);
}

// Подключение к фильтру
add_filter('wpall_custom_content_filter', 'wpall_modify_custom_content');
function wpall_modify_custom_content($content) {
    return $content . '<p>Дополнительный текст от WPAll</p>';
}

Такой подход позволяет сделать ваш код расширяемым и удобным для поддержки.

Заключение по использованию хуков в WordPress

Хуки — незаменимый инструмент для любого разработчика на WordPress. Понимание и правильное применение actions и filters позволяет создавать гибкие, расширяемые и удобные проекты. Используйте примеры из статьи, адаптируйте под свои задачи и не забывайте про лучшие практики и безопасность при написании кода.