get_the_post_thumbnail_url()


WordPress関数get_the_post_thumbnail_url()は、投稿や固定ページに設定されたサムネイル画像のURLを取得するために使用されます。

構文

get_the_post_thumbnail_url( int|WP_Post|null $post = null, string|int $size = 'post-thumbnail' );

引数の説明:

  • $post (int|WP_Post|null) — 画像を取得する投稿のIDまたはオブジェクト。デフォルトでは現在の投稿が使用されます。
  • $size (string|int) — 画像サイズ。例: ‘thumbnail’, ‘medium’, ‘large’, ‘full’ またはカスタムサイズ。

例 1: 現在の投稿のサムネイルURLを取得する

現在の投稿のサムネイル画像のURLを取得します。

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

例 2: 指定した投稿IDのサムネイルURLを取得する

特定の投稿ID（例: 5）のサムネイル画像のURLを取得します。

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

例 3: カスタム画像サイズでURLを取得する

‘medium’ サイズのサムネイル画像のURLを取得します。

<?php $thumbnail_url = get_the_post_thumbnail_url( null, 'medium' ); echo $thumbnail_url; ?>

例 4: 投稿オブジェクトを使用してURLを取得する

投稿オブジェクトを使用してサムネイル画像のURLを取得します。

<?php
$post = get_post( 10 );
$thumbnail_url = get_the_post_thumbnail_url( $post, 'large' );
echo $thumbnail_url;
?>

例 5: サムネイル画像が設定されていない場合のデフォルト処理

サムネイル画像が設定されていない場合にデフォルト画像のURLを表示します。

<?php
$thumbnail_url = get_the_post_thumbnail_url( null, 'full' );
if ( ! $thumbnail_url ) {
    $thumbnail_url = 'https://example.com/default-thumbnail.jpg';
}
echo $thumbnail_url;
?>

注意事項:

  • サムネイル画像が設定されていない投稿では、nullが返されます。
  • 画像サイズの指定が正しくない場合、デフォルトサイズ ‘post-thumbnail’ が使用されます。

関連機能：