the_post_thumbnail_url()


WordPressのthe_post_thumbnail_url()関数は、投稿やページに設定されたサムネイル画像のURLを取得するために使用されます。この関数は、投稿のサムネイルが設定されている場合にそのURLを返します。

構文

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

引数の説明:

  • $size (string|array) — 取得するサムネイル画像のサイズを指定します。デフォルトは’post-thumbnail’です。
  • $post (int|WP_Post) — サムネイルを取得する投稿のIDまたは投稿オブジェクトを指定します。デフォルトは現在の投稿です。

例1: サムネイル画像のURLを表示

この例では、現在の投稿のサムネイル画像のURLを表示します。

<?php echo the_post_thumbnail_url(); ?>

例2: 特定のサイズのサムネイルURLを取得

この例では、’large’サイズのサムネイル画像のURLを取得します。

<?php echo the_post_thumbnail_url('large'); ?>

例3: 特定の投稿のサムネイルURLを取得

この例では、IDが5の投稿のサムネイル画像のURLを取得します。

<?php echo the_post_thumbnail_url('thumbnail', 5); ?>

例4: サムネイルURLをimgタグで表示

この例では、サムネイル画像をimgタグで表示します。

<img src="<?php echo the_post_thumbnail_url(); ?>" alt="サムネイル画像">

例5: カスタム投稿タイプのサムネイルURLを取得

この例では、カスタム投稿タイプのサムネイル画像のURLを取得します。

<?php echo the_post_thumbnail_url('medium', get_post(7)); ?>

例6: サムネイルURLを背景画像として使用

この例では、サムネイル画像のURLを背景画像として使用します。

<div style="background-image: url('<?php echo the_post_thumbnail_url(); ?>'); width: 100%; height: 300px;"></div>

例7: サムネイルURLをリンクとして使用

この例では、サムネイル画像のURLをリンクとして使用します。

<a href="<?php echo the_post_thumbnail_url(); ?>">サムネイル画像を表示</a>

例8: サムネイルURLを条件分岐で使用

この例では、サムネイルが設定されている場合のみURLを表示します。

<?php if (has_post_thumbnail()) { echo the_post_thumbnail_url(); } ?>

注意点

  • サムネイルが設定されていない場合、この関数は空の文字列を返します。
  • サムネイルのサイズが存在しない場合、デフォルトのサイズが使用されます。
  • 投稿オブジェクトを指定する際は、正しい投稿IDまたはオブジェクトを渡す必要があります。

関連機能：