get_post_format( int|WP_Post|null $post = null ): string|false

Retrieve the format slug for a post

Contents

Parameters

$post int|WP_Post|null Optional
Post ID or post object. Defaults to the current post in the loop.

Default: null

Top ↑

Return

string|false The format if successful. False otherwise.

Top ↑

More Information

This will usually be called in the the loop, but can be used anywhere if a post ID is provided.

The set of currently defined formats are:

  • aside
  • chat
  • gallery
  • link
  • image
  • quote
  • status
  • video
  • audio

Note also that the default format (i.e., a normal post) returns false, but this is also referred in some places as the ‘standard’ format. In some cases, developers may wish to do something like the following to maintain consistency:

$format = get_post_format() ? : 'standard';

 

 

Top ↑

Source

File: wp-includes/post-formats.php. View all references 

function get_post_format( $post = null ) {
	$post = get_post( $post );

	if ( ! $post ) {
		return false;
	}

	if ( ! post_type_supports( $post->post_type, 'post-formats' ) ) {
		return false;
	}

	$_format = get_the_terms( $post->ID, 'post_format' );

	if ( empty( $_format ) ) {
		return false;
	}

	$format = reset( $_format );

	return str_replace( 'post-format-', '', $format->slug );
}

View on Trac View on GitHub

Top ↑

Top ↑

Used By

Used By
Used By Description
WP_REST_Posts_Controller::prepare_item_for_response() wp-includes/rest-api/endpoints/class-wp-rest-posts-controller.php

Prepares a single post output for response.
get_embed_template() wp-includes/template.php

Retrieves an embed template path in the current or parent template.
get_inline_data() wp-admin/includes/template.php

Adds hidden fields with the data for use in the inline editor for posts and pages.
post_format_meta_box() wp-admin/includes/meta-boxes.php

Displays post format form elements.
get_post_class() wp-includes/post-template.php

Retrieves an array of the class names for the post container element.
get_body_class() wp-includes/post-template.php

Retrieves an array of the class names for the body element.
wp_xmlrpc_server::mw_getPost() wp-includes/class-wp-xmlrpc-server.php

Retrieve post.
wp_xmlrpc_server::mw_getRecentPosts() wp-includes/class-wp-xmlrpc-server.php

Retrieve list of recent posts.
wp_xmlrpc_server::_prepare_post() wp-includes/class-wp-xmlrpc-server.php

Prepares post data for return in an XML-RPC object.
_WP_Editors::editor_settings() wp-includes/class-wp-editor.php
Show 5 more used by Hide more used by

Top ↑

Changelog

Changelog
Version Description
3.1.0 Introduced.

Top ↑

User Contributed Notes

  1. Skip to note 1 content
    You must log in to vote on the helpfulness of this noteVote results for this note: 3You must log in to vote on the helpfulness of this note
    Contributed by Codex —

    Usage in Templates

    /*
 * Pull in a different sub-template, depending on the Post Format.
 * 
 * Make sure that there is a default format.php file to fall back to as a default.
 * Name templates format-link.php, format-aside.php, etc.
 *
 * You should use this in the loop.
 */
get_template_part( 'format', get_post_format() );

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