posts_pre_query — filter WordPress: параметры и применение

Сигнатура

apply_filters_ref_array( 'posts_pre_query', WP_Post[]|int[]|null $posts, WP_Query $query )

Описание

Верните значение, отличное от null, чтобы обойти стандартные запросы записей WordPress.
Функциям фильтра, которым требуется информация о постраничной навигации, рекомендуется задавать свойства found_posts и max_num_pages объекта WP_Query, передаваемого в фильтр по ссылке. Если WP_Query не выполняет запрос к базе данных, у него не будет достаточно информации, чтобы сформировать эти значения самостоятельно.

Оригинал (английский)

Return a non-null value to bypass WordPress’ default post queries.

Filtering functions that require pagination information are encouraged to set the found_posts and max_num_pages properties of the WP_Query object, passed to the filter by reference. If WP_Query does not perform a database query, it will not have enough information to generate these values itself.

Фильтруемое значение

Верните массив данных записей, чтобы прервать запрос WP, или null, чтобы позволить WP выполнить обычные запросы.

Параметры

$posts WP_Post[]|int[]|null обязательный

Верните массив данных записей, чтобы прервать запрос WP, или null, чтобы позволить WP выполнить обычные запросы.

$query WP_Query обязательный

Экземпляр WP_Query (передаётся по ссылке).

Исходный код

wp-includes/class-wp-query.php:3222

$this->posts = apply_filters_ref_array( 'posts_pre_query', array( null, &$this ) );

История изменений

Версия	Описание
4.6.0	Introduced.