get_post_format()
Возвращает формат (тип) поста, например: quote, status, video, audio.
Используется внутри Цикла WordPress.
1 раз — 0. сек (скорость света) | 50000 раз — 2.73 сек (быстро)
Хуков нет.
Возвращает
Строку|false. Формат поста или false.
Функция вернет false, если у поста не указан никакой формат, т.е. если это обычный пост. В некоторых случаях, вам может пригодится установить обычному посту формат standard, сделать это можно так:
$format = get_post_format(); if ( false === $format ) $format = 'standard';
Список базовых форматов постов в WP:
- aside
- chat
- gallery
- link
- image
- quote
- status
- video
- audio
Использование
$format = get_post_format( $post_id );
- $post_id(число)
- ID поста, формат которого нужно получить.
По умолчанию: текущий пост в цикле
Примеры
#1 Пример, который показывает как выводить разный контент для записей с различными форматами
Убедитесь, что в теме существует файл для формата по умолчанию: format.php и файлы для остальных форматов соответственно: format-link.php, format-aside.php и т.д.
Этот код нужно использовать внутри цикла WordPress:
$format = get_post_format(); get_template_part( 'format', $format );
Список изменений
| С версии 3.1.0 | Введена. |
Код get_post_format() get post format WP 6.5.2
function get_post_format( $post = null ) {
$post = get_post( $post );
if ( ! $post ) {
return false;
}
if ( ! post_type_supports( $post->post_type, 'post-formats' ) ) {
return false;
}
$_format = get_the_terms( $post->ID, 'post_format' );
if ( empty( $_format ) ) {
return false;
}
$format = reset( $_format );
return str_replace( 'post-format-', '', $format->slug );
}