Eine auf WordPress spezialiserte Suchmaschine für Entwickler und Theme-Autoren



get_post ›

Seit1.5.1
Veraltetn/v
get_post ( $post = null, $output = OBJECT, $filter = 'raw' )
Parameter: (3)
  • (int|WP_Post|null) $post Optional. Post ID or post object. Defaults to global $post.
    Erforderlich: Nein
    Standard: null
  • (string) $output Optional. The required return type. One of OBJECT, ARRAY_A, or ARRAY_N, which correspond to a WP_Post object, an associative array, or a numeric array, respectively. Default OBJECT.
    Erforderlich: Nein
    Standard: OBJECT
  • (string) $filter Optional. Type of filter to apply. Accepts 'raw', 'edit', 'db', or 'display'. Default 'raw'.
    Erforderlich: Nein
    Standard: 'raw'
Gibt zurück:
  • (WP_Post|array|null) Type corresponding to $output on success or null on failure. When $output is OBJECT, a `WP_Post` instance is returned.
Definiert in:
Codex:

Retrieves post data given a post ID or post object.

See sanitize_post() for optional $filter values. Also, the parameter $post, must be given as a variable, since it is passed by reference.



Quellcode

function get_post( $post = null, $output = OBJECT, $filter = 'raw' ) {
	if ( empty( $post ) && isset( $GLOBALS['post'] ) )
		$post = $GLOBALS['post'];

	if ( $post instanceof WP_Post ) {
		$_post = $post;
	} elseif ( is_object( $post ) ) {
		if ( empty( $post->filter ) ) {
			$_post = sanitize_post( $post, 'raw' );
			$_post = new WP_Post( $_post );
		} elseif ( 'raw' == $post->filter ) {
			$_post = new WP_Post( $post );
		} else {
			$_post = WP_Post::get_instance( $post->ID );
		}
	} else {
		$_post = WP_Post::get_instance( $post );
	}

	if ( ! $_post )
		return null;

	$_post = $_post->filter( $filter );

	if ( $output == ARRAY_A )
		return $_post->to_array();
	elseif ( $output == ARRAY_N )
		return array_values( $_post->to_array() );

	return $_post;
}