Astraでカスタム投稿の一覧・独自検索が10件に切られる(posts_per_page が上書きされる)
要点
Astra は parse_tax_query で、すべてのアーカイブ(カスタム投稿タイプの一覧も含む)の posts_per_page を「ブログの表示件数」(既定10)に上書きする。pre_get_posts で30件・100件にしても10件になり、独自の並べ替え検索では更新順の先頭10件だけが採点される。対策は astra_blog_post_per_page_exclusions フィルターに投稿タイプを追加して除外する(テーマ・設定は変えない)。
症状
- 自作の投稿タイプのアーカイブで
pre_get_postsからposts_per_pageを30にしても、1ページ10件になる。 - 候補を多めに取ってからPHP側で関連度順に並べ替える検索で、件数が「10件」ばかりになり、明らかに合うものが上位に出ない(更新が新しい順の先頭10件だけが採点されている)。
原因
Astra(4.x)の inc/blog/blog.php にある astra_blog_post_per_page() が parse_tax_query で動き、is_home() || is_archive() || is_search() のとき posts_per_page を Astra の「ブログの表示件数」(未設定なら10)で上書きする。pre_get_posts より後に動くので、こちらの設定が消える。
対策(テーマ・Astraの設定は変えない)
除外用のフィルターがあるので、自作の投稿タイプだけ外す。
add_filter('astra_blog_post_per_page_exclusions', function ($ex) {
$ex[] = 'knowledge'; // 自作の投稿タイプ名
return $ex;
});
- 判定は
$query->get('post_type')なので、投稿タイプのアーカイブ(index.php?post_type=…)なら効く。 - Astra の設定画面で件数を変えると、通常の投稿一覧・検索にも影響するので使わない。
確認
- 一覧の件数表示(例: 全138件)と1ページの表示件数・ページ数が合っているか。
- 独自検索で、タイトルに語を含むものが上位に来るか。
guidepocket.net では 2026-09-28 に上のフィルターを mu-plugin v0.2.1 で反映し、一覧が1ページ30件(139件→5ページ)、検索が全候補を採点して上位50件表示になったことを確認済み(390pxではみ出し0)。