WP_Query パラメーターorderby

orderby は、一覧の見え方を大きく変える重要な引数です。新着記事一覧、古い順の年表、タイトル順の索引、人気順ランキング、手動で並べた一覧など、並び順を決めたい場面で使います。

ただし、orderby だけでは「昇順か降順か」は決まりません。何を基準に並べるかを orderby で指定し、その向きを order で指定します。この2つを分けて考えると、並び順の指定が読みやすくなります。

orderby は何を指定する引数か

orderby は、WP_Query で取得した投稿を並び替える時の基準を指定する引数です。投稿日、タイトル、ID、メニュー順、コメント数、ランダム、カスタムフィールド値など、何を見て順番を決めるかを指定します。

たとえば orderby に date を指定すると、投稿日を基準に並びます。title を指定するとタイトルを基準に並びます。rand を指定すると、ランダムな順番で取得します。

ここで大事なのは、orderby は「基準」を決める引数だということです。新しい順か古い順か、大きい順か小さい順かは order で指定します。

たとえば投稿日が新しい順なら、orderby => ‘date’ と order => ‘DESC’ を組み合わせます。タイトルの昇順なら、orderby => ‘title’ と order => ‘ASC’ を組み合わせます。

orderby と order の違い

orderby と混同しやすいのが order です。orderby は「何を基準に並べるか」、order は「その基準をどちら向きに並べるか」を指定します。

この違いは、WP_Query の並び替えでとても重要です。orderby だけを見ても、昇順か降順かは分かりません。order だけを見ても、何を基準に並べているかは分かりません。

たとえば、タイトル順にしたい場合は orderby に title を指定します。そのうえで、昇順にしたいなら order に ASC、逆向きにしたいなら DESC を指定します。

投稿日順、タイトル順、数値順では、ASC / DESC の見え方が変わります。投稿日なら DESC は新しい順、数値なら DESC は大きい順です。

Builder での扱い

WP Query Builder では、orderby は並び替えの基準を選ぶ項目として扱う想定です。初心者向けには、date や title のようなコード値だけでなく、「投稿日順」「タイトル順」「ランダム順」「カスタムフィールドの数値順」のように目的で選べる形が分かりやすくなります。

orderby を選んだ後に、order を選ぶ流れにすると自然です。たとえば「投稿日順」を選んだら、次に「新しい順 / 古い順」を選ぶ、という形です。

カスタムフィールド順を Builder で扱う場合は、meta_key の入力も必要になります。orderby で meta_value_num を選んだだけでは、どのカスタムフィールドの値で並べるのかが決まりません。

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

日付、タイトル、指定ID、メタ値など、投稿を並べる基準を選ぶ時に使います。

昇順・降順だけを変える目的や、取得対象を絞る条件としては使いません。

meta_value 系や post__in の順序は前提引数が不足すると意図どおりにならないため、必要な組を確認します。

並べる基準と向きは別設定なので、「新しい順」は date と DESC の組として確認します。

各投稿の並び替え値と取得できた投稿IDの順を並べ、同値・未設定値を含めた期待順と照合します。

実践記事で確認WP_Queryのorderbyとorderの違い

代表的な orderby 値と order の組み合わせを、結果がずれるケースも含めて確認できます。

記事を読む →

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

公式資料では、WP_Query の orderby は Order & Orderby Parameters の中で確認できます。order と同じまとまりで説明されているため、必ずセットで確認します。

orderby の指定値は種類が多いため、実装で迷った時は公式資料に戻ります。特に、カスタムフィールド順、ランダム順、複数条件の並び替えを扱う場合は、公式の指定値を確認することが大切です。

orderby は、WP_Query の並び替えの基準を指定する引数です。投稿日、タイトル、メニュー順、ランダム、カスタムフィールド値など、何を基準に並べるかを決めます。

ただし、orderby だけでは昇順・降順は決まりません。order とセットで確認し、カスタムフィールド順では meta_key も確認します。