Set up global post data.

Parameters

$postWP_Post|object|intrequired

WP_Post instance or Post ID/object.

Return

More Information

Sets up global post data. Helps to format custom query results for using Template tags.

setup_postdata() fills the global variables $id, $authordata, $currentday, $currentmonth, $page, $pages, $multipage, $more, $numpages, which help many Template Tags work in the current post context.

setup_postdata() does not assign the global $post variable so it’s important that you do this yourself. Failure to do so will cause problems with any hooks that use any of the above globals in conjunction with the $post global, as they will refer to separate entities.

Usage

<?php
global $post;

// modify the $post variable with the post data you want. Note that this variable must have this name!

setup_postdata( $post );
?>

Source

function setup_postdata( $post ) {
	global $wp_query;

	if ( ! empty( $wp_query ) && $wp_query instanceof WP_Query ) {
		return $wp_query->setup_postdata( $post );
	}

	return false;
}

View all references View on Trac View on GitHub

Changelog