get_the_post_thumbnail()

Извлекает миниатюру записи
Функция WordPress
INT 2.9.0
WordPress Icon
Содержание
  1. Описание функции
  2. Примеры использования
  3. Получение миниатюры поста с использованием стандартного размера
  4. Изменение размера миниатюры поста
  5. Добавление атрибутов к тегу изображения миниатюры поста
  6. Получение миниатюры поста с использованием пользовательского размера
  7. Получение миниатюры поста без указания размера
  8. Вопросы и ответы
  9. Как получить URL изображения миниатюры записи?
  10. Как изменить размер изображения миниатюры?
  11. Как добавить атрибуты к тегу изображения миниатюры?
  12. Как проверить, существует ли у записи миниатюра?
  13. Как получить альтернативный текст изображения миниатюры?
  14. Как вывести изображение миниатюры в качестве фонового изображения?
  15. Как изменить порядок вывода изображения миниатюры?
  16. Как удалить изображение миниатюры у записи?
  17. Как добавить свои размеры изображения миниатюры?
  18. Связанные элементы

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

Функция get_the_post_thumbnail() используется для получения миниатюры (постер) записи. Она возвращает HTML-код тега изображения, содержащего миниатюру записи.

Миниатюра записи — это изображение, которое может быть прикреплено к записи в WordPress. Она может быть использована для отображения превью записи на главной странице, в списке записей или в других местах, где требуется отображение изображения записи.

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

get_the_post_thumbnail( int|WP_Post $post = null, string|int[] $size = 'post-thumbnail', string|array $attr = '' ): string

Функция get_the_post_thumbnail() принимает три необязательных параметра: $post, $size и $attr.

$post — идентификатор записи или объект WP_Post. По умолчанию используется глобальная переменная $post.

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

$attr — строка запроса или массив атрибутов тега изображения. По умолчанию используется пустая строка.

Функция возвращает HTML-код тега изображения, содержащего миниатюру записи.

Тег изображения будет иметь следующую структуру:

<img src="путь_к_изображению" alt="альтернативный_текст" class="классы_изображения" width="ширина" height="высота" />
<?php
/**
 * Получение миниатюры записи и вывод ее HTML-кода.
 */
// Получаем объект текущей записи
$post = get_post();
// Получаем HTML-код миниатюры записи с размером 150x150 пикселей и классом "post-thumbnail"
$thumbnail = get_the_post_thumbnail( $post, array( 150, 150 ), 'post-thumbnail' );
// Выводим HTML-код миниатюры записи
echo $thumbnail;
?>

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

Получение миниатюры поста с использованием стандартного размера


$post_thumbnail = get_the_post_thumbnail();
echo $post_thumbnail;

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

Изменение размера миниатюры поста


$post_thumbnail = get_the_post_thumbnail( null, array( 200, 200 ) );
echo $post_thumbnail;

В данном примере используется функция get_the_post_thumbnail() с параметром $size, указывающим новый размер миниатюры. В данном случае, размер указан в виде массива с шириной и высотой в пикселях. Полученный тег изображения можно вывести с помощью функции echo.

Добавление атрибутов к тегу изображения миниатюры поста


$attributes = array(
    'class' => 'post-thumbnail',
    'alt' => 'Post Thumbnail',
);
$post_thumbnail = get_the_post_thumbnail( null, 'post-thumbnail', $attributes );
echo $post_thumbnail;

В данном примере используется функция get_the_post_thumbnail() с параметром $attr, указывающим атрибуты для тега изображения. В данном случае, указаны класс и альтернативный текст для изображения. Полученный тег изображения можно вывести с помощью функции echo.

Получение миниатюры поста с использованием пользовательского размера


$post_thumbnail = get_the_post_thumbnail( null, 'medium' );
echo $post_thumbnail;

В данном примере используется функция get_the_post_thumbnail() с параметром $size, указывающим пользовательский размер миниатюры. В данном случае, размер указан как «medium». Полученный тег изображения можно вывести с помощью функции echo.

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


$post_thumbnail = get_the_post_thumbnail();
echo $post_thumbnail;

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

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

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

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

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


$post_id = 123; // ID записи
$thumbnail_url = get_the_post_thumbnail_url($post_id);

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

Как изменить размер изображения миниатюры?

Для изменения размера изображения миниатюры в WordPress также используется функция get_the_post_thumbnail(). Вторым параметром этой функции можно указать размер изображения.

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


$post_id = 123; // ID записи
$thumbnail_url = get_the_post_thumbnail_url($post_id, array(200, 200));

В данном примере мы указываем ID записи и массив с шириной и высотой изображения (в пикселях). Функция get_the_post_thumbnail_url() вернет URL изображения миниатюры с указанными размерами.

Как добавить атрибуты к тегу изображения миниатюры?

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

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


$post_id = 123; // ID записи
$thumbnail = get_the_post_thumbnail($post_id, 'post-thumbnail', array('class' => 'thumbnail-image', 'alt' => 'Thumbnail Image'));

В данном примере мы указываем ID записи, размер изображения (в данном случае используется размер «post-thumbnail») и массив с атрибутами. Функция get_the_post_thumbnail() вернет HTML-код тега изображения миниатюры с указанными атрибутами.

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

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


if ( has_post_thumbnail() ) {
    // Код, который будет выполнен, если у записи есть миниатюра
} else {
    // Код, который будет выполнен, если у записи нет миниатюры
}

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

Для получения альтернативного текста изображения миниатюры можно использовать функцию get_post_meta() с аргументами get_the_ID() и '_wp_attachment_image_alt'. Она возвращает альтернативный текст изображения миниатюры.


$thumbnail_alt = get_post_meta( get_the_ID(), '_wp_attachment_image_alt', true );

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

Для вывода изображения миниатюры в качестве фонового изображения можно использовать функцию get_the_post_thumbnail_url() для получения URL изображения и применить его в CSS свойстве background-image.


.post-thumbnail {
    background-image: url('<?php echo get_the_post_thumbnail_url(); ?>');
}

Как изменить порядок вывода изображения миниатюры?

Для изменения порядка вывода изображения миниатюры в WordPress можно использовать функцию get_the_post_thumbnail() с параметром $attr. В параметре $attr можно указать атрибут style со значением order: 1;, чтобы изображение миниатюры было выведено первым в списке.


$attr = array(
    'style' => 'order: 1;'
);
echo get_the_post_thumbnail( $post, 'post-thumbnail', $attr );

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

Для удаления изображения миниатюры у записи в WordPress можно использовать функцию get_the_post_thumbnail() с параметром $size равным false.


echo get_the_post_thumbnail( $post, false );

Как добавить свои размеры изображения миниатюры?

Для добавления своих размеров изображения миниатюры в WordPress можно использовать функцию add_image_size(). В функции add_image_size() нужно указать имя размера, ширину и высоту изображения в пикселях.


add_image_size( 'custom-thumbnail', 300, 200 );

После добавления нового размера изображения можно использовать его в функции get_the_post_thumbnail() в параметре $size.


echo get_the_post_thumbnail( $post, 'custom-thumbnail' );

Функция get_the_post_thumbnail() в WordPress позволяет получить изображение миниатюры записи. С помощью параметров функции можно изменять порядок вывода изображения, удалять его или добавлять свои размеры. Это полезная функция для разработчиков WordPress, которая упрощает работу с изображениями в шаблонах.

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

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