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.


Top ↑

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 );
	}


Top ↑

Changelog

Changelog
VersionDescription
1.5.0Introduced.

The content displayed on this page has been created in part by processing WordPress source code files which are made available under the GPLv2 (or a later version) license by theĀ Free Software Foundation. In addition to this, the content includes user-written examples and information. All material is subject to review and curation by the WPPaste.com community.