WP_Query パラメーターorder

order は、単体で「何を基準に並べるか」を決める引数ではありません。並び替えの基準を決めるのは orderby です。order は、その基準をどちら向きに並べるかを指定します。

たとえば投稿日を基準にするなら orderby に date を指定します。そのうえで、新しい順なら order に DESC、古い順なら ASC を指定します。この2つを分けて理解すると、並び順の指定で迷いにくくなります。

order は何を指定する引数か

order は、WP_Query で取得した投稿の並び順の向きを指定する引数です。指定できる基本の値は、昇順の ASC と降順の DESC です。

昇順は小さいものから大きいものへ、古いものから新しいものへ、文字であればAからZのような向きです。降順はその逆で、大きいものから小さいものへ、新しいものから古いものへ並べるイメージです。

ここで大事なのは、ASC と DESC の見え方は orderby によって変わることです。投稿日を基準にした DESC は新しい順ですが、タイトルを基準にした ASC はタイトルの昇順になります。

そのため、並び順を読む時は order だけを見ないようにします。必ず orderby とセットで確認します。

order と orderby の違い

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

この違いを分けておくと、並び順のコードが読みやすくなります。orderby が基準、order が向きです。

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

数値のカスタムフィールドで並べる場合は、orderby に meta_value_num を使うことがあります。この場合も、数値が大きい順なら DESC、小さい順なら ASC です。

Builder での扱い

WP Query Builder では、order は並び順の向きを選ぶ項目として扱う想定です。ただし、単独で出すよりも、orderby とセットで見せたほうが分かりやすくなります。

たとえば Builder では、「並び替えの基準: 投稿日」「並び順: 新しい順」のような表示にして、内部的には orderby => ‘date’、order => ‘DESC’ に変換する形が考えられます。

Builder 側で注意したいのは、orderby の種類によって ASC / DESC の意味が変わって見えることです。投稿日なら「新しい順 / 古い順」、数値なら「大きい順 / 小さい順」のように、表示ラベルを変えると迷いにくくなります。

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

orderby で決めた基準を昇順または降順のどちらへ並べるか指定する時に使います。

日付順、タイトル順、指定ID順など並び替え基準そのものを選ぶ目的では使いません。

ASC / DESC だけを変えても、同値の投稿順は保証されないため、必要なら第二キーを用意します。

ASC と DESC を入れ替える前に、何を基準に並べているかを確認しないと、結果が変わらないことがあります。

並び替え値と投稿IDを一覧出力し、ASC・DESCの反転と同値時の順番を別々に確認します。

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

orderby が基準、order が向きという違いを、実際の $args と結果順で確認できます。

記事を読む →

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

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

order の指定値だけでなく、orderby にどの値を指定できるかも一緒に見ると、並び順の全体像が分かりやすくなります。特に meta_value や meta_value_num を使う場合は、別の引数との組み合わせも確認します。

order は、WP_Query の並び順の向きを決める引数です。ASC は昇順、DESC は降順です。投稿日なら DESC が新しい順、ASC が古い順になります。

ただし、order だけでは並び替えの基準は決まりません。必ず orderby とセットで確認し、必要に応じて meta_key など関連する引数も確認します。