set_post_format( int|object $post, string $format )

Assign a format to a post

Contents

Description Description

Parameters Parameters

$post

(int|object) (Required) The post for which to assign a format.

$format

(string) (Required) A format to assign. Use an empty string or array to remove all formats from the post.

Top ↑

Return Return

(array|WP_Error|false) WP_Error on error. Array of affected term IDs on success.

Top ↑

Source Source

File: wp-includes/post-formats.php 

function set_post_format( $post, $format ) {
	$post = get_post( $post );

	if ( ! $post ) {
		return new WP_Error( 'invalid_post', __( 'Invalid post.' ) );
	}

	if ( ! empty( $format ) ) {
		$format = sanitize_key( $format );
		if ( 'standard' === $format || ! in_array( $format, get_post_format_slugs() ) ) {
			$format = '';
		} else {
			$format = 'post-format-' . $format;
		}
	}

	return wp_set_post_terms( $post->ID, $format, 'post_format' );
}

Expand full source code Collapse full source code View on Trac

Top ↑

Changelog Changelog

Changelog
Version Description
3.1.0 Introduced.

Top ↑

Top ↑

Uses Uses

Uses
Uses Description
wp-includes/l10n.php: __()

Retrieve the translation of $text.
wp-includes/formatting.php: sanitize_key()

Sanitizes a string key.
wp-includes/post.php: wp_set_post_terms()

Set the terms for a post.
wp-includes/post.php: get_post()

Retrieves post data given a post ID or post object.
wp-includes/post-formats.php: get_post_format_slugs()

Retrieves the array of post format slugs.
wp-includes/class-wp-error.php: WP_Error::__construct()

Initialize the error.
Show 1 more use Hide more uses

Top ↑

Used By Used By

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

Creates a single post.
wp-includes/rest-api/endpoints/class-wp-rest-posts-controller.php: WP_REST_Posts_Controller::update_item()

Updates a single post.
wp-admin/includes/post.php: edit_post()

Update an existing post with values provided in $_POST.
wp-admin/includes/post.php: bulk_edit_posts()

Process the post data for the bulk editing of posts.
wp-admin/includes/post.php: get_default_post_to_edit()

Default post information to use when populating the “Write Post” form.
wp-includes/class-wp-xmlrpc-server.php: wp_xmlrpc_server::mw_editPost()

Edit a post.
wp-includes/class-wp-xmlrpc-server.php: wp_xmlrpc_server::mw_newPost()

Create a new post.
wp-includes/class-wp-xmlrpc-server.php: wp_xmlrpc_server::_insert_post()

Helper method for wp_newPost() and wp_editPost(), containing shared logic.
Show 3 more used by Hide more used by

Top ↑

User Contributed Notes User Contributed Notes

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