WordPress.org

Codex

Interested in functions, hooks, classes, or methods? Check out the new WordPress Code Reference!

Function Reference/has post format

Description

Returns a boolean if the specified post format is assigned (true) or not (false) to the post. This will usually be called in the the loop, but can be used anywhere if a post ID is provided.

Usage

<?php $format has_post_format($format,$post_id); ?>

Parameters

$format
(string|array) (Required) name of the post format or array of names of post formats.
Default: none
$post_id
(integer) (Optional) ID of the post.
Default: current loop post

Example

<?php
/*
 * Do something if the post format is a gallery
 */

if ( has_post_format('gallery') ) {
  // Do something
}
?>

Changelog

Source File

has_post_format() is located in wp-includes/post-formats.php.

Post Formats: set_post_format(), get_post_format(), has_post_format(), get_post_format_link(), get_post_format_string(), the_post_format_audio(), get_the_post_format_media(), get_content_audio(), the_post_format_chat(), get_the_post_format_chat(), get_content_chat(), add_chat_detection_format(), the_post_format_gallery(), get_content_galleries(), get_post_gallery_images(), the_post_format_image(), get_the_post_format_image(), get_content_images(), the_post_format_quote(), get_the_post_format_quote(), get_content_quote(), the_post_format_url(), get_the_post_format_url(), get_content_url(), the_post_format_video(), get_content_video(), the_remaining_content(), get_the_remaining_content(), get_post_format_meta(), post_format_content_class(), get_post_format_content_class(), post_formats_compat()

See also index of Function Reference and index of Template Tags.