WP_Query パラメーターpost_name__in

どういう時に使うか

設定ファイルにスラッグで候補を持つ時や、複数の既知ページをまとめて取得する時に使えます。

対象の post_type も一緒に指定すると、同じようなスラッグを持つ別投稿タイプとの混同を避けやすくなります。

運用中にスラッグを変更できるサイトでは、固定IDの方が保守しやすい場合もあります。どちらが正本かを先に決めます。

近い引数との違い

name は単一スラッグ、post_name__in は複数スラッグを配列で扱います。post__in はスラッグではなく投稿IDです。

入力順を保つ orderby => ‘post_name__in’ は WordPress 4.6 から使えます。引数本体の追加時期とは異なります。

Builderでの扱い

WP Query Builder では複数スラッグとして入力できます。カンマ区切りを配列へ変換する時は、空白と空要素を除きます。

スラッグ変更に弱い点を補足し、長期固定の参照ならID指定も比較できるようにします。

使いどころ・避けどころと実践確認

複数の投稿スラッグだけを対象にし、IDへ依存しない既知の投稿集合を取りたい時に使います。

タイトルやURL全体を渡したり、単一投稿を確実に取得する用途で曖昧な配列を作ったりしません。

スラッグ変更や投稿タイプ違いで一致しなくなるため、post_type と現在の post_name を合わせて確認します。

スラッグは人が変更できるため、長期固定の選択リストならIDの方が安全な場合もあります。

対象投稿のID・post_name・post_type を出力し、存在するスラッグ、変更済みのスラッグ、別投稿タイプのスラッグで結果を比べます。

実践記事で確認WP_Queryで投稿が表示されない時に見るチェックリスト

指定した投稿が出ない場合に、スラッグ・post_type・post_status を最小条件から確認できます。

記事を読む →

WordPressの仕様で確認するポイント

公式の変更履歴で、post_name__in は4.4、同名の orderby 対応は4.6と分けて確認できます。

Post & Page Parameters では、受け付ける値がスラッグ配列であることを確認します。

最後は、値を変える目的と、変えた時に失う情報を一緒に確認します。