get_post_format()


WordPressのget_post_format()関数は、指定された投稿のフォーマットを取得するために使用されます。投稿フォーマットは、標準、ギャラリー、リンク、画像、引用、ステータス、動画、オーディオ、チャットなどがあります。

構文

get_post_format( int|WP_Post|null $post = null );
  • $post (int|WP_Post|null) — 投稿IDまたは投稿オブジェクト。デフォルトはnullで、現在の投稿を指します。

例1: 現在の投稿のフォーマットを取得

現在の投稿のフォーマットを取得し、表示します。

<?php echo get_post_format(); ?>

例2: 特定の投稿のフォーマットを取得

指定した投稿IDのフォーマットを取得します。

<?php echo get_post_format( get_the_ID() ); ?>

例3: フォーマットに基づいてクラスを追加

投稿フォーマットに基づいて異なるクラスを追加します。

<?php $format = get_post_format(); if ( $format ) : ?> class="<?php echo $format; ?>"<?php endif; ?>

例4: フォーマットが「ギャラリー」かどうかをチェック

投稿フォーマットが「ギャラリー」かどうかをチェックします。

<?php if ( get_post_format() === 'gallery' ) { echo 'この投稿はギャラリーフォーマットです。'; } ?>

例5: フォーマットに応じて異なるコンテンツを表示

投稿フォーマットに応じて異なるコンテンツを表示します。

<?php $format = get_post_format(); if ( $format === 'video' ) { the_content(); } else { the_excerpt(); } ?>

例6: カスタムクエリで投稿フォーマットをフィルタリング

カスタムクエリを使用して、特定のフォーマットの投稿を取得します。

<?php $query = new WP_Query( array( 'post_format' => 'post-format-video' ) ); if ( $query->have_posts() ) : while ( $query->have_posts() ) : $query->the_post(); the_title(); endwhile; endif; wp_reset_postdata(); ?>

注意点

  • 投稿フォーマットが設定されていない場合、get_post_format()はfalseを返します。
  • 投稿フォーマットはテーマでサポートされている必要があります。サポートされていない場合、この関数は正しく動作しません。

関連機能：