Функция get_the_post_thumbnail() в WordPress используется для получения HTML-кода миниатюры (изображения) поста. Эта функция особенно полезна, когда вы хотите отображать изображения, связанные с вашими записями. Давайте рассмотрим её параметры и возможности более подробно.
get_the_post_thumbnail( int|WP_Post $post = null, string|int[] $size = 'post-thumbnail', string|array $attr = '' ): string
Параметры:
- $post (optional): ID поста или объект
WP_Post. По умолчанию используется глобальный объект$post. - $size (optional): Размер изображения. Можно указать любой зарегистрированный размер изображения или массив с шириной и высотой в пикселях. По умолчанию используется размер
'post-thumbnail'. - $attr (optional): Строка или массив атрибутов для тега
<img>. По умолчанию пусто.
Возврат: Возвращает HTML-код изображения поста или пустую строку, если миниатюра отсутствует.
Базовый пример: получение миниатюры поста
$post_id = 123; // замените на ID вашего поста
echo get_the_post_thumbnail($post_id);
Получение миниатюры с указанием размера
$post_id = 456; // замените на ID вашего поста
echo get_the_post_thumbnail($post_id, 'medium');
Получение миниатюры с пользовательскими размерами
$post_id = 789; // замените на ID вашего поста
echo get_the_post_thumbnail($post_id, array(150, 150));
Добавление классов к миниатюре
$post_id = 101112; // замените на ID вашего поста
echo get_the_post_thumbnail($post_id, 'thumbnail', array('class' => 'custom-class'));
Вывод миниатюр с заголовками и содержимым
<?php
$pages = get_pages(array('parent' => 0)); // Получаем все родительские страницы
?>
<ul>
<?php foreach ($pages as $page): ?>
<li>
<?php echo get_the_post_thumbnail($page->ID, 'thumbnail'); ?>
<h1><?php echo get_the_title($page); ?></h1>
<?php echo get_the_excerpt($page); ?>
</li>
<?php endforeach; ?>
</ul>
В этом примере мы выводим список всех родительских страниц с их миниатюрами, заголовками и аннотациями.
Стилизация миниатюр
Миниатюры получают класс wp-post-image, который можно использовать для стилизации изображений. Вы также можете использовать CSS для управления отображением изображений, применяя классы, такие как:
img.wp-post-image {
border: 1px solid #ccc;
}
img.attachment-thumbnail {}
img.attachment-medium {}
img.attachment-large {}
img.attachment-full {}
Поддержка миниатюр в теме
Чтобы использовать миниатюры в вашей теме, необходимо активировать поддержку с помощью следующей функции в файле functions.php вашей темы:
add_theme_support('post-thumbnails');
Заключение
Функция get_the_post_thumbnail() является мощным инструментом для работы с изображениями в WordPress. Она позволяет легко выводить миниатюры постов с возможностью настройки размера и добавления атрибутов. Используйте эту функцию, чтобы сделать ваши записи более визуально привлекательными!