WP_Query::the_post() WordPress Method
The WP_Query::the_post() method is used to setup the global $post variable for the current post in the loop. This is necessary when using template tags that display information about the current post, such as the_title() or the_excerpt().
WP_Query::the_post() #
Sets up the current post.
Description
Retrieves the next post, sets up the post, sets the ‘in the loop’ property to true.
Source
File: wp-includes/class-wp-query.php
public function the_post() {
global $post;
$this->in_the_loop = true;
if ( -1 == $this->current_post ) { // Loop has just started.
/**
* Fires once the loop is started.
*
* @since 2.0.0
*
* @param WP_Query $query The WP_Query instance (passed by reference).
*/
do_action_ref_array( 'loop_start', array( &$this ) );
}
$post = $this->next_post();
$this->setup_postdata( $post );
}
Expand full source codeCollapse full source codeView on TracView on GitHub
Changelog
| Version | Description |
|---|---|
| 1.5.0 | Introduced. |