Custom Menu Order in the WordPress Admin

jackharner

Jack Harner 🚀

Posted on August 2, 2022

Custom Menu Order in the WordPress Admin

Turn On The Custom Admin Menu Hook

The custom_menu_order hook is a simple hook that just tells WordPress you want to display the Admin menu in a custom order. You filter it with add_filter() and can just use the built-in function __return_true to (you can probably guess) return true to the hook.

Add this to your functions.php file:

 add_filter( 'custom_menu_order', '__return_true' );
Enter fullscreen mode Exit fullscreen mode

Docs

ORDER IN THE... WordPress Admin!

Now that Custom Menu Order is turned on, it's time to actually set the order. This is controlled through the menu_order hook.

add_filter( 'menu_order', '<custom_menu_order_fn_name>', 10, 1 );
Enter fullscreen mode Exit fullscreen mode

The hook sends an array of the current menu item's URLs as the only parameter. Keep in mind it is only the part of the url AFTER /wp-admin/, but including all of the url parameters:

For example the Pages menu links to https://example.wp/wp-admin/edit.php?post_type=page and you just turn it into: edit.php?post_type=page.

You can either add and remove things individually from the Menu, or return a completely new array with only the items you want in the order you want.

Removing Posts Menu (All Posts, Add New, etc.) from WP Admin

Using the PHP function array_search() returns the array index for a specific value. If you wanted to remove a specific menu/submenu completely, you just search for the top level pages URL, and use PHP's unset() to remove the item from the array.

function jh_remove_posts_menu( $menu_ord ) {
    if (($key = array_search('edit.php', $menu_ord)) !== false) {
        unset($menu_ord[$key]);
    }
    return $menu_ord;
}
add_filter( 'menu_order', 'jh_remove_posts_menu', 10, 1 );
Enter fullscreen mode Exit fullscreen mode

Totally Custom WP Admin Menu Order

Here's an example of throwing out the default menu order and returning an entirely new one.

This is probably the way to go if you're going to be moving or removing more than one item from the menu. It's easier to just set the order explicitly, instead of fighting with the array the hook provides.

function jh_custom_menu_order( $menu_ord ) {

    return array(
        'index.php', // Dashboard
        'separtor1', // First separator
        'edit.php', // Posts
        'edit.php?post_type=page', // Pages
        'edit.php?post_type=<custom post type>', // Custom Post Type 
        'separator2', // Second separator
        'upload.php', // Media
        'edit-comments.php', // Comments
        'separator3', // Third separator
        'users.php', // Users
        'themes.php', // Appearance
        'plugins.php', // Plugins
        'tools.php', // Tools
        'options-general.php', // Settings
        'separator-last', // Last separator
    );
 }
 add_filter( 'menu_order', 'jh_custom_menu_order', 10, 1 );
Enter fullscreen mode Exit fullscreen mode

The order of the items in the array determines the order of the menu. You can add and leave out any pages that are accessible from the WordPress Admin.

Don't worry though, the menu still respects User Role Capabilities, so if you add the Settings menu, it still only shows up for the Administrator role.

Order Array of Core WordPress Pages

As of WordPress v6.0.1, this is the default menu order that gets passed to your menu_order filter function:

 [
    'index.php',
    'separator1',
    'edit.php',
    'upload.php',
    'edit.php?post_type=page',
    'edit-comments.php',
    'separator2',
    'themes.php',
    'plugins.php',
    'users.php',
    'tools.php',
    'options-general.php',
    'separator-last',
 ]
Enter fullscreen mode Exit fullscreen mode
💖 💪 🙅 🚩
jackharner
Jack Harner 🚀

Posted on August 2, 2022

Join Our Newsletter. No Spam, Only the good stuff.

Sign up to receive the latest update from our blog.

Related