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

Диагностика проблемы: почему стандартные WP_Query не всегда подходят

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

Использование хука pre_get_posts для изменения запроса

Хук pre_get_posts позволяет изменить объект запроса до выполнения SQL, что даёт полный контроль. Он подходит как для изменения главного запроса на страницах архива, так и для любых кастомных запросов.

Пример: выборка постов из категорий 3 и 7, исключая метку “news” и с метаполем “featured”=1

function custom_modify_main_query( \WP_Query $query ) {
    if ( ! is_admin() && $query->is_main_query() && is_home() ) {
        $tax_query = [
            'relation' => 'AND',
            [
                'taxonomy' => 'category',
                'field'    => 'term_id',
                'terms'    => [3, 7],
                'operator' => 'IN',
            ],
            [
                'taxonomy' => 'post_tag',
                'field'    => 'slug',
                'terms'    => ['news'],
                'operator' => 'NOT IN',
            ],
        ];

        $meta_query = [
            [
                'key'     => 'featured',
                'value'   => '1',
                'compare' => '=',
            ],
        ];

        $query->set('tax_query', $tax_query);
        $query->set('meta_query', $meta_query);
        $query->set('posts_per_page', 10);
    }
}
add_action('pre_get_posts', 'custom_modify_main_query');

В этом примере мы проверяем, что меняем лишь главный запрос на главной странице (is_home()) и не трогаем админку. Затем устанавливаем сложный параметр tax_query с логикой AND между категорией и исключением метки, а также фильтр по метаполю.

Пошаговое решение: как реализовать сложный фильтр с pre_get_posts

1. Определите, какой именно запрос нужно изменить (главный, архивный, кастомный).
2. Используйте условные теги (is_main_query(), is_category(), is_post_type_archive() и т.д.) для ограничения области действия.
3. Подготовьте параметры tax_query и/или meta_query с учётом логических связок (relation: AND, OR).
4. В функции, подключенной к pre_get_posts, вызовите $query->set() для установки параметров.
5. Проверьте пагинацию: при изменении posts_per_page она должна работать корректно.

Проверка результата после внедрения

• Откройте страницу, где должен применяться фильтр (например, главная или архив категории).
• Проверьте через инструменты разработчика браузера, что SQL-запросы содержат нужные JOIN и WHERE по таксономиям и метаполям (через Query Monitor или Debug Bar).
• Убедитесь, что выводятся только посты из нужных категорий, без исключённых меток и с нужным значением метаполя.
• Проверьте пагинацию, переходя между страницами.

Частые ошибки и как их исправить

• Изменение запроса в неправильном месте: не используйте pre_get_posts для кастомных WP_Query, а только для главного запроса или через отдельный фильтр. Иначе можно сломать логику.
• Отсутствие проверки is_main_query() и !is_admin(): без них изменения применятся и в админке, что приведёт к непредсказуемым ошибкам.
• Неправильное форматирование tax_query или meta_query: забудьте установить relation или используйте неверные ключи — запрос не сработает.
• Конфликты с плагинами кэширования: после внесения изменений очистите кэш и проверьте работу.

Практические советы по производительности

• Старайтесь минимизировать сложность tax_query и meta_query, особенно с OR, так как они увеличивают нагрузку на базу.
• Используйте индексы для метаполей, если часто фильтруете по ним.
• Кэшируйте результат запросов, например, через транзиенты или Object Cache, если данные не меняются часто.

Сравнение способов реализации сложных фильтров