get_post( int|WP_Post|null $post = null, string $output = OBJECT, string $filter = 'raw' )

Retrieves post data given a post ID or post object.

Description
- Parameters
- Return
- Source
- Changelog
Related
- Uses
- Used By
User Contributed Notes

Description Description

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

Parameters Parameters

$post

(int|WP_Post|null) (Optional) Post ID or post object. Defaults to global $post.

Default value: null

$output

(string) (Optional) default is Object. Accepts OBJECT, ARRAY_A, or ARRAY_N.

Default value: OBJECT

$filter

(string) (Optional) Type of filter to apply. Accepts 'raw', 'edit', 'db', or 'display'.

Default value: 'raw'

Top ↑

Return Return

(WP_Post|array|null) Type corresponding to $output on success or null on failure. When $output is OBJECT, a WP_Post instance is returned.

Top ↑

Source Source

File: wp-includes/post.php

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

Expand full source code Collapse full source code View on Trac

Top ↑

Changelog Changelog

Changelog
Version	Description
1.5.1	Introduced.

Top ↑

User Contributed Notes User Contributed Notes

Contributed by Fiaz Husyn — 12 months ago

For reference, WP_Post OBJECT contains following fields:

WP_Post Object
(
    [ID] =>
    [post_author] =>
    [post_date] => 
    [post_date_gmt] => 
    [post_content] => 
    [post_title] => 
    [post_excerpt] => 
    [post_status] =>
    [comment_status] =>
    [ping_status] => 
    [post_password] => 
    [post_name] =>
    [to_ping] => 
    [pinged] => 
    [post_modified] => 
    [post_modified_gmt] =>
    [post_content_filtered] => 
    [post_parent] => 
    [guid] => 
    [menu_order] =>
    [post_type] =>
    [post_mime_type] => 
    [comment_count] =>
    [filter] =>
)

Expand full source code Collapse full source code

Skip to note content

You must log in to vote on the helpfulness of this noteVote results for this note: 4You must log in to vote on the helpfulness of this note

Contributed by Codex — 1 year ago
To get the title for a post with ID 7:
```
$post_7 = get_post( 7 ); 
$title = $post_7->post_title;
```
Alternatively, specify the $output parameter:
```
$post_7 = get_post( 7, ARRAY_A );
$title = $post_7['post_title'];
```
Skip to note content

You must log in to vote on the helpfulness of this noteVote results for this note: 4You must log in to vote on the helpfulness of this note

Contributed by beachaney — 1 year ago

Wouldn’t it be better practice to use get_the_title(..) in this case? directly accessing the post object’s data member would bypass applying filters and enforcing protected and private settings, unless that’s explicitly desired.
Skip to note content

You must log in to vote on the helpfulness of this noteVote results for this note: 1You must log in to vote on the helpfulness of this note

Contributed by ancawonka — 10 months ago

If you want to get a post by slug, you could do a new WP_Query, or use the get_page_by_path function: https://developer.wordpress.org/reference/functions/get_page_by_path/

You’ll need to use the post_type if you are not getting a page.
Skip to note content

You must log in to vote on the helpfulness of this noteVote results for this note: 1You must log in to vote on the helpfulness of this note

Contributed by rjksn — 8 months ago
If you need special things—[shortcodes], paragraph tags, anything exciting—in the content, you should apply the filters as opposed to using do_shortcode().
```
$post   = get_post( 42 );
$output =  apply_filters( 'the_content', $post->post_content );
```
Skip to note content

You must log in to vote on the helpfulness of this noteVote results for this note: 0You must log in to vote on the helpfulness of this note

Contributed by Riyaz — 1 year ago
To Get author of the Post
```
$post_info = get_post( 10 );
$author = $post_info->post_author;
```

Contributed by Fiaz Husyn — 12 months ago

For Reference : WP_Post Object has following properties, which are returned by get_post().

Member Variable Variable Type 	Notes
ID 	        int 	The ID of the post
post_author 	string 	The post author's user ID (numeric string)
post_name 	string 	The post's slug
post_type 	string 	See Post Types
post_title 	string 	The title of the post
post_date 	string 	Format: 0000-00-00 00:00:00
post_date_gmt 	string 	Format: 0000-00-00 00:00:00
post_content 	string 	The full content of the post
post_excerpt 	string 	User-defined post excerpt
post_status 	string 	See get_post_status for values
comment_status 	string 	Returns: { open, closed }
ping_status 	string 	Returns: { open, closed }
post_password 	string 	Returns empty string if no password
post_parent 	int 	Parent Post ID (default 0)
post_modified 	string 	Format: 0000-00-00 00:00:00
post_modified_gmt 	string 	Format: 0000-00-00 00:00:00
comment_count 	string 	Number of comments on post (numeric string)
menu_order 	string 	Order value as set through page-attribute when enabled (numeric string. Defaults to 0)

Expand full source code Collapse full source code

Skip to note content

You must log in to vote on the helpfulness of this noteVote results for this note: -1You must log in to vote on the helpfulness of this note

Contributed by Al — 11 months ago
If you have a shortcode in the content you should use:
```
$post = get_post( 4304,ARRAY_A );
$output =  do_shortcode($post['post_content']);
```

Cancel reply

You must log in before being able to contribute a note or feedback.

WordPress.org

Code Reference

get_post( int|WP_Post|null $post = null, string $output = OBJECT, string $filter = 'raw' )

Table of Contents

Description Description

Parameters Parameters

Return Return

Source Source

Changelog Changelog

User Contributed Notes User Contributed Notes

Cancel reply

Code is Poetry.

WordPress.org

get_post( int|WP_Post|null $post = null, string $output = OBJECT, string $filter = 'raw' )

Table of Contents

Description #Description

Parameters #Parameters

Return #Return

Source #Source

Changelog #Changelog

Related #Related

Uses #Uses

Used By #Used By

User Contributed Notes #User Contributed Notes

Cancel reply

Code is Poetry.

Description Description

Parameters Parameters

Return Return

Source Source

Changelog Changelog

Related Related

Uses Uses

Used By Used By

User Contributed Notes User Contributed Notes