Методы и свойства класса WP_Query

Возможно вам будет легче разобраться с тем, как работает WP_Query в WordPress, если вы посмотрите мой видеоурок по нему.

Будем считать, что это будет небольшое (но довольно полезное) дополнение к посту про создание циклов при помощи WP_Query.

Сначала я хотел дописать эту часть прямо там в комментариях, но она получилась не такой уж и небольшой, да и к тому же не все люди читают комменты.

Сначала создам объект, он мне ещё пригодится позднее:

$args = array(
	'cat' => 1,
	'posts_per_page' => 5,
	'orderby' => 'comment_count' // WordPress 2.9+
);
 
$myquery = new WP_Query($args);

Свойства:

Во всех последующих примерах будет использоваться объект, созданный в начале поста, ну то есть двумя строчками выше :)

  • $query (массив) — параметры созданного объекта,
    print_r($myquery->query);
    /*
    Array (
    [cat] => 1
    [orderby] => comment_count
    [posts_per_page] => 5
    )
    */
  • $query_vars (массив) — все параметры объекта, включая те, которые не были указаны при создании,
    print_r($myquery->query_vars);
    /*
    Array (
    [cat] => 1
    [posts_per_page] => 5
    [orderby] => comment_count
    [error] =>
    [m] => 0
    [p] => 0
    [post_parent] =>
    [subpost] =>
    [subpost_id] =>
    [attachment] =>
    [attachment_id] => 0
    [name] =>
    [static] =>
    [pagename] =>
    [page_id] => 0
    [second] =>
    [minute] =>
    [hour] =>
    [day] => 0
    [monthnum] => 0
    [year] => 0
    [w] => 0
    [category_name] => uncategorized
    [tag] =>
    [tag_id] =>
    [author_name] =>
    [feed] =>
    [tb] =>
    [paged] => 0
    [comments_popup] =>
    [meta_key] =>
    [meta_value] =>
    [preview] =>
    [s] =>
    [sentence] =>
    [fields] =>
    [category__in] => Array ( [0] => 1 )
    [category__not_in] => Array ( )
    [category__and] => Array ( )
    [post__in] => Array ( )
    [post__not_in] => Array ( )
    [tag__in] => Array ( )
    [tag__not_in] => Array ( )
    [tag__and] => Array ( )
    [tag_slug__in] => Array ( )
    [tag_slug__and] => Array ( )
    [ignore_sticky_posts] =>
    [suppress_filters] =>
    [cache_results] => 1
    [update_post_term_cache] => 1
    [update_post_meta_cache] => 1
    [post_type] =>
    [nopaging] =>
    [comments_per_page] => 50
    [no_found_rows] =>
    [order] => DESC
    )
    */
  • $posts (массив) — содержит запрошенные посты,
  • $post_count (целое) — количество запрошенных постов,
    echo $myquery->post_count;
  • $found_posts (целое) — общее количество постов, удовлетворяющих условиям,
  • $max_num_pages (целое) — общее количество страниц, по сути является отношением $found_posts / $posts_count,
  • $current_post (целое) (доступен только в цикле) — индекс текущего поста при выводе, номер по порядку,
  • $post (объект) (доступен только в цикле) — содержит информацию о текущей записи.
    $obj = $myquery->post;
    /*
    stdClass Object (
    [ID] => 257 [post_author] => 1 
    [post_date] => 2012-04-20 08:45:21 
    [post_date_gmt] => 2012-04-20 08:45:21 
    [post_content] => 
    [post_title] => Liber perfecto definitionem duo ne. 
    [post_excerpt] => 
    [post_status] => publish 
    [comment_status] => open 
    [ping_status] => open 
    [post_password] => 
    [post_name] => liber-perfecto-definitionem-duo-ne
    [to_ping] => 
    [pinged] => 
    [post_modified] => 2012-04-20 08:45:37 
    [post_modified_gmt] => 2012-04-20 08:45:37 
    [post_content_filtered] => 
    [post_parent] => 0 
    [guid] => https://misha.agency/?p=257 
    [menu_order] => 0 
    [post_type] => post 
    [post_mime_type] => 
    [comment_count] => 1 
    [filter] => raw
    )
    */
    echo $obj->ID;

Методы:

Я не стал включать сюда методы, смысл которых мне непонятен, возможно позднее я их добавлю.

  • init() — инициализация объекта, сбрасывает все свойства класса на NULL, 0 или FALSE
    $myquery->init();
  • get( $query_var ) — вытаскивает один из установленных параметров объекта,
    echo $myquery->get('posts_per_page'); // выведет 5
  • set( $query_var, $value ) — устанавливает значение одного из параметров, кстати ещё один пример использования можно найти в статье про модификацию основного цикла.

    $myquery->set('orderby', 'rand');
  • the_post() (для использования в цикле) — устанавливает глобальную переменную $post, после обращения к этому методу можно использовать такие функции как the_title(), the_content() и прочее.
    $myquery->the_post();
    echo '<h2>'; the_title(); echo '</h2>'; // заголовок
    echo $post->comment_count; // количество комментов
  • have_posts() — определяем, существуют ли записи, удовлетворяющие установленным параметрам, то есть в данном случае, есть ли посты в категории с ID=1, можно использовать при создании цикла:
    if($myquery->have_posts()): 
    	while($myquery->have_posts()):
    		$myquery->the_post();
    		echo '<h2>'; the_title(); echo '</h2>';
    	endwhile;
    endif;

Миша

Впервые познакомился с WordPress в 2009 году. Организатор и спикер на конференциях WordCamp. Преподаватель в школе Нетология.

Пишите, если нужна помощь с сайтом или разработка с нуля.

Комментарии — 6

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

Миша Рудрастых и WordPress

Полезности из мира WordPress и жизни студии.

Мой телеграм-канал