Описание функции set_post_thumbnail_size()
Функция set_post_thumbnail_size() устанавливает размеры миниатюры записи для использования в теме. Она позволяет задать ширину и высоту миниатюр, которые будут применяться ко всем записям в WordPress. Эта функция используется в основном в файлах темы для настройки отображения изображений.
Функция также позволяет задать обрезку изображений, чтобы они вписывались в указанные размеры
Параметры
$width
Тип: int
Обязательный: Да
По умолчанию: 150
Описание: Ширина миниатюры в пикселях
Возможные значения:
$height
Тип: int
Обязательный: Да
По умолчанию: 150
Описание: Высота миниатюры в пикселях
Возможные значения:
$crop
Тип: bool
Обязательный: Нет
По умолчанию: true
Описание: Флаг, указывающий, обрезать ли изображение до заданных размеров
Возможные значения:
0: 1
1:
Возвращаемое значение
Тип: void
Описание: Функция не возвращает значения, а устанавливает параметры для миниатюр
Возможные значения:
Примеры использования
Устанавливает размер миниатюры 150×150 пикселей
set_post_thumbnail_size(150, 150);
Устанавливает размер миниатюры 300×200 пикселей с обрезкой
set_post_thumbnail_size(300, 200, true);
Устанавливает размер миниатюры 300×200 пикселей без обрезки
set_post_thumbnail_size(300, 200, false);
Устанавливает размер миниатюры в функции настройки темы
function my_theme_setup() {
set_post_thumbnail_size(250, 250, true);
}
add_action('after_setup_theme', 'my_theme_setup');
Безопасность
Валидация входных данных: Параметры ширины и высоты проверяются на положительные значения
Санитизация: Параметры автоматически обрабатываются WordPress
Рекомендации: Убедитесь, что используете допустимые целочисленные значения для ширины и высоты
— Связанные функции
Добавляет дополнительные размеры изображений для использования в теме
Получает миниатюру записи с заданными размерами
— Примечания
– Ограничения
Миниатюры будут применяться ко всем записям, но не к уже загруженным изображениям до их регенерации
– Частые проблемы
- Некорректное отображение миниатюр при неправильных размерах
- Необходимость регенерации миниатюр после изменения размеров
