Order Posts by a Custom Key

The WordPress query is a powerful thing. It’s at the core of every request a visitor can make on your website. Whether someone is visiting your blog, your about page, or a custom post type, when the request is made it will eventually run a WordPress query. In some cases, you’ll want to change the order in which WordPress displays your content. WordPress is flexible enough to handle this because of the actions and filters available through its Plugin API.

Which Way To Order

WordPress offers a number of filters to modify the query. Which one you choose depends on how you want to modify the query. In our case, we want to change the order of the content we’re getting back. When changing the order, there are two aspects that we need to keep in mind. The first is what data we want to order the content on. You can sort your content on things that WordPress provides for you like the date, the title, or the page order. The second piece of information is which direction we want to order our content.

You can think of this in terms of one of two values, ascending or descending. A to Z would be ascending, and Z to A would be descending. Because WordPress got its start in the blogging world, the default ordering takes its cue from blog posts. Blog posts are chronological in nature and therefore are ordered by date with the newest content first. In programming terms, we think of this as descending by date.

Order By Custom Key

Often times when we’re developing a custom site for our clients, we need to allow for ordering content by a custom key. For example, let’s say that we build a custom post type that needs to dynamically show the most popular piece of content based on a star rating. In this case, we would build a system for visitors to rate the content with that rating being stored as meta information related to the post. There are a couple of different ways to do this.

Adding The Custom Key To The SQL Query

One way would be to use specific filters to modify the SQL query to join the post meta table and order by the newly selected field. Let’s take a look at how to accomplish this.

Using WP_Query Abstraction Layer

While it is possible to modify the SQL query directly as shown above and achieve our desired results, that method is prone to breakage because the SQL query may change at some point. It’s more in alignment with the WordPress best practices to use the WP_Query wrapper to handle the internals for you. Using the WP_Query object as an abstraction allows you to modify the internals without needing to understand SQL (because WordPress core developers have done all the hard work for you). Here’s how that would look.

The Best Way To Order By Custom Key

As with most things in WordPress, the method you use will be defined by your specific needs. WordPress is flexible and powerful enough to allow you to modify queries directly. But as Spider-man’s story reminds us, “with great power comes great responsibility.” If you do modify queries directly, you’ll need to be much more careful when you update things. Using core WordPress APIs will keep your code lean and solid because the WordPress core team works hard to keep them up to date with any new changes.

How Can We Help You?

We want to build your next project.

Connect with Pixel Jar

Tell Us About Your Project

Ready to get started? Fill out the short form below and let us know a bit more about what you have in mind. We're excited to hear what you're working on.

Name*

Email*

Timeline*

Budget*

Describe your project

Sign me up for the Pixel Jar newsletter

Note: Your information will be added to our CRM. If you checked the newsletter subscription box, your email will be used to send emails from Pixel Jar. You can unsubscribe from our emails at any time. We will use your email address to contact you about this project request.

Clutch Reviews

5 of 5 Stars

Google Reviews

About Pixel Jar

Pixel Jar is a skilled web development agency that focuses on WordPress as a development platform for websites. Pixel Jar started in 2004. It grew from a desire to choose projects that challenge us and work with clients that inspire us.

Tell Us About Your Project

Ready to get started? Fill out the short form below and let us know a bit more about what you have in mind. We're excited to hear what you're working on.

Name*

Email*

Timeline*

Budget*

Describe your project

Sign me up for the Pixel Jar newsletter

Note: Your information will be added to our CRM. If you checked the newsletter subscription box, your email will be used to send emails from Pixel Jar. You can unsubscribe from our emails at any time. We will use your email address to contact you about this project request.