хук-действие
since 2.0.0
pre_get_posts
Проверено на WordPress 6.9, обновлено Источник: WordPress Developer Resources.
Сигнатура
do_action_ref_array( 'pre_get_posts', WP_Query $query )Описание
Примечание: при использовании условных тегов используйте их методные версии в переданном экземпляре (например, $query->is_main_query() вместо is_main_query()). Это связано с тем, что функции вроде is_main_query() проверяют глобальный экземпляр $wp_query, а не переданный.
Оригинал (английский)
Note: If using conditional tags, use the method versions within the passed instance (e.g. $query->is_main_query() instead of is_main_query()). This is because the functions like is_main_query() test against the global $wp_query instance, not the passed one.
Параметры
$query
WP_Query
обязательный
Экземпляр WP_Query (передаётся по ссылке).
Исходный код
wp-includes/class-wp-query.php:1906
do_action_ref_array( 'pre_get_posts', array( &$this ) );История изменений
| Версия | Описание |
|---|---|
| 2.0.0 | Introduced. |
