Фильтры WordPress: как изменять данные без правки ядра

Гибкость WordPress во многом держится на хуках. Они позволяют менять поведение ядра, тем и плагинов, не трогая их файлы. Хуки бывают двух видов: действия (actions) и фильтры (filters). Разберёмся с фильтрами.

Что такое фильтр

Фильтр получает значение, может его изменить и обязан вернуть результат. В коде WordPress это выглядит так:

$content = apply_filters( 'the_content', $content );

Любой плагин или тема может «подписаться» на этот фильтр через add_filter() и поменять текст записи перед выводом.

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

Синтаксис

add_filter( 'имя_фильтра', 'функция', приоритет, число_аргументов );
  • Приоритет по умолчанию 10. Меньше значит раньше.
  • Число аргументов нужно указать, если функции требуется больше одного параметра.

Примеры

Добавить подпись в конец каждой записи:

add_filter( 'the_content', function ( $content ) {
    if ( is_singular( 'post' ) && in_the_loop() && is_main_query() ) {
        $content .= '<p>Спасибо, что дочитали!</p>';
    }
    return $content;
} );

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

add_filter( 'excerpt_length', fn() => 30 );

Поменять заголовок только для одной записи:

add_filter( 'the_title', function ( $title, $id ) {
    return $id === 42 ? 'Новый заголовок' : $title;
}, 10, 2 );

Свой фильтр

В своём плагине можно дать другим разработчикам точку для изменений:

$price_label = apply_filters( 'myplugin_price_label', 'Цена:', $product_id );

Как отключить чужой фильтр

remove_filter( 'the_content', 'wpautop' );

Приоритет должен совпадать с тем, с которым фильтр добавлен.

Советы

  • Всегда возвращайте значение, иначе данные пропадут.
  • Код кладите в дочернюю тему или мини-плагин, а не в файлы ядра.
  • Найти, какие функции висят на хуке, помогает плагин Query Monitor. Другие средства отладки описаны в статье об инструментах отладки WordPress.

Пример реального фильтра SEO-плагина есть в заметке о мета-описаниях в The SEO Framework, а фильтры обновлений в статье об отключении автообновлений.

Источники и ссылки


Комментарии загружаются…