WEB制作のための情報サイト / unazuki Library

基本構文と使い方（引数・実行結果）

基本構文

現在のクエリがメインクエリかどうかを判定します。

is_main_query()

is_main_query()

引数

なし。

実行結果

戻り値（返す値）：真偽値（メインクエリならtrue、そうでなければfalse）

例１．

<?php if (is_main_query()) {
	// メインクエリの場合の処理
} ?>

<?php if (is_main_query()) {
	// メインクエリの場合の処理
} ?>

学習者向け補足情報

参考コード

下記のコードはカスタム投稿タイプnewsのアーカイブページにおいて、１ページあたりの表示件数を8件にするコードです（functions.phpに記述）。2~4行目の処理は、現在の表示画面が管理画面の場合（is_admin()）、あるいは現在の処理がメインクエリ以外の場合（! $query->is_main_query()）はreturnを返し、即時処理を終了しています。条件がfalseでreturnを返さない場合、5行目以降を実行し、クエリがカスタム投稿タイプnewsのアーカイブページの場合（$query->is_post_type_archive('news')）に１ページあたりの表示件数を8件にしています。

<?php
function news_posts($query) {
	if (is_admin() || ! $query->is_main_query()) {
		return;
	}
	if ($query->is_post_type_archive('news')) {
		$query->set('posts_per_page', '8');
		return;
	}
}
add_action('pre_get_posts', 'news_posts');
?>

<?php
function news_posts($query) {
	if (is_admin() || ! $query->is_main_query()) {
		return;
	}
	if ($query->is_post_type_archive('news')) {
		$query->set('posts_per_page', '8');
		return;
	}
}
add_action('pre_get_posts', 'news_posts');
?>

関連するテンプレートタグ