Get_the_post_thumbnail() WordPress関数は、テーマやプラグインを使って特集画像を取得して表示することができるようになる関数です。 この記事では、get_the_post_thumbnail() 関数を使って特集画像を好きな場所に表示する方法を教えます。
WordPress プラグインの作成に関する詳細情報をご希望の場合は、最初の WordPress プラグインの作成に関するチュートリアル シリーズをご覧ください。
注意： get_the_post_thumbnail() 関数を使用するには、テーマ内でそのサポートを有効にしている必要があります。
get_the_post_thumbnail() 関数のサポートを有効にするには、テーマの functions.php ファイルに以下を含めます:
add_theme_support( ‘post-thumbnails’ );
基本使用法
<?php echo get_the_post_thumbnail( $post_id, $size, $attr ); ?>
上記のコードでは、定義したパラメータに基づいて、投稿の特集画像を表示しているだけです。 以下に、get_the_post_thumbnail() 関数内で定義できるさまざまなパラメータを示します。
Parameters
$post_id: これはオプションのパラメータで、特集画像を取得する投稿の投稿 ID を定義することができます。 定義されていない場合は、現在閲覧している記事の特集画像が表示されます。
$size: オプションのパラメータで、表示する画像のサイズを指定します。 文字列か配列のどちらかを寸法で定義します。
定義済みのサイズ:
- thumbnail
- medium
- large
- full
カスタムサイズです。
カスタム サイズを定義するには、たとえば、配列内で定義するだけです:
get_the_post_thumbnail($post_id, array(100,100), $attr );
上のコードからわかるように、画像サイズは 100×100 です。
$attr: これはオプションのパラメーターで、class、alt テキスト、タイトルなどの追加属性を定義するために配列を使用できます。 これは次のようなものです。
$attr = array(
‘src’ => $src,
‘class’ => “attachment-$size”,
‘alt’ => trim(strip_tags( $attachment->post_excerpt )),
‘title’ => trim(strip_tags( $attachment->post_title )),
) のようになります。
上記の例では、画像の場所、クラス、alt テキスト、およびタイトルを含む配列を変数に格納し、後で get_the_post_thumbnail() 関数内で呼び出すようにしています。