get_the_post_thumbnail_url()
Получает URL установленной для записи миниатюры. Если миниатюры нет, то вернет false.
Работает на основе: get_post_thumbnail_id(), wp_get_attachment_image_url()
Основа для: the_post_thumbnail_url()
1 раз — 0.001901 сек (очень медленно) | 50000 раз — 18 сек (медленно) | PHP 7.0.5, WP 4.4.2
Хуки из функции
Возвращает
Строку|false. URL миниатюры записи или false, если миниатюра для записи не установлена.
Использование
get_the_post_thumbnail_url( $post, $size );
- $post(число/WP_Post)
- ID/объект записи.
По умолчанию: текущий пост - $size(строка/массив)
- Название зарегистрированного размера миниатюры:
thumbnail,medium,largeилиfull, или размеры картинки в виде массива с шириной и высотой:array(200, 300).
По умолчанию: 'post-thumbnail'
Примеры
#1 Получим URL миниатюры записи
echo get_the_post_thumbnail_url( 6732, 'thumbnail' ); // вернет // http://wp-kama.ru/wp-content/uploads/2016/03/post-meta-fields4-80x80.png
#2 Не игнорируйте первый параметр.
Правильное использование этой функции внутри цикла:
if ( have_posts() ) : while ( have_posts() ) : the_post(); // grab the url for the full size featured image $featured_img_url = get_the_post_thumbnail_url( get_the_ID(), 'full' ); // link thumbnail to full size image for use with lightbox echo '<a href="'. esc_url( $featured_img_url ) .'" rel="lightbox">'; the_post_thumbnail( 'thumbnail' ); echo '</a>'; endwhile; endif;
Список изменений
| С версии 4.4.0 | Введена. |
Код get_the_post_thumbnail_url() get the post thumbnail url WP 6.7.1
function get_the_post_thumbnail_url( $post = null, $size = 'post-thumbnail' ) {
$post_thumbnail_id = get_post_thumbnail_id( $post );
if ( ! $post_thumbnail_id ) {
return false;
}
$thumbnail_url = wp_get_attachment_image_url( $post_thumbnail_id, $size );
/**
* Filters the post thumbnail URL.
*
* @since 5.9.0
*
* @param string|false $thumbnail_url Post thumbnail URL or false if the post does not exist.
* @param int|WP_Post|null $post Post ID or WP_Post object. Default is global `$post`.
* @param string|int[] $size Registered image size to retrieve the source for or a flat array
* of height and width dimensions. Default 'post-thumbnail'.
*/
return apply_filters( 'post_thumbnail_url', $thumbnail_url, $post, $size );
}