【WordPress】アイキャッチ画像のURLを取得する方法

WordPressのテーマ開発やカスタマイズを行っている際に、アイキャッチ画像のURLを取得する必要があることがあります。アイキャッチ画像は、記事やページの視覚的な表現に重要な役割を果たします。この記事では、WordPressでアイキャッチ画像のURLを取得するいくつかの方法を紹介します。

スポンサーリンク

ポストまたはページのアイキャッチ画像を取得する

WordPressでは、get_the_post_thumbnail_url関数を使用して、現在のポストやページのアイキャッチ画像のURLを取得できます。

<?php
$post_id = get_the_ID();
$thumbnail_url = get_the_post_thumbnail_url($post_id);
echo $thumbnail_url;
?>

このコードは、ポストまたはページのIDを取得し、それに基づいてアイキャッチ画像のURLを取得します。

特定のサイズのアイキャッチ画像のURLを取得する

アイキャッチ画像のサイズを指定してURLを取得することもできます。例えば、’thumbnail’, ‘medium’, ‘large’, ‘full’などのサイズが利用可能です。

<?php
$post_id = get_the_ID();
$thumbnail_url = get_the_post_thumbnail_url($post_id, 'thumbnail');
echo $thumbnail_url;
?>

上記の例では、’thumbnail’サイズのアイキャッチ画像のURLを取得しています。

カスタムフィールドを使用してアイキャッチ画像のURLを取得する

別の方法として、カスタムフィールドを使用してアイキャッチ画像のURLを取得することもできます。

<?php
$post_id = get_the_ID();
$thumbnail_id = get_post_meta($post_id, '_thumbnail_id', true);
$thumbnail_url = wp_get_attachment_url($thumbnail_id);
echo $thumbnail_url;
?>

このコードでは、カスタムフィールドからアイキャッチ画像のIDを取得し、そのIDを使用してアイキャッチ画像のURLを取得しています。

よくある質問(FAQ)

Q. アイキャッチ画像のURLを取得する関数を教えてください。
A. get_the_post_thumbnail_url($post_id, $size)でURLを取得します。例:$url = get_the_post_thumbnail_url(get_the_ID(), "medium");。imgタグ全体が必要な場合はget_the_post_thumbnail()を使います。アイキャッチが設定されていない場合はnullまたは””を返します。
Q. アイキャッチのすべてのサイズのURLを取得するにはどうすればよいですか?
A. wp_get_attachment_image_srcset($attachment_id)でレスポンシブ対応のsrcset用URLを取得できます。特定サイズのURLはwp_get_attachment_image_url($id, “medium”)。全サイズ情報はget_intermediate_image_sizes()で登録済みサイズ名一覧を取得してからwp_get_attachment_image_src($id, $size)で各URLを取得します。
Q. OGPのog:imageにアイキャッチ画像を使うにはどうすればよいですか?
A. wp_head()アクション内でアイキャッチURLをmetaタグに出力します:$img = get_the_post_thumbnail_url(get_the_ID(), "large"); if($img) echo "<meta property='og:image' content='" . esc_url($img) . "'>";。Yoast SEOやAll in One SEOはOGPを自動で設定してくれます。

まとめ

これらの方法を駆使して、WordPressのテーマ開発やカスタマイズプロジェクトでアイキャッチ画像のURLを効果的に取得しましょう。アイキャッチ画像は、ウェブサイトの視覚的な魅力を向上させ、ユーザーエクスペリエンスを向上させる重要な要素です。