tax_queryでタームごとに分類し投稿記事の一覧を実装する方法

この記事では、タームごとに分類してカスタム投稿の記事一覧の作り方を紹介します。

まずタームごとsectionタグで分類し、記事一覧を表示させます。

タームで分類した記事一覧のイメージ

タームごとに分類して記事一覧を表示するPHPコード

とりあえずはコピペでも動作するはずなので、テーマの好きなところへ貼り付けてみましょう。
必ずバックアップはしてくださいね！

<?php
    $taxonomy_name = 'tax_category'; // タクソノミーのスラッグ名を入れる
    $post_type = 'custom_post'; // カスタム投稿のスラッグ名を入れる
    $args = array(
        'orderby' => 'name',
        'hierarchical' => false
        );
    $taxonomys = get_terms( $taxonomy_name, $args);
 
    if(!is_wp_error($taxonomys) && count($taxonomys)):
        foreach($taxonomys as $taxonomy):
        $url = get_term_link($taxonomy->slug, $taxonomy_name);
        $tax_posts = get_posts( array(
            'post_type' => $post_type,
            'posts_per_page' => 5, // 表示させたい記事数
            'tax_query' => array(
                array(
                    'taxonomy' => $taxonomy_name,
                    'terms' => array( $taxonomy->slug ),
                    'field' => 'slug',
                    'include_children' => true,
                    'operator' => 'IN'
                    )
                )
            ));
            if( $tax_posts ) {
?>
    <section>
        <h3 id="<?php echo esc_html($taxonomy->slug); ?>"><a href="<?php echo $url; ?>"><?php echo esc_html($taxonomy->name); ?></a></h3>
        <ul>
            <?php foreach($tax_posts as $tax_post): ?>
            <li><a href="<?php echo get_permalink($tax_post->ID); ?>"><?php echo get_the_title($tax_post->ID); ?></a></li>
            <?php endforeach; wp_reset_postdata(); ?>
        </ul>
    </section>
<?php
            }
        endforeach;
    endif;
?>

タームを取得してループする

タームの取得にはget_terms()関数を使います。
タームの数だけsectionタグで括られた部分をforeach($taxonomys as $taxonomy):でループします。

ループ内でそのタームに属する記事を取得・表示する

記事の取得にはget_posts()関数を使い、オプションのtax_queryで各タームに属する記事を取得しています。

取得した個別の記事は、foreach($tax_posts as $tax_post):でループし<li>タグで括られてタイトルが表示されます。

tax_queryが便利

get_posts()で記事を呼び出す際に、tax_queryを使うところが今回のポイント。

tax_queryは、記事の取得条件を細かく絞り込むことができる便利なパラメータです。

変数$taxonomy_nameで定義したタクソノミーに関連付けされた記事に絞り込み、各個別の記事を取得しています。
'terms' => array( $taxonomy->slug )のように配列のarray()で指定するパラメータも必要です。

tax_queryのパラメータや詳しい使い方は下記を参考にしてください。

WP Query – WordPress Codex 日本語版
タクソノミーのパラメータ

WordPressオリジナルテーマ制作入門

created by Rinker

• Kindle
• Amazon
• 楽天市場
• Yahooショッピング