WordPressのquery_postsは非推奨!理由と他の実装方法を紹介

長野 透
書いた人 長野 透
侍エンジニア塾ブログは、未経験からWebアプリ開発と仕事獲得をサポートする
侍エンジニア塾のオウンドメディアです。
プログラミング学習を覗き見
query_postsを使うと投稿ページなどで表示する条件を設定することができます。

ただし、このquery_postsを使うことは非推奨とされています。

ではなぜquery_postsを使うことは非推奨なのでしょうか?

この記事では、query_postsについてといった基本的な内容から、注意すべき点についても解説していきます。

・query_postsとは?
・query_postsの使い方 
・query_postsは非推奨?代替方法は?
 

今回はquery_postsについて、わかりやすく解説します。

query_postsとは?

query_postsは、WordPressで投稿を表示するのに使用しているメインクエリを書き換えるテンプレートタグです。

メインクエリとは、ブラウザからリクエストされたURLを元にデータベースから呼び出される記事のデータのことです。

query_postsはメインクエリを新たに上書きします。

表示する投稿を絞り込む場合などに使います。

query_postsの使い方

query_postsを使う際には最後にwp_reset_queryでリセットし、メインクエリを元に戻す必要があります。

サンプルコードで確認しましょう。

より複雑な条件を設定することもできます。

設定でよく使う内容をコードスニペットにまとめたサイトをご紹介しておきます。

https://sole-color-blog.com/blog/265/

query_postsは非推奨?代替方法は?

ここまでquery_postsについて説明してきました。

query_postsは条件を絞って表示するためにメインクエリを書き換えることができます。

しかしwp_reset_queryの記述を忘れると、他のページのクエリも書き換わるなどの意図しない結果が表示される危険性もあるため非推奨とされています。

また、メインクエリを書き換える際に再度データベースを読み込む必要があるのでページの表示速度が遅くなります。

そこで、query_postsの代わりにメインループではpre_get_postsを、サブループではWP_Queryまたはget_postsを使うことが強く推奨されています。

pre_get_posts

pre_get_postsはWordPressのアクションフックの一つです。

アクションフックでは、イベントが発生したときに機能を追加したり削除したりできます。

pre_get_postsはメインループで使います。

pre_get_postsはfunction.phpに記述します。

サンプルコードで確認しましょう。

他のページでpre_get_postsが働かないようにif文で限定するようにしましょう。

WP_Query

WP_Queryはブログの投稿やページの情報を取得する場合に使うクラスです。

WP_Queryはメインクエリを書き換えません。

メインクエリを表示するメインループとは別にサブループで投稿一覧などを表示するために使います。

WP_Queryについてはこちらでも詳しく解説していますので、ぜひ参考にしてください。

get_posts

get_postsはブログの投稿やページの情報を取得する場合に使うテンプレートタグです。

WP_Queryクラスと同じように、メインループとは別にサブループで投稿一覧などを表示するために使います。

WP_Queryの場合はオブジェクトとして扱えるのでプロパティなども使えますが、get_postsは取得結果を配列としてしか扱えません

まとめ

ここではquery_postsについて説明しました。

query_postsは投稿ページなどで条件を絞って表示することができます。

ただしメインクエリを書き換えるので、wp_reset_query関数を呼び出さなければ他のページのクエリも変更するなど意図しない結果になる危険性があるので非推奨とされています。

メインクエリを変更するならpre_get_postsを、サブループで条件を指定する場合はWP_Queryget_postsを使うようにしましょう。

使いこなすことができるように、この記事を何度も参考にして下さいね!


33歳、未経験だった僕がフリーエンジニアになれた理由
現在フリーランスをされている市川友哉さん。33歳で、プログラミングを学び始め、4ヶ月という短い期間でフリーランスエンジニアとして独立までされた学習ログを余すことなくインタビューさせていただきました。

プログラミングを学習中の方はもちろん、独立をお考えの方まで幅広く活用できる記事になっています。この機会に是非活用していただければと思います。


最短でプログラミングを習得したい方へ

元々ITリテラシーのある方やプログラムの学び方がわかっている方は独学で習得することも可能でしょう。

ただし、実際の学習期間中はつまづいている時間がほとんどです。

「もう挫折したくない」
「本業と両立しながら、好きな時間で自分のペースで勉強を続けていきたい。」
「自分だけのカリキュラムで効率的に勉強したい」

そんな方はお気軽に侍エンジニア塾までご相談ください。

弊社では、

  • プログラミング基礎学習
  • オリジナルアプリ開発
  • 仕事獲得

までをひと通り学習できます。

まずは無料体験レッスンで、弊社のコンサルタントと一緒にあなた専用の学習方法やカリキュラムを考えてみませんか?

挫折しない学び方や、通常1000時間以上かかる学習時間を1/3にする方法などより具体的なアドバイスもさせていただいています。

詳しくは下の画像をクリックして弊社サービス内容をご確認ください。

cta1

非常識な結果を出した卒業生

活躍する現役エンジニア

人気記事セレクション

LINEで送る
Pocket

この記事が気に入ったら
いいね!をしてフォローしよう

最新情報をお届けします

書いた人

長野 透

長野 透

熊本在住のフリープログラマ兼ライターです。C/C++/C#、Java、Python、HTML/CSS、PHPを使ってプログラミングをしています。専門は画像処理で最近は機械学習、ディープラーニングにはまっています。幅広くやってきた経験を活かしてポイントをわかりやすくお伝えしようと思います。
お問合せはこちらでも受け付けています。
[email protected]