the_post_thumbnail

Выводит html код картинки-миниатюры поста.

Дополнительный размер картинки, которую затем можно получить с помощью этой функции, можно создать через add_image_size(). По умолчанию доступны следующие размеры: thumbnail, medium, large, full, post-thumbnail.

Этот Тег шаблона должен использоваться внутри Цикла WordPress.
✈ 1 раз = 0.003724с = очень медленно | 50000 раз = 41.51с = очень медленно

Хуков нет.

Возвращает

Ничего – выводит на экран строку. Функция выводит на экран html код картинки или пустое значение (null), если картинки не существует.

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

<?php the_post_thumbnail( $size, $attr ); ?>
$size(строка/массив)

Размер миниатюры, которую нужно получить. Может быть строкой: thumbnail, medium, large, full или массивом из двух элементов (ширина и высота картинки): array(32, 32).

Когда указан массив, новая миниатюра с указанными размерами не создается. А WP ищет самый подходящий размер из тех что уже есть, берет его и просто указывает высоту и ширину в пикселях для тега IMG, чтобы уменьшить картинку. Т.е. картинка уменьшается только визуально.

По умолчанию: ‘post-thumbnail’, размер который устанавливается для темы функцией set_post_thumbnail_size()

$attr(строка/массив)

Массив атрибутов, которые нужно добавить получаемому html тегу img. Можно указать строкой: alt=альтернативное название&class=alignleft или массивом:

<?php if ( has_post_thumbnail()) { ?>
   <a href="<?php the_permalink(); ?>" title="<?php the_title_attribute(); ?>" >
   <?php the_post_thumbnail(); ?>
   </a>
 <?php } ?>

#2: Сделаем миниатюру ссылкой на пост

Для этого используем хук post_thumbnail_html. В этом случае картинка будет ссылкой на пост сразу при вызове функции the_post_thumbnail();. Код нужно добавлять в файл шаблона functions.php:

<?php
 if ( has_post_thumbnail()) {
   $large_image_url = wp_get_attachment_image_src( get_post_thumbnail_id(), 'large');
   echo '<a href="' . $large_image_url[0] . '" title="' . the_title_attribute('echo=0') . '" >';
   the_post_thumbnail('thumbnail');
   echo '</a>';
 }
 ?>

#4 Регистрация нового размера

С помощью add_image_size() можно зарегистрировать новый размер и затем получить его по ключу:

// допустим в functions.php мы регистрируем дополнительный размер так:
add_image_size( 'spec_thumb', 360, 240, true );

// далее в цикле выводим этот размер так:
the_post_thumbnail( 'spec_thumb' );

Код из


wp-includes/post-thumbnail-template.php

WP 4.7.2

<?php
function the_post_thumbnail( $size = 'post-thumbnail', $attr = '' ) {
	echo get_the_post_thumbnail( null, $size, $attr );
}

Комментарии:


Оставить комментарий

Your email address will not be published. Required fields are marked *