WP_GET_ADDITIONAL_IMAGE_SIZES() │ WP 4.7.0

Функция wp_get_additional_image_sizes() получает данные о всех дополнительных размерах изображений (миниатюрах), которые были зарегистрированы в WordPress.

Введение

По умолчанию в WordPress доступны четыре размера изображений: миниатюра, средний, средний большой и большой. С помощью функции add_image_size() можно добавить свои собственные дополнительные размеры изображений. Чтобы получить эти дополнительные размеры, используйте функцию wp_get_additional_image_sizes().

Использование глобальной переменной

Функция использует глобальную переменную $_wp_additional_image_sizes, которая хранит информацию о дополнительных размерах.

Производительность

• Вызов функции: 1 раз — 0.000024 секунды (очень быстро)
• Вызов функции: 50000 раз — 0.01 секунды (супер быстро)

Версия PHP и WordPress

• PHP: 7.1.5
• WordPress: 4.8.2

Возвращаемое значение

Функция возвращает массив с данными о дополнительных размерах изображений.

Пример использования

Чтобы использовать функцию, просто вызовите её следующим образом:

wp_get_additional_image_sizes();

Пример 1: Получение дополнительных размеров изображений

Если вы используете тему "Twenty Fifteen", которая имеет один дополнительный размер изображения post-thumbnail, вызов функции вернет следующий массив:

print_r( wp_get_additional_image_sizes() );

/* Вывод:
Array(
    [post-thumbnail] => Array(
        [width]  => 825,
        [height] => 510,
        [crop]   => 1
    )
)
*/

Заметки

• Глобальный массив: $_wp_additional_image_sizes

История изменений

• Введена в версии 4.7.0.

Код функции

Если вам интересно увидеть, как реализована данная функция, вот её код:

function wp_get_additional_image_sizes() {
global $_wp_additional_image_sizes;

if ( ! $_wp_additional_image_sizes ) {
    $_wp_additional_image_sizes = array();
}

return $_wp_additional_image_sizes;

}

Связанные функции

Вот несколько других функций, которые могут быть полезны при работе с изображениями в WordPress:

Общие функции для изображений

• file_is_displayable_image(): Проверяет, является ли файл изображением.
• next_image_link(): Создает ссылку на следующее изображение.
• previous_image_link(): Создает ссылку на предыдущее изображение.
• wp_get_attachment_url(): Получает URL вложения изображения.
• wp_getimagesize(): Получает размеры изображения.
• wp_read_image_metadata(): Читает метаданные изображения.

Функции для миниатюр

• add_image_size(): Добавляет дополнительный размер изображения.
• delete_post_thumbnail(): Удаляет миниатюру записи.
• get_intermediate_image_sizes(): Получает размеры промежуточных изображений.
• get_post_thumbnail_id(): Получает ID миниатюры записи.
• get_the_post_thumbnail(): Получает HTML кода миниатюры записи.
• the_post_thumbnail(): Отображает миниатюру записи.

Эти функции помогут вам управлять изображениями и миниатюрами в WordPress более эффективно.