Advanced Custom FieldsプラグインのRepeater FieldsをWP_Query()で使う

WordPressのカスタムフィールドを便利に使えるようにしてくれる至高のプラグイン「Advanced Custom Fields」。
このプラグインの上位版「Advanced Custom Fields Pro」にはユーザーが任意にカスタムフィールドの数を増減したり並び替えたりできるようにする「Repeater Fields」機能が備わっています。
(詳細は「Advanced Custom Fields : Repeater Fieldの出力例」)

とあるお仕事で「Repeater Fields」のサブフィールドを使ったクエリを組み立てる必要があったので、その覚書です。

下記2点が今回の仕様:

  • カスタム投稿「PEOPLE」の投稿詳細ページに、カスタム投稿「PUBLICATIONS」の投稿を「WP_Query」で出力したい
  • カスタム投稿「PUBLICATIONS」の投稿がもつRepeater Fields「authors」のサブフィールド「authors_name」とカスタム投稿「PEOPLE」の投稿がもつカスタムフィールド「name2」が「完全一致」するものだけ出力したい

Query Posts by Custom Fields