Skip to content
WordPress plugin to sort your posts by custom sort keys
PHP JavaScript CSS
Find file
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.
assets
inc
modules
pages
.gitignore
README.md
readme.txt
wp-grid-sorter.php

README.md

WordPress Grid Sorter

Sort your WordPress posts with custom sort keys

Functions

wp_grid_sorter_register_sort_key($sortKey, $args)

Arguments

name Specify the name to display in the CMS

post_type Specify the post type for this key

Register a custom sort key by post type

<?php
add_action('init', 'site_register_wp_grid_sorters');
function site_register_wp_grid_sorters()
{
    if (function_exists('wp_grid_sorter_register_sort_key')) {
        $args = array(
            'name' => 'Sort All Posts',
            'post_type' => 'post'
        );
        wp_grid_sorter_register_sort_key('sort_all_posts', $args);   
    }
}
?>

Register a custom sort key by custom WP_Query

<?php
$args = array(
    'name' => 'Home Page Featured',
    'query' => new WP_Query(array(
        'post_type' => 'post',
        'meta_query' => array(
            array(
                'key' => 'featured',
                'value' => 1
            )
        )
    ))
);
wp_grid_sorter_register_sort_key('home_page_featured', $args);
?>

Query posts and order by your custom sort key

This is automatically hooked into WP_Query. Please refer to the documentation for order by a meta key in the WordPress Codex.

Example:

<?php
$args = array(
    'post_type' => 'post',
    'order' => 'ASC',
    'orderby' => 'meta_value_num',
    'meta_key' => 'home_page_featured'
);
$myCustomQuery = new WP_Query($args);
?>
Something went wrong with that request. Please try again.