Функция wp_attachment_is_image() в WordPress позволяет определить, является ли вложение изображением. Это полезный инструмент для разработки тем и плагинов, так как помогает выполнять условные проверки на тип вложения.
wp_attachment_is_image( int|WP_Post $post = null ): boolОписание
Функция проверяет, относится ли данное вложение к изображениям, определяя его MIME-тип. Она возвращает true, если вложение — это изображение, и false в противном случае. Важно отметить, что функция работает на основе глобальной переменной $post, если в качестве параметра не указано другое значение.
Параметры функции
$post(int|WP_Post) — ID вложения или объект поста. По умолчанию:null, что означает использование глобального$post.
Возвращаемое значение
bool— Функция возвращаетtrue, если вложение является изображением (например, типыjpg,jpeg,gif,png), иfalseв любом другом случае.
Пример 1: Проверка вложения на изображение
В этом примере мы проверим, является ли вложение с ID 42 изображением:
$id = 42; // ID вложения
if ( wp_attachment_is_image( $id ) ) {
echo "Вложение $id — это изображение!";
} else {
echo "Вложение $id не является изображением.";
}
Если вложение с ID 42 действительно является изображением, то на экране появится сообщение «Вложение 42 — это изображение!».
Пример 2: Использование с глобальным $post
Если вы работаете внутри цикла WordPress, можно использовать функцию без параметра, что будет означать проверку для текущего поста:
if ( wp_attachment_is_image() ) {
echo "Текущий пост является изображением!";
} else {
echo "Текущий пост не является изображением.";
}
В этом случае функция проверит, является ли текущий пост (глобальный $post) изображением, и выведет соответствующее сообщение.
Пример 3: Проверка вложения в массиве
Предположим, у нас есть массив ID вложений, и мы хотим проверить каждое из них:
$attachments = [10, 25, 42, 56]; // Массив ID вложений
foreach ( $attachments as $attachment_id ) {
if ( wp_attachment_is_image( $attachment_id ) ) {
echo "Вложение $attachment_id — это изображение!<br>";
} else {
echo "Вложение $attachment_id не является изображением.<br>";
}
}
Этот код перебирает массив ID вложений и выводит, какие из них являются изображениями.
Пример 4: Проверка вложения с объектом поста
Если у вас есть объект поста, вы можете передать его в функцию для проверки:
$post = get_post( 15 ); // Получаем объект поста с ID 15
if ( wp_attachment_is_image( $post ) ) {
echo "Вложение с ID {$post->ID} — это изображение!";
} else {
echo "Вложение с ID {$post->ID} не является изображением.";
}
Здесь мы получаем объект поста и проверяем, является ли он изображением.
Заключение
Функция wp_attachment_is_image() — это полезный инструмент для разработки на WordPress, позволяющий проверять тип вложений и управлять отображением контента на сайте. Ее простота и универсальность делают её необходимой для любого разработчика, работающего с медиафайлами в WordPress.