get_the_post_thumbnail с версии 2.9.0

Описание

Получает html код (img) миниатюры поста, если она существует.

Получает миниатюру поста, которая установлена на странице редактирования записи и формирует html код картинки на основе полученной ссылки на миниатюру. Если миниатюру получить не удалось (её не существует), то будет возвращен пустой результат (null).

Заметка! Чтобы для поста можно было определить картинку миниатюру, нужно активировать эту возможность функцией -add_theme_support( 'post-thumbnails' ); в файле шаблона funсtions.php.

get_the_post_thumbnail() используется в: the_post_thumbnail().

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

<?php echo get_the_post_thumbnail( $id, $size, $attr ); ?>

Параметры

$id (число) (обязательный)

ID поста, миниатюру которого надо получить.
По умолчанию: null (ID текущего поста)

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

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

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

Строка в виде запроса или массив аргументов, которые определят атрибуты тега img, который создается функцией.

$default_attr = array(
	'src'	=> $src,
	'class'	=> "attachment-$size",
	'alt'	=> trim(strip_tags( $attachment->post_excerpt )),
	'title'	=> trim(strip_tags( $attachment->post_title )),
);

По умолчанию: ''

Примеры

1. Базовый пример использования.

<?php $pages = get_pages(array('child_of' => 1)); ?>
<ul>
    <?php foreach ($pages as $page): ?>
        <li>
            <?php echo get_the_post_thumbnail($page->ID, 'thumbnail'); ?>
            <h1><?php echo $page->post_title; ?></h1>
            <?php echo $page->post_content; ?>
        </li>
    <?php endforeach; ?>
</ul>

2. Размеры миниатюр.
Размеры для картинок в WordPress обозначаются условно:
thumbnail - маленькая миниатюра;
medium - средняя;
large - большая;
full - оригинал, картинка которую мы загружали.

Указать конкретные размеры в пикселях для каждого типа можно в настройках (Параметры> мадиафайлы).

Этот пример показывает как можно получить картинку нужного нам размера:

get_the_post_thumbnail( $id );         // без параметра $size

get_the_post_thumbnail( $id, 'thumbnail' );     // маленькая миниатюра
get_the_post_thumbnail( $id, 'medium' );        // среднего размера
get_the_post_thumbnail( $id, 'large' );         // большого размера

get_the_post_thumbnail( $id, array(100,100) ); // произвольный размер

3. Стилизация миниатюр.
Миниатюры создаваемые функцией get_the_post_thumbnail() получают класс wp-post-image (class="wp-post-image"). Также, устанавливается класс в зависимости от размера миниатюры. В CSS миниатюры стилизуются через следующие селекторы:

img.wp-post-image
img.attachment-thumbnail
img.attachment-medium
img.attachment-large
img.attachment-full

Также можно задать свой класс:

<?php echo get_the_post_thumbnail($id, 'thumbnail', array('class' => 'alignleft')); ?>

get_the_post_thumbnail()

function get_the_post_thumbnail( $post_id = null, $size = 'post-thumbnail', $attr = '' ) {
	$post_id = ( null === $post_id ) ? get_the_ID() : $post_id;
	$post_thumbnail_id = get_post_thumbnail_id( $post_id );
	$size = apply_filters( 'post_thumbnail_size', $size );
	if ( $post_thumbnail_id ) {
		do_action( 'begin_fetch_post_thumbnail_html', $post_id, $post_thumbnail_id, $size ); // for "Just In Time" filtering of all of wp_get_attachment_image()'s filters
		if ( in_the_loop() )
			update_post_thumbnail_cache();
		$html = wp_get_attachment_image( $post_thumbnail_id, $size, false, $attr );
		do_action( 'end_fetch_post_thumbnail_html', $post_id, $post_thumbnail_id, $size );
	} else {
		$html = '';
	}
	return apply_filters( 'post_thumbnail_html', $html, $post_id, $post_thumbnail_id, $size, $attr );
}

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

Ещё из раздела

Смотрите также: Функции WordPress и Теги Шаблона.

Вы наверняка не раз слышали аббревиатуры UPS, ИБП, если до сих пор не знаете к чему это относится, то пора разбираться и вообще иметь эти вещи у себя дома, ведь компьютер у вас точно есть! ИБП расшифровывается как - Источник Бесперебойного Питания и нужен он для защиты электроприборов от скачков в напряжении, так же их называют ac dc преобразователи. вещь крайне нужная, особенно для компьютеров, ведь зачастую в поломке компьютера виноваты именно перепады напряжения в сети.