wp_attachment_is_image()

Q: wp_attachment_is_image() はどんなファイルに使えますか？

画像ファイル（JPEG、PNG、GIFなど）に使用します。それ以外のファイル（PDFや動画など）はfalseが返ります。

Q: 投稿内の画像だけを抽出することはできますか？

はい、get_children() 関数を使い、画像添付ファイルのみを取得することが可能です。 $args = array( 'post_parent' => get_the_ID(), 'post_type' => 'attachment', 'post_mime_type' => 'image', 'numberposts' => -1,);$images = get_children($args);foreach ($images as $image) { echo wp_get_attachment_image($image->ID, 'thumbnail');} get_children() で現在の投稿に関連するすべての画像を取得し、サムネイルサイズで表示します。

Function

2025/4/3 Thursday

wp_attachment_is_image() は、指定した添付ファイルが画像ファイルかどうかを判定するテンプレートタグです。

この関数は、投稿やメディアライブラリでファイルが画像形式かどうかを確認したいときに便利です。

機能の説明

wp_attachment_is_image() は、指定した添付ファイルのIDを受け取り、そのファイルが画像かどうかを判定してtrueまたはfalseを返す関数です。

画像でない場合（PDFや動画など）にはfalseが返ります。

シンプルなコード例

if (wp_attachment_is_image(123)) {
    echo 'このファイルは画像です。';
} else {
    echo 'このファイルは画像ではありません。';
}

添付ファイルIDが123のファイルが画像の場合「このファイルは画像です。」と表示され、それ以外のファイルでは「このファイルは画像ではありません。」と表示されます。

使い方の解説

wp_attachment_is_image() は、主に添付ファイルが画像であるかを条件分岐で確認するために使います。ギャラリーページや投稿の中で画像だけを表示したい場合に有用です。

引数

wp_attachment_is_image($post_id)

$post_id（整数）には確認する添付ファイルのIDを指定します。

画像だけを表示するコード例

$attachment_id = get_the_ID(); // 現在の添付ファイルIDを取得

if (wp_attachment_is_image($attachment_id)) {
    echo wp_get_attachment_image($attachment_id, 'large'); // 画像を表示
} else {
    echo '<p>このファイルは画像ではありません。</p>';
}

現在の添付ファイルが画像であれば<img>タグで画像が表示され、画像でない場合はメッセージが表示されます。

一緒に使うことが多い関連タグ

`wp_get_attachment_image()`

wp_get_attachment_image() は、指定した画像IDの画像をHTMLタグで出力するための関数です。

if (wp_attachment_is_image(get_the_ID())) {
    echo wp_get_attachment_image(get_the_ID(), 'thumbnail'); // サムネイルを表示
}

wp_attachment_is_image() で画像ファイルであることを確認した後、その画像をサムネイルサイズで表示します。

`get_post_mime_type()`

get_post_mime_type() は、指定した投稿または添付ファイルのMIMEタイプを取得する関数です。

$mime_type = get_post_mime_type(get_the_ID());

if ($mime_type === 'image/jpeg') {
    echo 'JPEG形式の画像です。';
}

添付ファイルのMIMEタイプを取得し、それがJPEG形式の画像であればメッセージを表示します。

追加情報を取得したい場合

wp_attachment_is_image() で判定した画像について、さらに情報を取得したい場合、以下のテンプレートタグを使用します。

`wp_get_attachment_metadata()` で画像メタデータを取得する

$metadata = wp_get_attachment_metadata(get_the_ID());
print_r($metadata);

このコードは、画像ファイルのメタデータ（幅、高さ、サムネイル情報など）を配列として取得し、表示します。

出力できる情報

width：画像の幅
height：画像の高さ
file：ファイルのパス
sizes：サムネイルサイズの情報

想定されるトラブル

正しいIDを渡していない

wp_attachment_is_image() に渡したIDが存在しないか、画像ではないファイルのIDである可能性があります。

解決方法

get_the_ID() などでIDが正しく取得できているか確認します。
管理画面のメディアライブラリで該当ファイルのIDを確認してください。

サムネイルが表示されない

アップロードした画像にサムネイルサイズが生成されていない可能性があります。

解決方法

サムネイルサイズの再生成が必要です。Regenerate Thumbnailsプラグインを使用するか、add_image_size() で新しいサイズを登録します。

Q&A

`wp_attachment_is_image()` はどんなファイルに使えますか？

画像ファイル（JPEG、PNG、GIFなど）に使用します。それ以外のファイル（PDFや動画など）はfalseが返ります。

投稿内の画像だけを抽出することはできますか？

はい、get_children() 関数を使い、画像添付ファイルのみを取得することが可能です。

$args = array(
    'post_parent' => get_the_ID(),
    'post_type'   => 'attachment',
    'post_mime_type' => 'image',
    'numberposts' => -1,
);
$images = get_children($args);

foreach ($images as $image) {
    echo wp_get_attachment_image($image->ID, 'thumbnail');
}

get_children() で現在の投稿に関連するすべての画像を取得し、サムネイルサイズで表示します。