WordPressで取得した投稿の配列をフィルタリングするフックthe_postsの使い方

こんにちは、今日はWordPressで取得した投稿の配列をフィルタリングすることができるフック、the_postsの使い方についてまとめていきます。

確認環境

WordPress 5.5.1

使い方

以下の例では$postsに取得した投稿の配列が格納されているため、任意の操作を行った配列を返却することにより、取得した投稿の配列をフィルタリングすることができます。

メタフィールドの値により投稿のタイトルやコンテンツを切り替えることにより、特定の条件を満たさないと閲覧できない投稿を作成すること等も可能です。

function the_posts_filter( $posts, WP_Query $query ) {
    return $posts;
}
add_filter( 'the_posts', 'the_posts_filter', 10, 2 );

リンク

the_posts | Hook | WordPress Developer Resources
https://developer.wordpress.org/reference/hooks/the_posts/