WordPress как на ладони
Недорогой хостинг для сайтов на WordPress: wordpress.jino.ru

the_post_thumbnail_caption() WP 4.6.0

Выводит на экран описание (caption) миниатюры записи (поста).

Подпись указывается при редактировании картинки в админ-панели:

подпись вложения

Если нужно получить подпись для последующей обработки в PHP, используйте функцию: get_the_post_thumbnail_caption()

Работает на основе: get_the_post_thumbnail_caption()
✈ 1 раз = 0.001038с = очень медленно | 50000 раз = 1.91с = быстро | PHP 7.0.8, WP 4.6
Хуки из функции
Возвращает

Ничего. Выводит текст на экран.

Использование

the_post_thumbnail_caption( $post );
$post(число/WP_Post)
ID или объект записи, подпись миниатюры которого нужно вывести на экран.
По умолчанию: null (текущий пост)

Примеры

#1 Выведем подпись миниатюры записи

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

<?php the_post_thumbnail_caption( 6462 ); ?>

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

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

Код the post thumbnail caption: wp-includes/post-thumbnail-template.php WP 5.4.2

<?php
function the_post_thumbnail_caption( $post = null ) {
	/**
	 * Filters the displayed post thumbnail caption.
	 *
	 * @since 4.6.0
	 *
	 * @param string $caption Caption for the given attachment.
	 */
	echo apply_filters( 'the_post_thumbnail_caption', get_the_post_thumbnail_caption( $post ) );
}

Cвязанные функции

Из метки: thumbnail (image картинки-миниатюры)

Еще из раздела: Миниатюры

1 коммент
  • @ Сурен rianovost.ru

    Здравствуйте! У меня такая проблема, при создании записи когда добавлю изображение, иногда приходится из подписать, как-бы все хорошо и подпись настроил курсивом, серый и мелкий шрифт и середина, это всё в записи все хорошо получается. Но когда выводятся записи на главной (причём неважно сеткой или анонсом), caption выводится обычным текстом вместе с except. Но это ещё не всё, когда поделюсь записью в социальных сетях, вместе с заголовком выводится описание изображения, что и не очень приятно. Подскажите, пожалуйста как избавится? Рассмотрю вариант, что подпись изображения вообще не выводился на главной если уж не получается выводить её в корректном формате.
    Сайт rianovost.ru

    Ответить2.Май.2020 16:45 #