こんにちは、今日はWordPressのWP_Query関連フィルターフックについてまとめていきます。
確認環境
WordPress 5.5.3
フィルターフック一覧
| フック名 | 説明 |
| found_posts | クエリ実行直後に、投稿のリストに適用されます。 |
| found_posts_query | 表示する投稿のリストがデータベースからクエリされた後、WordPressはクエリ結果の行を選択します。 |
| post_limits | 投稿リストを返すクエリのLIMIT句に適用されます。 |
| posts_clauses | SQLクエリ全体に適用され、クエリ句のタイプごとにキー付き配列に分割され、投稿リストを返します。 |
| posts_distinct | プラグインが投稿配列を返すクエリにDISTINCTROW句を追加できるようにします。 |
| posts_fields | 投稿配列を返すクエリのフィールドリストに適用されます。 |
| posts_groupby | 投稿配列を返すクエリのGROUP BY句に適用されます。（通常は空です。） |
| posts_join | 投稿配列を返すクエリのJOIN句に適用されます。これは通常、posts_whereフィルターと組み合わせて、テーブルをJOINに追加するために使用されます。 |
| posts_join_paged | ページングが計算された後、投稿配列を返すクエリのJOIN句に適用されます（ただし、ページングはJOINに影響を与えないため、これは実際にはposts_joinと同等です）。 |
| posts_orderby | 投稿配列を返すクエリのORDER BY句に適用されます。 |
| posts_request | クエリを実行する直前に、投稿配列を返すSQLクエリ全体に適用されます。 |
| posts_results | クエリ実行結果の配列を操作できます。 |
| posts_search | WP_QueryのWHERE句で使用される検索SQLに適用されます。 |
| posts_where | 投稿配列を返すクエリのWHERE句に適用されます。 |
| posts_where_paged | ページングが計算された後、投稿配列を返すクエリのWHERE句に適用されます（ただし、ページングはWHEREに影響を与えないため、これは実際にはposts_whereと同等です）。 |
| the_posts | 単一投稿ページでの権限とドラフトステータスの最小限の処理後に、データベースからクエリされた投稿のリストに適用されます。 |
