set_post_format()

为帖子指定格式

原型

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

参数

$post (int|object) (Required) 要为其分配格式的帖子。

$format (string) (Required) 要分配的格式。使用空字符串或数组从帖子中删除所有格式。

返回值

(array|WP_Error|false)  

源文件

路径：wp-includes/post-formats.php

<?php
...
function set_post_format( $post, $format ) {
	$post = get_post( $post );
	if ( empty( $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' );
}
...
?>

其他

英文文档：https://developer.wordpress.org/reference/functions/set_post_format/