Описание функции add_image_size()
Функция add_image_size() позволяет разработчикам добавлять новые размеры изображений для использования в темах и плагинах. Она облегчает управление изображениями, позволяя загружать их в различных размерах, что улучшает производительность и качество отображения на сайте.
Функция используется в момент регистрации размеров изображений, обычно в файле functions.php темы или плагина
Параметры
$name
Тип: string
Обязательный: Да
Описание: Уникальное имя нового размера изображения
$width
Тип: int
Обязательный: Да
Описание: Ширина изображения в пикселях
$height
Тип: int
Обязательный: Да
Описание: Высота изображения в пикселях
$crop
Тип: bool
Обязательный: Нет
Описание: Флаг, указывающий, нужно ли обрезать изображение по заданным размерам
Возвращаемое значение
Тип: void
Описание: Функция ничего не возвращает
Возможные значения:
• void
Примеры использования
Добавление нового размера изображения 300×200 пикселей без обрезки
add_image_size('custom_size', 300, 200);
Теперь можно использовать ‘custom_size’ при выводе изображений
Добавление размера изображения 400×400 пикселей с обрезкой
add_image_size('cropped_size', 400, 400, true);
Изображение будет обрезано до квадратной формы
Добавление нескольких размеров изображений в одном вызове
add_image_size('small_thumb', 150, 150, true);
add_image_size('large_thumb', 600, 400, false);
Используйте разные размеры для разных целей
Безопасность
Валидация входных данных: Функция проверяет параметры на корректность
Санитизация: Имена размеров очищаются автоматически WordPress
Рекомендации: Используйте уникальные имена для размеров, чтобы избежать конфликтов
— Связанные функции
Получает список всех зарегистрированных размеров изображений
Выводит изображение с указанным размером
— Примечания
– Ограничения
Размеры изображений будут применены только к новым загружаемым изображениям
– Частые проблемы
- Не отображаются новые размеры для уже загруженных изображений
- Ошибки при неправильном указании параметров
