get_the_post_thumbnail_caption() WP 4.6.0
Получает описание (caption) миниатюры записи (поста).
Чтобы сразу вывести подпись на экран, используйте функцию: the_post_thumbnail_caption().
Работает на основе: wp_get_attachment_caption()
Основа для: the_post_thumbnail_caption()
1 раз — 0.001914 сек (очень медленно) | 50000 раз — 0.85 сек (очень быстро) | PHP 7.0.8, WP 4.6
Хуков нет.
Возвращает
Строку. Подпись миниатюры записи.
Использование
get_the_post_thumbnail_caption( $post );
- $post(число/WP_Post)
- ID или объект записи (поста), подпись миниатюры которого нужно получить.
По умолчанию: null (текущий пост)
Примеры
#1 Получим подпись миниатюры записи
Функция выведет пустую строку если у миниатюры нет подписи. Не надо путать заголовок картинки и её подпись...
echo get_the_post_thumbnail_caption( 6462 );

Список изменений
С версии 4.6.0 | Введена. |
Код get_the_post_thumbnail_caption() get the post thumbnail caption WP 5.6.2
function get_the_post_thumbnail_caption( $post = null ) {
$post_thumbnail_id = get_post_thumbnail_id( $post );
if ( ! $post_thumbnail_id ) {
return '';
}
$caption = wp_get_attachment_caption( $post_thumbnail_id );
if ( ! $caption ) {
$caption = '';
}
return $caption;
}