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. |