the_post_thumbnail_url()

Отображает URL миниатюры записи
Функция WordPress
INT 4.4.0
WordPress Icon

Описание функции

Функция the_post_thumbnail_url() используется в WordPress для отображения URL-адреса миниатюры записи. Она возвращает URL-адрес миниатюры текущей записи, которая была установлена с помощью функции set_post_thumbnail() или через административную панель WordPress.

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

the_post_thumbnail_url( string|int[] $size = 'post-thumbnail' )

Функция the_post_thumbnail_url() принимает один параметр:

  • $size: строка или массив, опционально. Размер изображения, который нужно использовать. Принимает любой допустимый размер изображения или массив значений ширины и высоты в пикселях (в указанном порядке). По умолчанию установлен размер ‘post-thumbnail’.

/**
 * Выводит URL-адрес миниатюры текущей записи.
 *
 * @param string|int[] $size Размер изображения для использования.
 *                           По умолчанию: 'post-thumbnail'.
 */
the_post_thumbnail_url( 'medium' );

В приведенном выше примере кода используется функция the_post_thumbnail_url() для вывода URL-адреса миниатюры текущей записи с размером ‘medium’.

Примеры использования

Получение URL изображения поста


$image_url = get_the_post_thumbnail_url();
echo $image_url;

В данном примере используется функция get_the_post_thumbnail_url() для получения URL изображения поста. Результат сохраняется в переменную $image_url, а затем выводится с помощью функции echo. Функция get_the_post_thumbnail_url() возвращает URL изображения поста, если оно установлено, иначе возвращает пустую строку.

Изменение размера изображения


$image_url = get_the_post_thumbnail_url();
$thumbnail_url = wp_get_attachment_image_url( $image_url, 'thumbnail' );
echo $thumbnail_url;

В данном примере сначала получается URL изображения поста с помощью функции get_the_post_thumbnail_url(). Затем с помощью функции wp_get_attachment_image_url() изменяется размер изображения на размер миниатюры (‘thumbnail’). Результат сохраняется в переменную $thumbnail_url и выводится с помощью функции echo.

Получение URL изображения с заданными размерами


$image_url = get_the_post_thumbnail_url();
$custom_size_url = wp_get_attachment_image_url( $image_url, array( 800, 600 ) );
echo $custom_size_url;

В данном примере сначала получается URL изображения поста с помощью функции get_the_post_thumbnail_url(). Затем с помощью функции wp_get_attachment_image_url() изменяются размеры изображения на заданные (800 пикселей в ширину и 600 пикселей в высоту). Результат сохраняется в переменную $custom_size_url и выводится с помощью функции echo.

Получение URL изображения с альтернативным размером


$image_url = get_the_post_thumbnail_url();
$alt_size_url = wp_get_attachment_image_url( $image_url, 'medium_large' );
echo $alt_size_url;

В данном примере сначала получается URL изображения поста с помощью функции get_the_post_thumbnail_url(). Затем с помощью функции wp_get_attachment_image_url() изменяется размер изображения на альтернативный размер (‘medium_large’). Результат сохраняется в переменную $alt_size_url и выводится с помощью функции echo.

Получение URL изображения без указания размера


$image_url = get_the_post_thumbnail_url();
echo $image_url;

В данном примере используется функция get_the_post_thumbnail_url() для получения URL изображения поста без указания размера. Результат сохраняется в переменную $image_url, а затем выводится с помощью функции echo. Функция get_the_post_thumbnail_url() возвращает URL изображения поста, если оно установлено, иначе возвращает пустую строку.

Вопросы и ответы

Как получить URL миниатюры записи?

Для получения URL миниатюры записи в WordPress используется функция the_post_thumbnail_url(). Она отображает URL миниатюры текущей записи.


<?php the_post_thumbnail_url(); ?>

Как изменить размер миниатюры записи?

По умолчанию, функция the_post_thumbnail_url() выводит миниатюру записи с размером «post-thumbnail». Вы можете изменить размер миниатюры, передав соответствующий параметр в функцию.


<?php the_post_thumbnail_url( 'medium' ); ?>

Как получить URL миниатюры с определенными размерами?

Если вам необходимо получить URL миниатюры с определенными размерами, вы можете передать массив с шириной и высотой в пикселях в качестве параметра функции the_post_thumbnail_url().


<?php the_post_thumbnail_url( array( 500, 300 ) ); ?>

Как проверить, существует ли миниатюра записи?

Для проверки существования миниатюры записи в WordPress можно использовать функцию has_post_thumbnail(). Она возвращает true, если миниатюра существует, и false, если нет.


if ( has_post_thumbnail() ) {
    // Миниатюра существует
} else {
    // Миниатюра не существует
}

Как добавить класс к миниатюре записи?

Для добавления класса к миниатюре записи в WordPress можно использовать функцию the_post_thumbnail() с параметром class. Этот параметр принимает строку с классами, которые будут добавлены к тегу изображения.


the_post_thumbnail( 'post-thumbnail', array( 'class' => 'custom-class' ) );

Как изменить атрибуты миниатюры записи?

Для изменения атрибутов миниатюры записи в WordPress можно использовать функцию the_post_thumbnail() с параметром attr. Этот параметр принимает массив с атрибутами, которые будут добавлены к тегу изображения.


the_post_thumbnail( 'post-thumbnail', array( 'attr' => array( 'alt' => 'Custom Alt Text' ) ) );

Как получить URL миниатюры записи без вывода?

Функция the_post_thumbnail_url() возвращает URL миниатюры записи без ее вывода на страницу. Это может быть полезно, если вам нужно получить URL миниатюры для дальнейшей обработки или использования в коде.

Для получения URL миниатюры записи без вывода, используйте следующий код:


$thumbnail_url = get_the_post_thumbnail_url();

Как получить URL миниатюры записи в качестве фонового изображения?

Иногда требуется использовать миниатюру записи в качестве фонового изображения для элемента на странице. Функция the_post_thumbnail_url() может быть использована для получения URL миниатюры записи и использования его в CSS.

Для получения URL миниатюры записи в качестве фонового изображения, используйте следующий код:


.element {
    background-image: url(<?php the_post_thumbnail_url(); ?>);
}

Как использовать альтернативную миниатюру записи?

В WordPress можно определить несколько миниатюр для каждой записи. Функция the_post_thumbnail_url() по умолчанию возвращает URL миниатюры с идентификатором «post-thumbnail». Вы можете использовать альтернативную миниатюру, указав ее идентификатор в качестве параметра функции.

Для использования альтернативной миниатюры записи, используйте следующий код:


$thumbnail_url = get_the_post_thumbnail_url(get_the_ID(), 'custom-thumbnail');

В приведенном выше примере, ‘custom-thumbnail’ — это идентификатор альтернативной миниатюры. Вы можете заменить его на свой собственный идентификатор.

Функция the_post_thumbnail_url() позволяет получить URL миниатюры записи без ее вывода на страницу. Она также может быть использована для получения URL миниатюры в качестве фонового изображения или для использования альтернативной миниатюры записи.

Связанные элементы

  • Функция get_post_thumbnail_id(): Возвращает ID миниатюры записи.
  • Функция has_post_thumbnail(): Проверяет, имеет ли запись миниатюру.
  • Функция set_post_thumbnail(): Устанавливает миниатюру для указанной записи.
  • Хук post_thumbnail_html: Позволяет изменить HTML-код миниатюры записи перед выводом.
  • Хук post_thumbnail_size: Позволяет изменить размер миниатюры записи.
  • Класс WP_Post: Представляет объект записи и содержит методы для работы с ней, включая методы для работы с миниатюрами.
Обсуждение