Гибкость 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, а фильтры обновлений в статье об отключении автообновлений.