Функция get_the_post_thumbnail_caption() позволяет получить подпись (caption) миниатюры записи в WordPress. Это может быть полезно, если вы хотите отобразить дополнительную информацию о миниатюре, такую как описание или контекст изображения.
get_the_post_thumbnail_caption( int|WP_Post $post = null ): stringФункция принимает один параметр:
$post(int|WP_Post) — ID записи или объект WP_Post. По умолчанию используется глобальная переменная$post.
Возвращаемое значение
- string — Возвращает подпись миниатюры записи. Если подпись отсутствует, функция вернет пустую строку.
Пример 1: Получение подписи миниатюры записи
В этом примере мы получим подпись для записи с ID 123:
$post_id = 123; // ID поста
$caption = get_the_post_thumbnail_caption($post_id);
if ($caption) {
echo '<p>Подпись к миниатюре: ' . esc_html($caption) . '</p>';
} else {
echo '<p>Подпись не установлена.</p>';
}
Пример 2: Использование функции в цикле
Когда вы работаете с циклом WordPress, можно использовать get_the_post_thumbnail_caption() для каждой записи:
if (have_posts()) :
while (have_posts()) :
the_post();
// Получаем подпись миниатюры текущей записи
$thumbnail_caption = get_the_post_thumbnail_caption();
if ($thumbnail_caption) {
echo '<h2>' . get_the_title() . '</h2>'; // Заголовок записи
echo '<p>Подпись: ' . esc_html($thumbnail_caption) . '</p>';
} else {
echo '<h2>' . get_the_title() . '</h2>';
echo '<p>Подпись отсутствует.</p>';
}
// Здесь вы можете вывести миниатюру
the_post_thumbnail('thumbnail');
endwhile;
endif;
Заключение
Функция get_the_post_thumbnail_caption() предоставляет простой и удобный способ получения подписи миниатюры записи в WordPress. Вы можете использовать её для добавления контекста к изображениям и улучшения пользовательского опыта на вашем сайте. Используйте приведенные выше примеры, чтобы интегрировать эту функцию в свои темы и плагины, обеспечивая более информативное представление изображений.