Описание функции has_image_size()
Функция has_image_size() проверяет, был ли зарегистрирован указанный размер изображения в WordPress. Это полезно для проверки доступности пользовательских размеров изображений перед их использованием в коде.
Функция используется в темах и плагинах для обеспечения совместимости с разными размерами изображений, чтобы избежать ошибок при выводе изображений, которые не были зарегистрированы.
Параметры
$size
Тип: string
Обязательный: Да
Описание: Название размера изображения для проверки
Возможные значения:
thumbnail: Миниатюра
medium: Средний размер
large: Большой размер
custom_size: Пользовательский размер (например, ‘my_custom_size’)
Возвращаемое значение
Тип: bool
Описание: Возвращает true, если размер изображения зарегистрирован, иначе false
Возможные значения:
• true — размер изображения зарегистрирован
• false — размер изображения не зарегистрирован
Примеры использования
Базовый пример проверки наличия стандартного размера миниатюры
if (has_image_size('thumbnail')) {
echo 'Миниатюра зарегистрирована';
} else {
echo 'Миниатюра не зарегистрирована';
}
Выводит сообщение о наличии или отсутствии миниатюры
Проверка наличия пользовательского размера изображения
if (has_image_size('my_custom_size')) {
echo 'Пользовательский размер зарегистрирован';
} else {
echo 'Пользовательский размер не зарегистрирован';
}
Выводит сообщение о наличии или отсутствии пользовательского размера
Безопасность
Валидация входных данных: Функция принимает только строки в качестве параметров
Санитизация: Параметр автоматически очищается WordPress
Рекомендации: Необходимо убедиться, что строка не содержит вредоносных данных перед передачей в функцию
— Связанные функции
Регистрация нового размера изображения
Получение параметров зарегистрированного размера изображения
— Примечания
– Ограничения
Не проверяет размеры изображений, которые не были зарегистрированы через add_image_size()
– Частые проблемы
- Возвращает false для несуществующих названий размеров
- Ошибка при использовании функции до регистрации размера
