wp_get_attachment_caption() WP 4.6.0

Отримує опис (підпис) вказаного вкладення-картинки.

Підпис та заголовок у вкладення – це різні речі, не плутайте їх:

підпис вкладення

Основа для:
get_the_post_thumbnail_caption()
1 раз – 0.000544 сек
(повільно) | 50000 разів – 0.36 сек
(дуже швидко) |
PHP 7.0.8, WP 4.6

Хуки з функції
wp_get_attachment_caption( $post_id );
$post
(число/WP_Post)
ID або об’єкт вкладення-картинки, підпис якої потрібно отримати.

Якщо не вказати і поточний запис не є вкладенням (attachment), функцію поверне false.


Типово: null (поточний пост)

Приклади

0

#1 Отримаємо підпис вкладення-картинки

Допустимо у нас є вкладення з ID 654 та підписом “Ось таку рибу я спіймав”, тоді:

echo wp_get_attachment_caption(654); //> виведе: Ось таку рибу я спіймав

список змін

З версії 4.6.0Введено.

Код wp_get_attachment_caption() WP 6.0.2

function wp_get_attachment_caption( $post_id = 0 ) { $post_id = (int) $post_id; $post = get_post($post_id); if (! $post) { return false; } if ( 'attachment' !== $post->post_type ) { return false; } $caption = $post->post_excerpt; /** * Filters the attachment caption. * * @ Since 4.6.0 * * @param string $caption Caption for given attachment. * @param int $post_id Attachment ID. */ return apply_filters( 'wp_get_attachment_caption', $caption, $post->ID ); }

Залишити відповідь

Ваша e-mail адреса не оприлюднюватиметься. Обов’язкові поля позначені *