Как использовать хуки в WordPress для начинающих: практика и примеры кода

Автор: Артем Васильев | Опубликовано: 06.11.2025

Работа с хуками — один из ключевых навыков любого разработчика, который хочет создавать качественные темы и плагины для WordPress. В этой статье мы подробно разберем, что такое хуки, как их использовать на практике, и приведем примеры кода, которые помогут вам быстро освоить этот инструмент.

Что такое хуки в WordPress: действия и фильтры

Хуки — это специальные точки в коде WordPress, в которых можно "подхватить" и изменить поведение системы, не меняя исходные файлы ядра. Существует два типа хуков:

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

Использование хуков позволяет расширять функциональность сайта безопасно и эффективно, без риска потерять изменения при обновлении WordPress.

Как добавить действие (Action) с помощью хуков WordPress

Рассмотрим простой пример. Допустим, вы хотите добавить сообщение в админбар при загрузке админки. Для этого используется хук admin_bar_menu.

function wpcorp_add_admin_bar_message($wp_admin_bar) {
    $args = array(
        'id' => 'wpcorp_custom_message',
        'title' => 'Привет от WPcorp!',
        'meta' => array('class' => 'wpcorp-message')
    );
    $wp_admin_bar->add_node($args);
}
add_action('admin_bar_menu', 'wpcorp_add_admin_bar_message', 100);

Здесь функция wpcorp_add_admin_bar_message добавляет новый элемент в админбар. Хук admin_bar_menu позволяет добавить свой код именно в момент формирования меню.

Важно: третий параметр в add_action — приоритет выполнения, чем выше число, тем позже вызовется функция.

Как использовать фильтры (Filters) для изменения контента в WordPress

Фильтры позволяют изменить текст, данные или HTML перед выводом. Например, добавим в конце каждого поста подпись.

function wpcorp_add_post_signature($content) {
    if (is_single()) {
        $signature = '<p>— Статья подготовлена командой WPcorp</p>';
        return $content . $signature;
    }
    return $content;
}
add_filter('the_content', 'wpcorp_add_post_signature');

Здесь the_content — стандартный фильтр, который используется для вывода содержимого поста. Наша функция дописывает в конец подпись, если это одиночная запись.

Создание собственных хуков: actions и filters

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

Пример создания собственного действия:

function wpcorp_custom_function() {
    do_action('wpcorp_before_special_block');
    echo '<div>Особый блок контента</div>';
    do_action('wpcorp_after_special_block');
}

Другие разработчики смогут добавить свои функции к хукам wpcorp_before_special_block или wpcorp_after_special_block с помощью add_action.

Аналогично можно создавать фильтры:

function wpcorp_modify_special_text($text) {
    return apply_filters('wpcorp_special_text_filter', $text);
}

В этом случае другие смогут изменить переменную $text, подключившись к фильтру wpcorp_special_text_filter.

Практические советы по работе с хуками в WordPress

Для эффективной работы с хуками рекомендуем следующее:

Всегда используйте префиксы в названиях функций и хуков, чтобы избежать конфликтов с другими плагинами. В нашем примере это "wpcorp".
Для добавления функций используйте add_action и add_filter, а для удаления remove_action и remove_filter.
Изучайте документацию WordPress — там описаны все стандартные хуки и их параметры.
Тестируйте код на локальном сервере или staging-сайте, чтобы избежать ошибок на рабочем сайте.

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

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