Skip to content
Reorder by Term
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
js
languages
.gitignore
LICENSE
README.md
class-reorder-term-builder.php
class-reorder-term-helper.php
index.php
readme.txt
reorder-by-term.php
uninstall.php

README.md

Reorder by Term for WordPress

A simple and easy way to reorder your custom post types within terms in WordPress.

Description

We consider Reorder By Term a developer tool. If you do not know what menu_order or custom queries are, then this plugin is likely not for you. This is an add-on to Reorder Posts and requires Reorder Posts 2.1.0 or greater.

Out of the box, WordPress does not support the ability to reorder posts within a term. There are other plugins out there that do term ordering, but they usually create custom tables (which require crazy custom queries and filters) and/or add a column or two to core tables, which is not sustainable in the long-term should WordPress core decide to update its schema.

Reorder by Term uses custom fields, which means you can reorder by term within each taxonomy AND post type. This is insanely flexible.

Since WordPress doesn't support this by default, when you install the plugin, you'll have to build the term data. For a lot of posts and terms, this can take a while, but you can limit the build to post types and taxonomies if, for example, you don't want to touch regular blog posts (with categories and tags).

Features

  • Provides a convenient build-terms tool to add the term data to your existing posts.
  • Automatically modifies/adds the term data when you save a post, change a term slug, or delete a term.
  • Reorder based on post type, taxonomy, and then term.
  • Uses custom fields to save data, so you can use get_posts, WP_Query, or pre_get_posts to order your query correctly.

Use Cases

  1. Set a "Featured" category and reorder posts within that category
  2. Create an employees post type with a departments taxonomy, and reorder employees within each department
  3. Create a products post type and a custom taxonomy, and reorder your products based on its category

Your imagination will give you more use-cases.

Support

Please feel free to create an issue on GitHub. If you require immediate feedback, feel free to @reply me on Twitter with your support link: @ronalfy. Support is always free unless you require some advanced customization out of the scope of the plugin's existing features.

Installation

Either install the plugin via the WordPress admin panel, or ...

  1. Upload reorder-by-term to the /wp-content/plugins/ directory.
  2. Activate the plugin through the 'Plugins' menu in WordPress.

This plugin requires Reorder Posts 2.1.0 or greater.

When you first install the plugin, you'll need to build term data. Head to Tools->Build Post Term Data. From there, you can build the term data based on the taxonomies you select. You can also start over and clear the existing term data.

Please note that this plugin does not change the order of items in the front-end. This functionality is not core WordPress functionality, so it'll require some work on your end to get the posts to display in your theme correctly.

You'll want to make use of WP_Query, get_posts, or pre_get_posts to modify query behavior on the front-end of your site.

Usage

One you have reordered the posts on the back-end, you can now display them on the front-end.

The custom field structure is: _reorder_term_{taxonomy}_{term_slug}

If you have a taxonomy named genre and a term slug of alt-rock, your query arguments might look like this:

'post_type' => 'post',
'order' => 'ASC',
'post_status' => 'publish',
'posts_per_page' => 50,
'meta_key' => '_reorder_term_genre_alt-rock',
'orderby' => 'meta_value_num title'

An example query of the above taxonomy/term would be:

<?php
$term_posts = array(
	'post_type' => 'post',
	'order' => 'ASC',
	'post_status' => 'publish',
	'posts_per_page' => 50,
	'meta_key' => '_reorder_term_genre_alt-rock',
	'orderby' => 'meta_value_num title'
);
$term_get_posts = get_posts( $term_posts );
foreach( $term_get_posts as $post ) {
	echo $post->post_title . '<br />';	
}
?>

An example of doing a custom order for a taxonomy archive (assuming post type of post):

add_filter( 'pre_get_posts', 'reorder_terms_taxonomy_genre' );
function reorder_terms_taxonomy_genre( $query ) {
	if ( !$query->is_main_query() || is_admin() ) return;
	
	if ( $query->is_tax( 'genre' ) ) {
		$term_slug = get_query_var( 'genre' );
		$query->set( 'tax_query', array() );
		$query->set( 'meta_key', '_reorder_term_genre_' . $term_slug );
		$query->set( 'orderby', 'meta_value_num title' );
		$query->set( 'order', 'ASC' );
		$query->set( 'post_type', 'post' );
	}	
}

And here's another example assuming post type of explore:

//Sort the Explore Categories
add_filter( 'pre_get_posts', 'reorder_terms_taxonomy_explore' );
function reorder_terms_taxonomy_explore( $query ) {
	if ( !$query->is_main_query() || is_admin() ) return;
	
	if ( $query->is_tax( 'explore-category' ) ) {
		
		$term_slug = get_query_var( 'explore-category' );
		
		$query->set( 'tax_query', array() );
		$query->set( 'meta_key', '_reorder_term_explore-category_' . $term_slug );
		$query->set( 'orderby', 'meta_value_num title' );
		$query->set( 'order', 'ASC' );
		$query->set( 'post_type', 'explore' );
	}	
}
You can’t perform that action at this time.