Автоматизация работы с фильтром запросов в WordPress

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

Что такое фильтр запросов WP_Query и зачем его автоматизировать

По умолчанию WP_Query принимает массив параметров, по которым строит SQL-запрос к базе данных. Иногда нам нужно менять эти параметры не вручную в каждом вызове, а централизованно, автоматизируя логику выбора записей. Например, подключать условия из настроек сайта, учитывать пользовательские роли, или подставлять сложные meta_query.

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

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

Базовый пример: добавляем условие по метаполю ко всем запросам блога

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

function wpquery_filter_featured_posts(\WP_Query $query) {
    if ( !is_admin() && $query->is_main_query() && $query->is_home() ) {
        $meta_query = array(
            array(
                'key' => 'featured',
                'value' => '1',
                'compare' => '='
            )
        );
        $query->set('meta_query', $meta_query);
    }
}
add_action('pre_get_posts', 'wpquery_filter_featured_posts');

Объяснение:

• !is_admin() — проверяем, что это фронтенд сайта;
• $query->is_main_query() — фильтруем только основной запрос главной страницы;
• Устанавливаем параметр meta_query, который добавляет условие по метаполю featured=1.

Такой подход позволяет централизованно влиять на выборку без изменения шаблонов.

Автоматизация сложных фильтров с несколькими условиями

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

function wpquery_apply_custom_filters(\WP_Query $query) {
    if ( !is_admin() && $query->is_main_query() && (is_home() || is_category()) ) {

        $custom_filters = array(
            'meta_query' => array(
                'relation' => 'AND',
                array(
                    'key' => 'featured',
                    'value' => '1',
                    'compare' => '='
                ),
                array(
                    'key' => 'rating',
                    'value' => 4,
                    'compare' => '>=',
                    'type' => 'NUMERIC'
                )
            ),
            'date_query' => array(
                array(
                    'after' => '1 month ago'
                )
            ),
            'tax_query' => array(
                array(
                    'taxonomy' => 'category',
                    'field' => 'slug',
                    'terms' => array('news', 'updates'),
                    'operator' => 'IN'
                )
            )
        );

        foreach ($custom_filters as $key => $value) {
            $query->set($key, $value);
        }
    }
}
add_action('pre_get_posts', 'wpquery_apply_custom_filters');

Здесь мы автоматически добавляем:

• Фильтр по метаполям featured = 1 и rating >= 4;
• Фильтр по дате — записи не старее 1 месяца;
• Фильтр по таксономии — только записи из категорий news и updates.

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

Советы по отладке и тестированию фильтров WP_Query

При работе с фильтрами полезно использовать вывод параметров запроса для проверки, что условия применились правильно:

function wpquery_debug_query(\WP_Query $query) {
    if ( !is_admin() && $query->is_main_query() ) {
        error_log(print_r($query->query_vars, true));
    }
}
add_action('pre_get_posts', 'wpquery_debug_query', 20);

Это выводит в лог все параметры текущего запроса после применения фильтров. Также рекомендую использовать плагин Query Monitor для удобного визуального анализа запросов.

Пример создания собственного фильтра для повторного использования

Если часто нужно применять одинаковые фильтры, удобно инкапсулировать логику в отдельную функцию, которую можно вызвать с разными параметрами. Ниже пример функции, которая добавляет мета-фильтр к любому WP_Query:

function wpquery_add_meta_filter(\WP_Query $query, $key, $value, $compare = '=', $type = 'CHAR') {
    $meta_query = $query->get('meta_query');
    if ( !is_array($meta_query) ) {
        $meta_query = array();
    }
    $meta_query[] = array(
        'key' => $key,
        'value' => $value,
        'compare' => $compare,
        'type' => $type
    );
    $query->set('meta_query', $meta_query);
}

// Использование в pre_get_posts
function wpquery_example_usage(\WP_Query $query) {
    if ( !is_admin() && $query->is_main_query() && is_home() ) {
        wpquery_add_meta_filter($query, 'featured', '1');
        wpquery_add_meta_filter($query, 'rating', 5, '>=', 'NUMERIC');
    }
}
add_action('pre_get_posts', 'wpquery_example_usage');

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

Популярные плагины для визуального управления WP_Query и фильтрами

Если хочется минимизировать код и получить визуальный интерфейс для сложных запросов, можно использовать плагины:

• Query Wrangler — позволяет создавать и сохранять сложные WP_Query через админку;
• FacetWP — мощный фильтр с поддержкой таксономий, метаполей, AJAX без перезагрузки;
• Search & Filter Pro — расширенный фильтр по любым параметрам с поддержкой кастомных типов и таксономий.

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

Когда лучше писать код, а когда использовать плагин

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

Также код хорошо контролируется через систему контроля версий и не нагружает сайт лишними функциями.

Заключение: как WPQuery поможет в автоматизации работы с запросами

Фильтр pre_get_posts и класс WP_Query — ключевые инструменты для гибкой выборки данных в WordPress. Автоматизация работы с ними позволяет создавать мощные решения без дублирования кода и с минимальными усилиями для поддержки.

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