Функция the_post_thumbnail_url() в WordPress: применение, производительность, примеры

## Функция the_post_thumbnail_url() │ WP 4.4.0

Эта функция выводит URL миниатюры поста.

### Использует

Функция get_the_post_thumbnail_url()

### Производительность

- 1 раз — 0.002188 сек (очень медленно) 
- 50000 раз — 17.96 сек (м��дленно) 
- PHP 7.0.5, WP 4.4.2

### Хуки

Отсутствуют.

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

- null — ничего (null).

## Применение

```php
the_post_thumbnail_url( $size );

Параметры

• $size (string|int[]) — Размер изображения. Принимает любой допустимый размер изображения или массив значений ширины и высоты в пикселях (в этом порядке).
• По умолчанию: 'post-thumbnail'

Примеры

Пример 1: Вывод URL миниатюры поста

the_post_thumbnail_url( 'thumbnail' );
// выводит
// http://example.com/wp-content/uploads/2016/03/post-meta-fields4-80x80.png

Пример 2: Использование миниатюры в качестве фонового изображения для элемента div

Вы можете добавить свой собственный пример.

История изменений

• С версии 4.4.0 — впервые введена.

Код функции the_post_thumbnail_url()

function the_post_thumbnail_url( $size = 'post-thumbnail' ) {
    $url = get_the_post_thumbnail_url( null, $size );

    if ( $url ) {
        echo esc_url( $url );
    }
}

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

Для работы с миниатюрами постов

• delete_post_thumbnail()
• get_post_thumbnail_id()
• get_the_post_thumbnail()
• get_the_post_thumbnail_caption()
• get_the_post_thumbnail_url()
• has_post_thumbnail()
• set_post_thumbnail()
• set_post_thumbnail_size()
• the_post_thumbnail()
• the_post_thumbnail_caption()

Для работы с изображениями

• add_image_size()
• get_intermediate_image_sizes()
• has_image_size()
• image_downsize()
• image_get_intermediate_size()
• remove_image_size()
• wp_get_attachment_image_url()
• wp_get_image_editor()
• wp_get_original_image_path()
• wp_get_original_image_url()

Для работы с ссылками (URL)

• admin_url()
• attachment_url_to_postid()
• build_query()
• comment_link()
• content_url()
• get_comments_link()
• get_edit_post_link()
• home_url()
• site_url()

Для работы с миниатюрами

• wp_get_additional_image_sizes()
• wp_get_attachment_thumb_url()