WP_GET_ATTACHMENT_THUMB_URL() │ WP 2.1.0

Функция для получения URL миниатюры вложения.

Основные характеристики

• Используется в: image_downsize()
• Время выполнения:
  • 1 раз — 0.001119 сек (очень медленно)
  • 50000 раз — 6.09 сек (быстро)
• PHP версия: 7.0.8, WP 4.6

Хуки функции

• wp_get_attachment_thumb_url

Возвращаемое значение

• Строка|false: URL миниатюры при успешном выполнении или false в случае ошибки.

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

wp_get_attachment_thumb_url( $post_id );

• $post_id (int): ID вложения. По умолчанию: ID глобальной переменной $post.

Примеры

Пример 1: Получение ссылки на миниатюру изображения

Предположим, у нас есть изображение с ID 7412 в медиабиблиотеке, и нам нужно получить URL его миниатюры (самого маленького размера):

$thumburl = wp_get_attachment_thumb_url( 7412 );

echo $thumburl; //> http://example.com/wp-content/uploads/2016/09/Upravlenie-setyu-80x80.png

Изменения

• С версии 2.1.0: Введена в использование.
• С версии 6.1.0: Изменена на использование функции wp_get_attachment_image_url().

Код функции

Функция для получения URL миниатюры вложения выглядит следующим образом:

function wp_get_attachment_thumb_url( $post_id = 0 ) {
$post_id = (int) $post_id;

/*
 * Эта функция использует image_downsize(),
 * которая также ищет старый формат $image_meta['thumb'],
 * если новый формат $image_meta['sizes']['thumbnail'] не существует.
 */
$thumbnail_url = wp_get_attachment_image_url( $post_id, 'thumbnail' );

if ( empty( $thumbnail_url ) ) {
    return false;
}

/**
 * Фильтрует URL миниатюры вложения.
 *
 * @since 2.1.0
 *
 * @param string $thumbnail_url URL для миниатюры вложения.
 * @param int    $post_id       ID вложения.
 */
return apply_filters( 'wp_get_attachment_thumb_url', $thumbnail_url, $post_id );

}

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

• wp_attachment_is_image()
• wp_get_attachment_caption()
• wp_get_attachment_image()
• wp_get_attachment_image_sizes()
• wp_get_attachment_image_src()
• wp_get_attachment_image_srcset()
• wp_get_attachment_image_url()
• wp_get_attachment_url()

Миниатюры

• add_image_size()
• delete_post_thumbnail()
• get_intermediate_image_sizes()
• get_post_thumbnail_id()
• get_the_post_thumbnail()
• get_the_post_thumbnail_caption()
• get_the_post_thumbnail_url()
• has_image_size()
• has_post_thumbnail()
• image_get_intermediate_size()
• remove_image_size()
• set_post_thumbnail()
• set_post_thumbnail_size()
• the_post_thumbnail()
• the_post_thumbnail_caption()
• the_post_thumbnail_url()
• wp_get_additional_image_sizes()
• wp_get_image_editor()
• wp_get_registered_image_subsizes()

Эта статья предоставляет основные сведения о функции WP_GET_ATTACHMENT_THUMB_URL, помогая понять, как использовать ее для получения URL миниатюры изображения.