Функция wp_attachment_is_image() в WordPress: описание, использование, примеры

# Функция WP_ATTACHMENT_IS_IMAGE() │ WP 2.1.0

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

### Используется в

Функция wp_attachment_is().

### Используемая функцией

wp_get_original_image_path()

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

- 1 вызов — 0.000291 сек (быстро)
- 50,000 вызовов — 0.44 сек (очень быстро)
- PHP 7.0.14, WP 4.7

### Ключевые моменты

- **Хуки:** Нет.

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

- true или false.

  - **true** — если MIME-тип поста: jpg, jpeg, jpe, gif, png.
  - **false** — в любом другом случае.

## Применение

### Синтаксис

```php
wp_attachment_is_image( $post );

• $post (int/WP_Post) — ID (идентификатор) поста (вложения) или объект.
• По умолчанию: null (глобальная переменная $post).

Примеры

Проверка, является ли вложение с ID 37 изображением

$id = 37;
if( wp_attachment_is_image( $id ) ){
    echo "Пост с ID $id — это изображение!";
}
else {
    echo "Пост с ID $id не является изображением.";
}

Изменения в версии

• С версии 2.1.0 — введена функция.
• С версии 4.2.0 — изменена, теперь является обёрткой для wp_attachment_is() и позволяет передавать объект WP_Post.

Код функции

function wp_attachment_is_image( $post = null ) {
    return wp_attachment_is( 'image', $post );
}

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

Работы с изображениями

• wp_get_attachment_caption()
• wp_get_attachment_image()
• wp_get_attachment_image_sizes()
• wp_get_attachment_image_src()
• wp_get_attachment_image_srcset()
• wp_get_attachment_image_url()
• wp_get_attachment_thumb_url()
• wp_get_attachment_url()

Другие связанные функции

• file_is_displayable_image()
• image_downsize()
• next_image_link()
• previous_image_link()
• wp_get_image_mime()

В этом тексте объяснены функции и добавлены примеры, чтобы сделать материал более понятным и доступным для начинающих пользователей WordPress.