функция
since 3.1.0
set_post_format()
Проверено на WordPress 6.9, обновлено Источник: WordPress Developer Resources.
Сигнатура
set_post_format( int|WP_Post $post, string $format ): array|WP_Error|false
Описание
Назначает формат записи
Параметры
$post
int|WP_Post
обязательный
Запись, которой назначается формат.
$format
string
обязательный
Назначаемый формат. Используйте пустую строку или массив, чтобы удалить все форматы у записи.
Возвращаемое значение
array|WP_Error|false
WP_Error
Исходный код
wp-includes/post-formats.php:70
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(), true ) ) {
$format = '';
} else {
$format = 'post-format-' . $format;
}
}
return wp_set_post_terms( $post->ID, $format, 'post_format' );
}
История изменений
| Версия | Описание |
|---|---|
| 3.1.0 | Introduced. |

