Функция wp_get_attachment_thumb_url() в WordPress используется для получения URL миниатюры изображения-вложения (attachment). Она возвращает ссылку на изображение самого маленького размера, зарегистрированного в системе — это размер «thumbnail».
wp_get_attachment_thumb_url( int $post_id ): string|false
Параметры:
$post_id(int, необязательный) — ID медиафайла. По умолчанию используется ID текущего поста, если он не задан явно.
Возвращаемое значение:
- Возвращает строку с URL миниатюры на успехе или
falseв случае неудачи.
Пример 1: Получение URL миниатюры по ID медиафайла
Этот пример показывает, как получить URL миниатюры изображения с известным ID, например, 25.
<?php
$thumb_id = 25;
$thumb_url = wp_get_attachment_thumb_url( $thumb_id );
if ( $thumb_url ) {
echo '<img src="' . esc_url( $thumb_url ) . '" alt="Thumbnail">';
} else {
echo 'Миниатюра не найдена.';
}
?>
Пример 2: Использование миниатюры изображения текущего поста
Если не указывать $post_id, функция попытается получить миниатюру для изображения, связанного с текущим постом. Это удобно при работе с медиафайлами внутри цикла.
<?php
// Внутри цикла WordPress
if ( has_post_thumbnail() ) {
$thumb_url = wp_get_attachment_thumb_url();
if ( $thumb_url ) {
echo '<img src="' . esc_url( $thumb_url ) . '" alt="Thumbnail">';
}
}
?>
Как это работает
Функция опирается на внутренние механизмы WordPress для обработки изображений, такие как image_downsize(). Она возвращает самый маленький зарегистрированный размер изображения, обычно это размер, называемый «thumbnail».
Заключение
Функция wp_get_attachment_thumb_url() является удобным способом получить URL миниатюры изображения в WordPress, особенно при разработке тем и плагинов. Она проста в использовании и обеспечивает доступ к самому маленькому зарегистрированному размеру изображения в системе.