Функция wp_get_registered_image_subsizes() возвращает нормализованный список всех зарегистрированных размеров изображений в текущем состоянии WordPress. Она используется для получения детализированной информации о каждом зарегистрированном субразмере изображений, включая ширину, высоту и параметр обрезки.
wp_get_registered_image_subsizes(): array[]Возвращаемые данные
wp_get_registered_image_subsizes() возвращает ассоциативный массив, где ключами являются имена размеров изображений (например, thumbnail, medium), а значениями — массивы с информацией о каждом размере:
width— ширина изображения.height— высота изображения.crop— режим обрезки (true или false).
Примечание
Функцию get_intermediate_image_sizes() можно использовать, если требуется получить только имена зарегистрированных размеров изображений без дополнительных данных.
Эта функция основывается на следующих функциях:
wp_get_additional_image_sizes()get_intermediate_image_sizes()
Пример 1: Получение всех размеров изображений
Следующий пример показывает, как можно получить и вывести информацию обо всех зарегистрированных размерах изображений:
$sizes = wp_get_registered_image_subsizes();
foreach ( $sizes as $key => $val ) {
echo "Размер: {$key};" . PHP_EOL;
echo "Ширина: {$val['width']}" . PHP_EOL;
echo "Высота: {$val['height']}" . PHP_EOL;
if ( is_array($val['crop']) ) {
echo "Обрезка: {$val['crop'][0]}x{$val['crop'][1]}." . PHP_EOL;
} else {
echo "Обрезка: {$val['crop']}." . PHP_EOL;
}
echo PHP_EOL;
}
Вывод может выглядеть следующим образом:
Размер: thumbnail;
Ширина: 150
Высота: 150
Обрезка: 1.
Размер: medium;
Ширина: 320
Высота: 320
Обрезка: .
Размер: large;
Ширина: 1024
Высота: 1024
Обрезка: .
Размер: custom-size;
Ширина: 600
Высота: 400
Обрезка: 1.
Пример 2: Демонстрация структуры возвращаемого массива
Этот пример показывает, как выглядит структура массива, возвращаемого функцией wp_get_registered_image_subsizes():
$sizes = wp_get_registered_image_subsizes();
print_r( $sizes );
Пример вывода:
Array
(
[thumbnail] => Array
(
[width] => 150
[height] => 150
[crop] => 1
)
[medium] => Array
(
[width] => 320
[height] => 320
[crop] =>
)
[large] => Array
(
[width] => 1024
[height] => 1024
[crop] =>
)
[custom-size] => Array
(
[width] => 600
[height] => 400
[crop] => 1
)
)
Заключение
Функция wp_get_registered_image_subsizes() полезна для получения подробной информации о всех зарегистрированных субразмерах изображений в WordPress. Это может быть особенно полезно при работе с кастомными изображениями или для анализа параметров, используемых в разных частях сайта.