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

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

Что такое отрывные настройки и зачем они нужны в WordPress

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

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

Хуки в WordPress: разница между action и filter

Прежде чем создавать отрывные настройки, нужно понимать два типа хуков:

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

Для отрывных настроек чаще используют и то, и другое — в зависимости от задачи.

Пример: отрывная настройка для добавления мета-поля к постам

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

Шаг 1. Создаём функцию с префиксом wptemy для изоляции

function wptemy_add_source_meta_box() {
    add_meta_box(
        'wptemy_source',
        'Источник',
        'wptemy_source_meta_box_callback',
        'post',
        'side',
        'default'
    );
}

function wptemy_source_meta_box_callback($post) {
    $value = get_post_meta($post->ID, '_wptemy_source_key', true);
    echo '<label for="wptemy_source_field">Введите источник:</label>';
    echo '<input type="text" id="wptemy_source_field" name="wptemy_source_field" value="' . esc_attr($value) . '" size="25" />';
}

Здесь мы добавляем мета-бокс на страницу редактирования поста.

Шаг 2. Подключаем функцию через action

add_action('add_meta_boxes', 'wptemy_add_source_meta_box');

Это стандартный способ добавить свой блок в админке.

Шаг 3. Сохраняем данные мета-поля

function wptemy_save_source_meta_box_data($post_id) {
    if (!isset($_POST['wptemy_source_field'])) {
        return;
    }
    $source_data = sanitize_text_field($_POST['wptemy_source_field']);
    update_post_meta($post_id, '_wptemy_source_key', $source_data);
}
add_action('save_post', 'wptemy_save_source_meta_box_data');

Как сделать настройку отрывной (включаемой/отключаемой)

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

$enable_source_meta = get_option('wptemy_enable_source_meta', true);
if ($enable_source_meta) {
    add_action('add_meta_boxes', 'wptemy_add_source_meta_box');
    add_action('save_post', 'wptemy_save_source_meta_box_data');
}

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

Пример использования фильтра для отрывной настройки вывода

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

function wptemy_filter_the_title_with_source($title, $post_id) {
    $enable_source_meta = get_option('wptemy_enable_source_meta', true);
    if (!$enable_source_meta) {
        return $title;
    }
    $source = get_post_meta($post_id, '_wptemy_source_key', true);
    if ($source) {
        $title .= ' (Источник: ' . esc_html($source) . ')';
    }
    return $title;
}
add_filter('the_title', 'wptemy_filter_the_title_with_source', 10, 2);

Здесь мы используем фильтр the_title, чтобы отобразить дополнительную информацию, если она есть и включена в настройках.

Инструменты и плагины для упрощения работы с хуками и настройками

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

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

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

Заключение

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