Использование хуков в WordPress для расширения функциональности

Автор: Тимур Панин | Опубликовано: 19.11.2025

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

Что такое хуки в WordPress: Actions и Filters

Хуки — это точки входа в процесс выполнения WordPress, куда можно «подцепить» собственные функции. Actions позволяют выполнить код в определенный момент, например, после публикации записи, а filters дают возможность изменить данные перед их выводом или сохранением.

Например, action wp_footer позволяет добавить HTML или JavaScript в подвал сайта, а filter the_content — изменить содержимое поста перед выводом.

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

Примеры использования Actions: расширяем функциональность сайта

Рассмотрим практические примеры actions, которые помогут вам понять, как и где применять хуки.

Добавление пользовательского текста в подвал сайта

Чтобы добавить простой текст в конец страницы, используйте action wp_footer. Для сайта wpabout.ru создадим функцию с префиксом wpabout_ для уникальности:

function wpabout_add_footer_text() {
    echo '<p style="text-align:center; font-size:14px; color:#888;">Спасибо, что посетили wpabout.ru!</p>';
}
add_action('wp_footer', 'wpabout_add_footer_text');

Этот код следует добавить в файл functions.php вашей темы или в собственный плагин. В результате в подвале сайта появится приветственное сообщение.

Автоматическая отправка письма после публикации поста

Частая задача — уведомление администратора или редактора о новых публикациях. Используем action publish_post:

function wpabout_notify_admin_on_publish($post_ID) {
    $post = get_post($post_ID);
    $subject = 'Новая публикация на wpabout.ru';
    $message = 'Опубликована новая статья: ' . $post->post_title . '\nСсылка: ' . get_permalink($post_ID);
    wp_mail(get_option('admin_email'), $subject, $message);
    return $post_ID;
}
add_action('publish_post', 'wpabout_notify_admin_on_publish');

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

Использование Filters: изменение данных перед выводом

Filters позволяют изменять данные, которые WordPress собирается вывести или сохранить. Это мощный инструмент для кастомизации.

Добавление предупреждения в начало содержимого поста

Допустим, нужно добавить предупреждение или заметку в начале каждого поста. Используем filter the_content:

function wpabout_add_warning_to_content($content) {
    if (is_single() && in_the_loop() && is_main_query()) {
        $warning = '<div style="border:1px solid red; padding:10px; margin-bottom:15px; background:#ffe6e6;"><strong>Внимание:</strong> Это важное предупреждение для читателей.</div>';
        return $warning . $content;
    }
    return $content;
}
add_filter('the_content', 'wpabout_add_warning_to_content');

Преимущество filters в том, что вы не меняете данные в базе, а только их вывод.

Изменение заголовка страницы динамически

Если нужно изменить заголовок страницы, можно использовать filter the_title:

function wpabout_modify_post_title($title, $id = null) {
    if (is_single($id) && in_the_loop()) {
        $title .= ' | wpabout.ru';
    }
    return $title;
}
add_filter('the_title', 'wpabout_modify_post_title', 10, 2);

Этот код добавит суффикс к заголовку каждого поста, улучшая брендинг.

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

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

Например, добавим action hook в функции темы wpabout для вывода дополнительного блока после контента:

function wpabout_after_content_hook() {
    do_action('wpabout_after_content');
}

// В шаблоне single.php после вывода контента вызываем:
// <?php wpabout_after_content_hook(); ?>

Другие разработчики смогут добавить свои функции к этому хуку:

add_action('wpabout_after_content', 'custom_function');
function custom_function() {
    echo '<p>Это дополнительный блок, добавленный через пользовательский хук wpabout_after_content.</p>';
}

Аналогично можно создавать и filters с помощью apply_filters().

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

Для эффективной работы с хуками запомните несколько правил:

Используйте префиксы в названиях своих функций, чтобы избежать конфликтов (например, wpabout_).
Правильно выбирайте приоритет при добавлении хуков. По умолчанию он 10, меньшее значение означает более ранний вызов.
Используйте параметры в хуках, если нужно работать с данными — указывайте количество аргументов в add_action или add_filter.
Не изменяйте глобальные переменные без крайней необходимости.
Документируйте свой код для удобства поддержки.

Заключение: хуки — основа кастомизации WordPress

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