こんにちは、今日は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 | 単一投稿ページでの権限とドラフトステータスの最小限の処理後に、データベースからクエリされた投稿のリストに適用されます。 |