速報

ジェトロのサイトで情報漏えい|追加9,413件の内訳と暫定再開の範囲

CATEGORY

【WordPress】メインクエリから特定のカテゴリーの投稿を除外する【pre_get_posts】

※本ページのリンクにはプロモーションが含まれています。

【WordPress】メインクエリから特定のカテゴリーの投稿を除外する【pre_get_posts】

目次

本記事では、WordPressののpre_get_postsを使って、メインクエリから特定のカテゴリーの投稿を除外する方法をご紹介しています。

WordPressのメインクエリから特定のカテゴリを除外したいな。良い方法ないかな?

上記の疑問にお答えします。

では、解説していきます。

スポンサーリンク

メインクエリから特定のカテゴリーの投稿を除外する

テーマ内のfunctions.phpに下記フックを追加します。下記では、読み込まれたページがトップページであれば、$queryにcategory__not_inを設定し、指定したカテゴリーIDの投稿を除外しています。

function my_pre_get_posts($query){
    if(is_admin() || !$query->is_main_query()){
        return;
    }

    if(is_front_page() || is_home()){
        $query->set('category__not_in', array('カテゴリID'));
    }
}
add_action('pre_get_posts', 'my_pre_get_posts');

上記ではトップページを対象にしていますが、カスタム投稿のアーカイブページで実行したい場合は下記のようにします。

function my_pre_get_posts($query){
    if(is_admin() || !$query->is_main_query()){
        return;
    }
    if(is_post_type_archive()){
        $query->set('post_type_name');
    }
}
add_action('pre_get_posts', 'my_pre_get_posts');

pre_get_postsとは

上記コード内に登場しているpre_get_postsについて補足します。

処理内容で察している方も多いと思いますが、pre_get_postsはメインクエリのループ実行前に呼び出されるフックです。pre_get_postsにフックすることで、メインクエリを変更することができます。メインクエリを変更するには、$query->set()でパラメータを渡します。メインクエリを変更することで、取得する投稿情報の内容を変更することができます。

以前はquery_posts等が使用されていましたが、query_postsは現在非推奨関数に指定されています。メインループのクエリを変更したい場合はpre_get_postsを使う方法が主流となっていますので、覚えておくとよいかもしれません。

参考:https://developer.wordpress.org/reference/hooks/pre_get_posts/

スポンサーリンク

最後に

メインクエリは各テンプレートに使用されるため、pre_get_postsの使い方をマスターすれば取得する情報をコントロールすることができます。メインクエリを思い通りにコントロールすることができればWordPressをマスターしたといっても過言ではないため、開発環境等で色々動作を試していただいて、使い方をマスターしてくださいね!

以上、WordPressのpre_get_postsでメインクエリから特定のカテゴリーの投稿を除外する方法のご紹介でした!

この記事を書いた人

Ryohei

Webエンジニア / アプリ開発者 / 技術ブログ運営者

福岡のWeb制作会社に勤務するWebエンジニアです。10年以上にわたりWeb制作・開発に携わり、ヒアリングや進行管理から、コーディング、CMSの構築、システム開発、サーバーの構築・保守・運用まで、Webサイト制作の工程を幅広く担当しています。Webサイトは、これまでに100以上の構築・保守を手がけてきました。

個人でもWebサイトの制作・改修やWebアプリの開発・運用を行い、AIを活用した開発にも取り組んでいます。近年はWebセキュリティにも注力しています。

2015年から技術メディア「Into the Program」を運営し、実務や開発で得た知識をもとに、プログラミングの実装方法やWebサイトの運用・セキュリティ情報を発信しています。

主な分野
Webサイト構築・保守・運用 / HTML/CSS / JavaScript / PHP / WordPress / サーバー構築・保守・運用 / アプリ開発 / セキュリティ対策
資格・試験合格
情報セキュリティマネジメント試験
基本情報技術者試験
AWS認定ソリューションアーキテクト アソシエイト
PHP8技術者認定ウィザード
メディア運営
2015年〜

記事の作成・更新について

セキュリティ記事は、ベンダーの公式アドバイザリやCVE・JVNなどの一次情報を参照し、出典と情報確認日を記載します。実環境での検証を行った場合は、その環境と確認範囲を明示します。重要な追加情報や誤りを把握した場合は、内容を確認して追記・訂正します。

関連する記事

おすすめの書籍

キーワードから探す

スポンサーリンク

アクションフック

WordPressで、決まったタイミングに独自の処理を追加するための仕組み。add_action()で登録する。

詳しく見る