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 (поточний пост)

Приклади

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

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

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

список змін

З версії 4.6.0

Введено.

Код `wp_get_attachment_caption() wp get attachment caption` ^{WP 6.0.2}

wp-includes/post.php

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 );
}

wp_get_attachment_caption() │ WP 4.6.0

Хуки з функції

Приклади

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

список змін

Код wp_get_attachment_caption() wp get attachment caption WP 6.0.2

Зв’язані функції

wp_attachment image (картинки вкладення)

Зображення

Залишити відповідь Скасувати коментар

Код `wp_get_attachment_caption() wp get attachment caption` ^{WP 6.0.2}