Описание функции wp_get_registered_image_subsizes()
Функция wp_get_registered_image_subsizes() возвращает массив зарегистрированных размеров изображений, которые были определены с помощью функции add_image_size(). Это позволяет разработчикам получать доступ к пользовательским размерам изображений, зарегистрированным в системе.
Функция полезна при необходимости работы с изображениями в различных размерах в темах и плагинах
Параметры
$none
Тип: none
Обязательный: Да
Описание: Функция не принимает параметров
Возвращаемое значение
Тип: array
Описание: Массив зарегистрированных размеров изображений
Возможные значения:
• Массив с информацией о размерах изображений
• Пустой массив, если размеры не зарегистрированы
Примеры использования
Базовый пример получения всех зарегистрированных размеров изображений
$subsizes = wp_get_registered_image_subsizes();
foreach ($subsizes as $size => $data) {
echo $size . ': ' . $data['width'] . 'x' . $data['height'] . '; ';
}
Выводит размеры, например, thumbnail: 150×150; medium: 300×300;
Проверка, зарегистрирован ли конкретный размер изображения
$subsizes = wp_get_registered_image_subsizes();
if (isset($subsizes['custom-size'])) {
echo 'Размер custom-size зарегистрирован';
}
Выводит сообщение, если размер существует
Безопасность
Валидация входных данных: Не требуется валидация, так как функция не принимает параметры
Санитизация: Нет необходимости в санитизации
Рекомендации: При выводе данных используйте esc_html() для предотвращения XSS-уязвимостей
— Связанные функции
Регистрирует новый размер изображения
Получает список всех промежуточных размеров изображений
— Хуки
Фильтрует список промежуточных размеров изображений
— Примечания
– Ограничения
Возвращает только размеры, зарегистрированные с помощью add_image_size()
– Частые проблемы
- Пустой массив, если не было зарегистрировано ни одного размера
- Не будет работать, если функция вызывается до регистрации размеров
