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 (текущий пост)

Примеры

0

#1 Получим подпись миниатюры записи

Функция выведет пустую строку если у миниатюры нет подписи. Не надо путать заголовок картинки и её подпись...

echo get_the_post_thumbnail_caption( 6462 );
подпись вложения

Список изменений

С версии 4.6.0 Введена.

Код get_the_post_thumbnail_caption() WP 6.5.2

wp-includes/post-thumbnail-template.php 
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;
}

post_thumbnail image (картинки миниатюры поста)

thumbnail (image картинки-миниатюры)

Миниатюры