描述:
设置文章的类型格式
用法:
<?php set_post_format( $post , $format); ?>
参数:
$post
(int or object) (必填) 文章ID
默认值: none
$format
(string or array) (必填) 文章类型。使用空字符串或数组从日志中删除所有格式。
默认值: none
源文件:
/**
* Assign a format to a post
*
* @since 3.1.0
*
* @param int|object $post The post for which to assign a format.
* @param string $format A format to assign. Use an empty string or array to remove all formats from the post.
* @return array|WP_Error|false WP_Error on error. Array of affected term IDs on success.
*/
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' );
}