set_post_thumbnail_size()
Устанавливает дефолтный размер миниатюры поста.
Регистрирует или переопределят параметры размера миниатюры post-thumbnail, который в WP используется в качестве миниатюры поста.
После установки этой функции, миниатюру можно получить через get_the_post_thumbnail():
echo get_the_post_thumbnail( $page->ID );
Это обертка для функции add_image_size() с предустановленным названием размера для миниатюры 'post-thumbnail'. Функция нужна для того, чтобы название размера миниатюры не менялось - оно должно оставаться именно таким.
Чтобы для поста можно было определить картинку миниатюру, нужно активировать эту возможность функцией: add_theme_support( 'post-thumbnails' ) в файле шаблона funсtions.php.
Чтобы зарегистрировать новый размер миниатюры, используйте add_image_size().
Хуков нет.
Возвращает
null. Функция ничего не возвращает.
Использование
set_post_thumbnail_size( $width, $height, $crop );
- $width(число)
- Ширина миниатюры (в пикселях).
- $height(число)
- Высота миниатюры (в пикселях).
- $crop(логический)
- Кадрировать изображение (true - будет взят кусок картинки по указаным размерам) или просто уменьшать (false - картинка будет уменьшена пропорционально, лишнее отрезано).
По умолчанию: false
Примеры
Все примеры предназначены для использования в файле темы functions.php.
#1 Базовый пример
Определим использование миниатюр в шаблоне и укажем размеры миниатюры поста:
if ( function_exists( 'add_theme_support' ) ) {
add_theme_support( 'post-thumbnails' );
set_post_thumbnail_size( 150, 150 );
} #2 Кадрирование
Уменьшение размера: установим размер миниатюры по умолчанию в 50х50 пикселей. Картинка будет уменьшена по наименьшей стороне. У большей стороны, края будут обрезаны.
set_post_thumbnail_size( 50, 50 ); // уменьшение картинки
Кадрирование: установим размер миниатюры по умолчанию в 50х50 пикселей. Картинка будет кадрирована: будет взята центральная часть картинки размером 50х50 пикселей:
set_post_thumbnail_size( 50, 50, true ); // кадрирование
Заметки
- Смотрите: add_image_size() for details on cropping behavior.
Список изменений
| С версии 2.9.0 | Введена. |
Код set_post_thumbnail_size() set post thumbnail size WP 6.9.1
function set_post_thumbnail_size( $width = 0, $height = 0, $crop = false ) {
add_image_size( 'post-thumbnail', $width, $height, $crop );
}