SWELL│カテゴリーページも含めた人気記事ランキングの作り方

// 分類に連動する独自ランキングを共通サイドバーへ置くサイト用。
function waza_context_ranking_sidebar_cache() {
    if ( class_exists( 'SWELL_Theme' )
        && function_exists( 'my_get_current_slugs' )
        && shortcode_exists( 'swell_popular_posts' )
        && ( is_single() || is_page() || is_archive() ) ) {
        SWELL_Theme::set_setting( 'cache_sidebar', false );
    }
}
add_action( 'wp', 'waza_context_ranking_sidebar_cache', 20 );

function add_categories_tags_to_pages() {
    register_taxonomy_for_object_type('category', 'page'); // カテゴリーを固定ページに追加
    register_taxonomy_for_object_type('post_tag', 'page'); // タグを固定ページに追加
}
add_action('init', 'add_categories_tags_to_pages');

/**
 * 1) タグ・カテゴリーのPVカウント
 * タグ・カテゴリーアーカイブにアクセスした際、対象タームのメタキー（SWELL_CT_KEY または swell_pv_ct）の値を+1します。
 */
function count_taxonomy_page_view() {
    if ( is_category() || is_tag() ) {
        $term = get_queried_object();
        if ( isset( $term->term_id ) ) {
            // テーマ側でSWELL_CT_KEYが定義されていればその値、なければ 'swell_pv_ct' を使用
            $meta_key = defined( 'SWELL_CT_KEY' ) ? SWELL_CT_KEY : 'swell_pv_ct';
            $pv = (int) get_term_meta( $term->term_id, $meta_key, true );
            $pv++;
            update_term_meta( $term->term_id, $meta_key, $pv );
        }
    }
}
add_action( 'wp', 'count_taxonomy_page_view' );


/**
 * 2) 管理画面のカテゴリー一覧に「PV」カラムを追加
 * カラムID を swell_pv_ct として最後に追加
 */
function add_category_pv_column( $columns ) {
    $columns['swell_pv_ct'] = 'PV';
    return $columns;
}
add_filter( 'manage_edit-category_columns', 'add_category_pv_column' );

/**
 * 2b) 管理画面のタグ一覧に「PV」カラムを追加
 */
function add_tag_pv_column( $columns ) {
    $columns['swell_pv_ct'] = 'PV';
    return $columns;
}
add_filter( 'manage_edit-post_tag_columns', 'add_tag_pv_column' );


/**
 * 3) カテゴリー一覧のカラムにPV値を表示
 */
function show_category_pv_column( $content, $column_name, $term_id ) {
    if ( 'swell_pv_ct' === $column_name ) {
        $meta_key = defined( 'SWELL_CT_KEY' ) ? SWELL_CT_KEY : 'swell_pv_ct';
        $pv = get_term_meta( $term_id, $meta_key, true );
        return (string) max(0, (int) $pv);
    }
    return $content;
}
add_filter( 'manage_category_custom_column', 'show_category_pv_column', 10, 3 );

/**
 * 3b) タグ一覧のカラムにPV値を表示
 */
function show_tag_pv_column( $content, $column_name, $term_id ) {
    if ( 'swell_pv_ct' === $column_name ) {
        $meta_key = defined( 'SWELL_CT_KEY' ) ? SWELL_CT_KEY : 'swell_pv_ct';
        $pv = get_term_meta( $term_id, $meta_key, true );
        return (string) max(0, (int) $pv);
    }
    return $content;
}
add_filter( 'manage_post_tag_custom_column', 'show_tag_pv_column', 10, 3 );


/**
 * 4) 管理画面のカテゴリー一覧のソート可能カラムを登録
 */
function sortable_category_columns( $columns ) {
    $columns['swell_pv_ct'] = 'swell_pv_ct';
    return $columns;
}
add_filter( 'manage_edit-category_sortable_columns', 'sortable_category_columns' );

/**
 * 4b) 管理画面のタグ一覧のソート可能カラムを登録
 */
function sortable_tag_columns( $columns ) {
    $columns['swell_pv_ct'] = 'swell_pv_ct';
    return $columns;
}
add_filter( 'manage_edit-post_tag_sortable_columns', 'sortable_tag_columns' );


/**
 * 5) pre_get_terms フックで、orderby=swell_pv_ct の場合にタームメタを使った数値ソートを設定
 */
function my_sort_taxonomy_by_swell_pv_ct( $term_query ) {
    // 管理画面以外では処理しない
    if ( ! is_admin() ) {
        return;
    }
    // WP_Term_Query の query_vars から取得
    $orderby  = isset( $term_query->query_vars['orderby'] )  ? $term_query->query_vars['orderby']  : '';
    $taxonomy = isset( $term_query->query_vars['taxonomy'] ) ? $term_query->query_vars['taxonomy'] : '';
    
    // 対象タクソノミーが category または post_tag、かつ orderby が swell_pv_ct の場合
    if ( !empty( (array) $taxonomy ) && !array_diff( (array) $taxonomy, array( 'category', 'post_tag' ) ) && 'swell_pv_ct' === $orderby ) {
        $meta_key = defined( 'SWELL_CT_KEY' ) ? SWELL_CT_KEY : 'swell_pv_ct';
        $term_query->query_vars['meta_key']  = $meta_key;
        $term_query->query_vars['orderby']   = 'meta_value_num';
        $term_query->query_vars['meta_type'] = 'NUMERIC';
        $term_query->meta_query->parse_query_vars($term_query->query_vars);
    }
}
add_action( 'pre_get_terms', 'my_sort_taxonomy_by_swell_pv_ct' );

/**
 * =====================
 * 1) 共通関数
 * =====================
 */

/**
 * get_swell_popular_posts()
 * WP_Query を用いて「PV >= 0」かつ特定カテゴリー/タグに絞った人気記事を取得する。
 * limit, paged, category_slug, tag_slug を受け取る。
 */
function get_swell_popular_posts( $limit = 5, $paged = 1, $category_slug = '', $tag_slug = '' ) {
    $meta_key = defined( 'SWELL_CT_KEY' ) ? SWELL_CT_KEY : 'swell_pv_ct';

    $tax_query = [];
    if ( ! empty( $category_slug ) ) {
        $category = get_category_by_slug( $category_slug );
        if ( ! $category ) return null;
        if ( $category ) {
            // 現在のカテゴリーのID
            $terms = [ $category->term_id ];
            // 子カテゴリーの場合、親カテゴリーのIDも追加
            if ( $category->parent > 0 ) {
                $terms[] = $category->parent;
            }
            $tax_query[] = [
                'taxonomy'         => 'category',
                'field'            => 'term_id',
                'terms'            => $terms,
                'include_children' => true,
            ];
        }
    }
    if ( ! empty( $tag_slug ) ) {
        $tag = get_term_by( 'slug', $tag_slug, 'post_tag' );
        if ( ! $tag || is_wp_error( $tag ) ) return null;
        if ( $tag ) {
            $tax_query[] = [
                'taxonomy' => 'post_tag',
                'field'    => 'term_id',
                'terms'    => $tag->term_id,
            ];
        }
    }

    $args = [
        'post_type'           => ['post', 'page'],
        'posts_per_page'      => $limit,
        'paged'               => $paged,
        'meta_key'            => $meta_key,
        'orderby'             => ['meta_value_num' => 'DESC', 'ID' => 'ASC'],
        'order'               => 'DESC',
        'post_status'         => 'publish',
        'has_password'        => false,
        'ignore_sticky_posts' => 1,
        'meta_query'          => [
            [
                'key'     => $meta_key,
                'value'   => 0,
                'compare' => '>=',
                'type'    => 'NUMERIC',
            ],
        ],
    ];

    if ( ! empty( $tax_query ) ) {
        $args['tax_query'] = $tax_query;
    }

    $query = new WP_Query( $args );
    return ( $query->have_posts() ) ? $query : null;
}


/**
 * 親カテゴリ（1階層上）を返す
 * 親が無ければ false
 */
function my_get_parent_category( $term ) {
    if ( ! $term instanceof WP_Term ) return false;
    if ( 0 === $term->parent ) {
        return false;
    }
    $parent = get_term( $term->parent, 'category' );
    return ( $parent && ! is_wp_error( $parent ) ) ? $parent : false;
}

/**
 * 最上位カテゴリを返す
 * 親が無ければ自身を返す
 */
function my_get_top_category( $term ) {
    if ( ! $term instanceof WP_Term ) return null;
    $ancestors = get_ancestors( $term->term_id, 'category' );
    if ( empty($ancestors) ) {
        // 親なし → 自分
        return $term;
    }
    $top_id   = end( $ancestors );
    $top_term = get_term( $top_id, 'category' );
    return ( $top_term && ! is_wp_error($top_term) ) ? $top_term : $term;
}

/**
 * 指定カテゴリの「子孫カテゴリ」をすべて取得
 * get_term_children() は階層をすべて取得するため、多階層下の子カテゴリも含まれる
 */
function my_get_all_child_categories( $term_id ) {
    $child_ids = get_term_children( $term_id, 'category' );
    if ( empty($child_ids) || is_wp_error($child_ids) ) {
        return [];
    }
    $child_terms = get_terms([
        'taxonomy'   => 'category',
        'include'    => $child_ids,
        'hide_empty' => false,
    ]);
    if ( ! $child_terms || is_wp_error($child_terms) ) {
        return [];
    }
    return $child_terms;
}


/** 現在のタグだけを、正のPVがある場合にランキングへ加える。 */
function my_build_tag_items( $slug ) {
    $term = get_term_by( 'slug', $slug, 'post_tag' );
    if ( ! $term || is_wp_error( $term ) ) { return []; }
    $key = defined( 'SWELL_CT_KEY' ) ? SWELL_CT_KEY : 'swell_pv_ct';
    $pv = (int) get_term_meta( $term->term_id, $key, true );
    $url = get_term_link( $term );
    if ( $pv <= 0 || is_wp_error( $url ) ) { return []; }
    return [[ 'type' => 'tag', 'title' => $term->name . 'のタグ記事一覧', 'link' => $url, 'pv' => $pv ]];
}

function get_swell_category_h1_by_id($term_id) {
    $term = get_term($term_id, 'category');
    if (!$term || is_wp_error($term)) {
        return '';
    }
    $custom_title = get_term_meta($term_id, 'swell_term_meta_ttl', true);
    return is_string($custom_title) && $custom_title !== '' ? $custom_title : $term->name;
}

/**
 * 現在のページから「カテゴリースラッグ / タグスラッグ」を取得
 */
function my_get_current_slugs() {
    if ( is_category() || is_tag() ) {
        $term = get_queried_object();
        if ( ! $term instanceof WP_Term ) { return ['', '']; }
        return is_category() ? [$term->slug, ''] : ['', $term->slug];
    }
    if ( is_singular( ['post', 'page'] ) ) {
        $cats = get_the_terms( get_queried_object_id(), 'category' );
        if ( ! empty( $cats ) && ! is_wp_error( $cats ) ) {
            return [$cats[0]->slug, ''];
        }
    }
    return ['', ''];
}

/**
 * ランキング用に「カテゴリ自身 + 親(1階層) + 子孫全部」を配列化し、PV>0なら追加
 */
function my_build_category_items( WP_Term $term ) {
    $meta_key = defined('SWELL_CT_KEY') ? SWELL_CT_KEY : 'swell_pv_ct';
    $list     = [];

    // 1) 自分
    $pv_self = (int)get_term_meta($term->term_id, $meta_key, true);
    // PVが正のカテゴリーだけランキングに含める
    if ( $pv_self > 0 ) {
        $list[] = [
            'type'  => 'category',
            'title' => get_swell_category_h1_by_id($term->term_id), // 現在のカテゴリのH1
            'link'  => get_term_link($term),
            'pv'    => $pv_self,
        ];
    }

    // 2) 親(1階層)
    $parent = my_get_parent_category($term);
    if ( $parent ) {
        $pv_parent = (int)get_term_meta($parent->term_id, $meta_key, true);
        if ( $pv_parent > 0 ) {
            $list[] = [
                'type'  => 'category',
                'title' => get_swell_category_h1_by_id($parent->term_id), // 親カテゴリのH1
                'link'  => get_term_link($parent),
                'pv'    => $pv_parent,
            ];
        }
    }

    // 3) 子孫(すべて)
    $children = my_get_all_child_categories($term->term_id);
    if ( $children ) {
        foreach ( $children as $child ) {
            $child_pv = (int)get_term_meta($child->term_id, $meta_key, true);
            if ( $child_pv > 0 ) {
                $list[] = [
                    'type'  => 'category',
                    'title' => get_swell_category_h1_by_id($child->term_id), // 子カテゴリのH1
                    'link'  => get_term_link($child),
                    'pv'    => $child_pv,
                ];
            }
        }
    }

    return $list;
}

/**
 * ランキング配列(投稿やカテゴリなど)を PV降順でソートし、上位 $limit 件だけ返す
 */
function my_sort_and_slice( array $ranking_list, $limit ) {
    usort($ranking_list, function($a,$b){
        return $b['pv'] - $a['pv'];
    });
    return array_slice($ranking_list, 0, $limit);
}

/**
 * 本文用の人気記事リスト（ページネーション付き）
 * カテゴリがある場合 → そのカテゴリ（親+子）を取得
 * カテゴリが無い場合 → 全てのカテゴリを取得
 */
function swell_popular_posts_inline_shortcode( $atts ) {
    $previous_post = $GLOBALS['post'] ?? null;
    $atts = shortcode_atts([
        'limit' => 12,
    ], $atts, 'swell_popular_posts_inline' );

    $paged = isset($_GET['waza_rank_page']) && is_scalar($_GET['waza_rank_page'])
        ? max(1, absint(wp_unslash($_GET['waza_rank_page']))) : 1;
    $limit = max(1, min(24, (int) $atts['limit']));

    // 1) 現在のスラッグを取得
    list($category_slug, $tag_slug) = my_get_current_slugs();

    // 2) 投稿（WP_Query）
    //   ※ 'include_children'=>true が効いているので、$category_slug があればその子孫投稿を含む
	$query = get_swell_popular_posts( -1, 1, $category_slug, $tag_slug );


    // 3) 投稿を配列化
    $ranking_list = [];
    $meta_key     = defined('SWELL_CT_KEY') ? SWELL_CT_KEY : 'swell_pv_ct';

    while ( $query && $query->have_posts() ) {
        $query->the_post();
        $ranking_list[] = [
            'type'  => 'post',
            'title' => get_the_title(),
            'link'  => get_permalink(),
            'pv'    => (int) get_post_meta( get_the_ID(), $meta_key, true ),
        ];
    }
    wp_reset_postdata();
    $GLOBALS['post'] = $previous_post;
    if ( $previous_post instanceof WP_Post ) {
        setup_postdata( $previous_post );
    }

    // 4) カテゴリ追加
    if ( $category_slug ) {
        // ========== カテゴリーがある場合 ==========
        $current_term = get_term_by('slug', $category_slug, 'category');
        if ( $current_term && ! is_wp_error($current_term) ) {
            // 親・子・自分をまとめて配列化
            $cat_items   = my_build_category_items( $current_term ); 
            $ranking_list = array_merge($ranking_list, $cat_items);
        }
    } elseif ( $tag_slug ) {
        $ranking_list = array_merge( $ranking_list, my_build_tag_items( $tag_slug ) );
    } else {
        // ========== カテゴリーが無い（= 全体ランキング）場合 ==========
        // 「すべてのカテゴリ」を取得し、PV>0 のみリストに入れる
        $all_cats = get_terms([
            'taxonomy'   => 'category',
            'hide_empty' => false, // 投稿数0でも取得
        ]);
        if ( ! is_wp_error($all_cats) && ! empty($all_cats) ) {
            foreach ( $all_cats as $cat ) {
                $cat_pv = (int) get_term_meta( $cat->term_id, $meta_key, true );
                if ( $cat_pv > 0 ) {
                    $ranking_list[] = [
                        'type'  => 'category',
                        'title' => $cat->name . 'のカテゴリー記事一覧',
                        'link'  => get_term_link($cat),
                        'pv'    => $cat_pv,
                    ];
                }
            }
        }
    }

    // 5) ソート & limit
    //    （同じ処理。関数化してもOK）
	usort($ranking_list, function($a, $b) {
		return ($b['pv'] <=> $a['pv']) ?: strcmp((string) $a['link'], (string) $b['link']);
	});
	$total_items = count($ranking_list);
	// $limit is validated above.
	$total_pages = max(1, (int) ceil($total_items / $limit));
	$paged = min($paged, $total_pages);
	$offset      = ($paged - 1) * $limit;
	$ranking_list = array_slice($ranking_list, $offset, $limit);


    // 6) HTML 出力
    ob_start(); 
    ?>
    <div class="c-widget widget_swell_popular_posts custom">
        <ul class="p-postList -type-list -w-ranking">
            <?php foreach ( $ranking_list as $item ) : ?>
                <li class="p-postList__item">
                    <a href="<?php echo esc_url($item['link']); ?>" class="p-postList__link">
                        <div class="p-postList__body">
                            <div class="p-postList__title">
                                <?php
                                    $title      = $item['title'];
                                    echo esc_html($title);
                                ?>
                            </div>
                        </div>
                    </a>
                </li>
            <?php endforeach; ?>
        </ul>
    </div>
    <?php

    // 投稿とカテゴリーを結合した件数からページ送りを作る。
    if ($total_pages > 1) {
        $base = add_query_arg('waza_rank_page', 999999999, remove_query_arg('waza_rank_page', get_pagenum_link(1, false)));
        echo '<nav class="waza-rank-pagination" aria-label="人気記事のページ送り">';
        echo wp_kses_post(paginate_links([
            'base' => str_replace('999999999', '%#%', $base),
            'format' => '',
            'current' => $paged,
            'total' => $total_pages,
            'type' => 'list',
        ]));
        echo '</nav>';
    }

    return ob_get_clean();
}
add_shortcode('swell_popular_posts_inline', 'swell_popular_posts_inline_shortcode');

function swell_popular_posts_shortcode( $atts ) {
    $previous_post = $GLOBALS['post'] ?? null;
    $atts = shortcode_atts([
        'limit' => 5,
    ], $atts, 'swell_popular_posts' );

    $atts['limit'] = max(1, min(24, (int) $atts['limit']));

    // 1) 現在の category_slug, tag_slug を取得
    list($category_slug, $tag_slug) = my_get_current_slugs();

    // ===============================
    // (A) まず投稿ランキングを取得
    // ===============================
    // もしカテゴリが空の場合、get_swell_popular_posts(...) に category_slug='' かつ tag_slug=''
    // → 全投稿を対象とした人気記事
    $query = get_swell_popular_posts( (int)$atts['limit'], 1, $category_slug, $tag_slug );


    // WP_Query結果を配列化
    $ranking_list = [];
    $meta_key     = defined('SWELL_CT_KEY') ? SWELL_CT_KEY : 'swell_pv_ct';

    while ( $query && $query->have_posts() ) {
        $query->the_post();
        $ranking_list[] = [
            'type'  => 'post',
            'title' => get_the_title(),
            'link'  => get_permalink(),
            'pv'    => (int)get_post_meta( get_the_ID(), $meta_key, true ),
        ];
    }
    wp_reset_postdata();
    $GLOBALS['post'] = $previous_post;
    if ( $previous_post instanceof WP_Post ) {
        setup_postdata( $previous_post );
    }

    // ===============================
    // (B) カテゴリ or 全カテゴリ/タグ を追加
    // ===============================
    if ( $category_slug ) {
        // ---------------------------
        // カテゴリあり → 親・子も追加
        // ---------------------------
        $term = get_term_by('slug', $category_slug, 'category');
        if ( $term && ! is_wp_error($term) ) {
            // 自身 + 親(1階層) + 子孫カテゴリ
            $cat_items    = my_build_category_items( $term );
            $ranking_list = array_merge( $ranking_list, $cat_items );
        }

    } elseif ( $tag_slug ) {
        $ranking_list = array_merge( $ranking_list, my_build_tag_items( $tag_slug ) );
    } else {
        // ---------------------------
        // カテゴリが無い → 全体ランキング
        // → すべてのカテゴリ + すべてのタグ を混在させる
        // ---------------------------

        // 1) 全てのカテゴリ
        $all_cats = get_terms([
            'taxonomy'   => 'category',
            'hide_empty' => false,
        ]);
        if ( ! is_wp_error($all_cats) && ! empty($all_cats) ) {
            foreach ( $all_cats as $cat ) {
                $cat_pv = (int) get_term_meta( $cat->term_id, $meta_key, true );
                if ( $cat_pv > 0 ) {
                    $ranking_list[] = [
                        'type'  => 'category',
                        'title' => $cat->name . 'のカテゴリー記事一覧',
                        'link'  => get_term_link($cat),
                        'pv'    => $cat_pv,
                    ];
                }
            }
        }

        // 2) 全てのタグ (必要なら)
        // 「カテゴリに関連していない→全タグも含めたい」という要望なら加える
        $all_tags = get_terms([
            'taxonomy'   => 'post_tag',
            'hide_empty' => false,
        ]);
        if ( ! is_wp_error($all_tags) && ! empty($all_tags) ) {
            foreach ( $all_tags as $tag ) {
                $tag_pv = (int) get_term_meta( $tag->term_id, $meta_key, true );
                if ( $tag_pv > 0 ) {
                    $ranking_list[] = [
                        'type'  => 'tag',
                        'title' => $tag->name . 'のタグ記事一覧',
                        'link'  => get_term_link($tag),
                        'pv'    => $tag_pv,
                    ];
                }
            }
        }
    }

    // ===============================
    // (C) PV降順でソート → 上位 limit
    // ===============================
    usort($ranking_list, function($a,$b){
        return ($b['pv'] <=> $a['pv']) ?: strcmp((string) $a['link'], (string) $b['link']);
    });
    $ranking_list = array_slice($ranking_list, 0, (int)$atts['limit']);

    if ( ! $ranking_list ) return '';

    // ===============================
    // (D) もっと見るボタン
    // ===============================
    $more_link = home_url('/popular/');
    if ( $category_slug ) {
        $cur_term = get_term_by('slug', $category_slug, 'category');
        if ( $cur_term && ! is_wp_error($cur_term) ) {
            $root = my_get_top_category($cur_term);
            if ( $root ) {
                $more_link = home_url( '/'. $root->slug . '-popular/' );
            }
        }
    }

    // ===============================
    // (E) HTML出力
    // ===============================
    ob_start();
    ?>
    <div class="c-widget widget_swell_popular_posts custom">
        <div class="c-widget__title -side">人気記事</div>

        <ul class="p-postList -type-list -w-ranking">
            <?php foreach ( $ranking_list as $item ) : ?>
                <li class="p-postList__item">
                    <a href="<?php echo esc_url($item['link']); ?>" class="p-postList__link">
                        <div class="p-postList__body">
                            <div class="p-postList__title">
                                <?php
                                    $title      = $item['title'];
                                    echo esc_html($title);
                                ?>
                            </div>
                        </div>
                    </a>
                </li>
            <?php endforeach; ?>
        </ul>

        <div class="p-popular__more" style="text-align:right; margin-top:10px;">
            <a href="<?php echo esc_url($more_link); ?>">もっと見る</a>
        </div>
    </div>
    <?php

    return ob_get_clean();
}
add_shortcode('swell_popular_posts', 'swell_popular_posts_shortcode');

.widget_swell_popular_posts.custom .-type-list .p-postList__body {
    width: 100%;
}

.widget_swell_popular_posts.custom .p-postList__item {
    padding-left: 2.5em;
}

.widget_swell_popular_posts.custom  .p-postList__item::after {
  content: "";
  display: block;
  width: 100%;
  height: 1px;
  background: #ccc;
  position: absolute;
  bottom	: -12px;
	left: 0;	
}

.widget_swell_popular_posts.custom .p-postList .p-postList__title {
    line-height: 1.8;
}

/* ランキング専用ページ送り。本文のリスト装飾を打ち消します。 */
.waza-rank-pagination ul.page-numbers{display:flex;flex-wrap:wrap;gap:.5rem;list-style:none;padding:0;margin:1.5rem 0}
.waza-rank-pagination ul.page-numbers>li{margin:0!important;padding:0;list-style:none}
.waza-rank-pagination ul.page-numbers>li::before{content:none}
.waza-rank-pagination a.page-numbers,
.waza-rank-pagination span.page-numbers{display:inline-flex;align-items:center;justify-content:center;position:static;width:auto;min-width:2.5em;min-height:2.5em;padding:.4em .7em;margin:0!important;line-height:1.3;background:var(--color_gray,#eee);color:var(--color_text,#222)}
.waza-rank-pagination span.current{background:var(--color_main,#176aa6);color:#fff}
.waza-rank-pagination a:focus-visible{outline:3px solid #176aa6;outline-offset:3px}