set_post_format()
Встановлює формат запису .
Функція може бути використана скрізь, де існує об’єкт посту та включена підтримка форматів у темі.
Працює на основі:
wp_set_post_terms()
wp_set_post_terms()
Хуків немає.
Повертає
Массив|WP_Error|false. Масив ID всіх порушених термінів таксономії post-format . Або об’єкт WP_Error, якщо було вказано неправильний ID посту або неіснуючий об’єкт посту.
Використання
set_post_format($post, $format);
- $post
(число/об’єкт) (обов’язковий) - ID або пост, для якого потрібно встановити формат запису.
- $format
(рядок/масив) (обов’язковий) Формат посту, який буде встановлений для запису. Щоб видалити всі формати, вкажіть порожній рядок:
''. За замовчуванням можуть бути зареєстровані такі формати:aside
chat
gallery
link
image
quote
status
video
audio
Приклади
#1 Демонстрація
Встановимо формат ‘ gallery ‘ поточного посту в циклі ( $post->ID ):
set_post_format($post->ID, 'gallery');
список змін
| З версії 3.1.0 | Введено. |
Код set_post_format() set post format WP 6.0.2
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' );
}