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