has_image_size()
Проверяет, существует ли указанный размер картинки.
В функцию, для проверки указывается называние размера, которое было использовано при его регистрации, в функции add_image_size(). Условный тег, возвращает TRUE или FALSE.
Работает на основе глобальной переменной $_wp_additional_image_sizes. В эту переменную записываются новые размеры картинок.
Хуков нет.
Возвращает
true|false.
true, если указанный размер существует.false, если указанный размер не найден.
Использование
has_image_size( $name );
- $name(строка) (обязательный)
- Название зарегистрированного размера картинки, существование которого нужно проверить.
Примеры
#1 Удаление размера картинки
Предположим на не нужен размер картинки и нам нужно удалить этот размер, чтобы не создавались ненужные миниатюры. Как это сделать я писал в этой статье, но этого момента там нет, потому что на практике мы редко можем знать называние размера.
Этот пример показывает как удалить размер, зная его название:
add_action( 'after_setup_theme', 'remove_registered_image_size' );
function remove_registered_image_size() {
if ( has_image_size('image-name') ) {
remove_image_size('image-name');
}
}
Эта функция проверяет только размеры изображений, которые зарегистрированы с помощью функции add_image_size(). Основные размеры изображений, а именно small, medium, medium_large и large, не рассматриваются. Следовательно, проверка основного размера изображения с помощью has_image_size() всегда будет возвращать FALSE.
Список изменений
| С версии 3.9.0 | Введена. |
Код has_image_size() has image size WP 6.9
function has_image_size( $name ) {
$sizes = wp_get_additional_image_sizes();
return isset( $sizes[ $name ] );
}