Multisite Toolbar Additions

Tanya Jawab

Why another Multisite Toolbar plugin, there are already some others!?

You’re right! If you’re happy with one of the others then that’s absolutely great and you don’t need to add or switch anything! 🙂

I just made this new plugin here for my own needs and some of my client admins. As I am an open source evangelist I like to release my stuff to the public to give back to the community!

Plugin developer David Decker: What has proved its day to day usage and usefullness on more than 100 installs (Multisites and regular single site installs) before, could be used by many other (super) admins as well, right? :-)))

Does this plugin work with latest WordPress version and also older versions?

Yes, this plugin works really fine with the LATEST WordPress branch 3.8+! 🙂
And sorry, it DOES NOT work with WordPress versions older than 3.6 so please update your install if you haven’t done yet :).

How do I use the custom Nav Menu for Super Admins for the toolbar?

All menu items via a Custom Menu – and at all other places in the Toolbar (a.k.a. Admin Bar) – are only visible and accessable for Super Admins. That means in a Multisite environment all admins who can manage the network. In regular WordPress (single) installs these are users with the Administrator user role.

Added Menu Location by the plugin is: “Multisite Toolbar Menu” (again: only for Super Admins)

Steps for setting up a menu:

• Create a new menu, set a name like “Super Admin Toolbar” or such…
• Setup your links, might mostly be custom links, or any other…
• Save the new menu to the plugin’s menu location. That’s it 🙂
• Please note: Every parent item = one main toolbar entry! So best would be to only use one parent item and set all other items as children.

How can I adjust the position of my custom Nav Menu?

Since version 1.4.0 of the plugin there’s a filter for that. See this example that needs to be added to your theme’s/ child theme’s functions.php file or a functionality plugin. Try values between 1 and 100:

add_filter( 'mstba_filter_super_admin_nav_menu_priority', 'mstba_custom_position_super_admin_nav_menu' );
/**
 * Multisite Toolbar Additions:
 *    Adjust Super Admin Nav Menu Position
 */
function mstba_custom_position_super_admin_nav_menu() {

    return 20;

}

How do I use the custom Nav Menu for Site Admins for the toolbar?

The usage is identical as the Super Admin menu – see above 2 questions for instructions!

Only difference: This Site Admins menu is only viewable by site admins but only Super Admins can setup and edit it!

The filter for the hook priority here is called mstba_filter_restricted_admin_nav_menu_priority — and works in the very same as above!

How can I adjust the position of Network admin “+ New” section?

This could be easily done with the following example code that needs to be added to your theme’s/ child theme’s functions.php file or a functionality plugin. Try values between 1 and 100:

add_filter( 'mstba_filter_network_admin_new_content_priority', 'mstba_custom_position_network_admin_new_content' );
/**
 * Multisite Toolbar Additions:
 *    Adjust Network Admin "+ New" Position
 */
function mstba_custom_position_network_admin_new_content() {

    return 80;

}

Can I remove the “+ New” (new content) section in Network admin?

Yes, it’s possible! This line of code needs to be added to your theme’s/ child theme’s functions.php file or a functionality plugin:

/**
 * Multisite Toolbar Additions:
 *    Remove Network Admin "+ New" section
 */
add_filter( 'mstba_filter_display_network_new_content', '__return_false' );

How are new resources being added to the toolbar/admin bar?

Just drop me a note on my Twitter @deckerweb or via my contact page and I’ll add the link if it is useful for Multisite/ Super Admins.

Is this plugin Multisite compatible?

Of course it is! 🙂 Works really fine in Multisite invironment – for Super Admins.

In Multisite, could I “network activate” this plugin?

Yes, you could! Again, it’s only displayed and useful for Super Admins. — Activating on a per-site basis is also possible. Just decide what works best for you.

Has this plugin any use for non-Multisite installs?

Yes, of course! 🙂 The plugin is working like a charm in single-site installs – just without the network specific stuff. However, there’s still A LOT (single) site specific stuff supported. So it’s up to your use case :).

Special instructions for the supported ‘BackWPup’ plugin?

Yes, I have some advise for you 🙂 — My plugin only adds any BackWPup resources to your toolbar if you didn’t enabled the “Toolbar / Admin Bar option” on the BackWPup settings page.

• Enable BackWPup Toolbar / Adminbar = BackWPup handles its own stuff…
• Disable BackWPup Toolbar / Adminbar = Multisite Toolbar Additions will handle BackWPup’s toolbar items 🙂

Could certain sections/ item groups be removed?

Yes, this is possible! You can remove the following sections: “My Sites” menu area (all network items) / “My Sites” menu area (all sub site specific items) / “Super Admin Nav Menu” group (all items) / “Network Plugin Support” (all network plugin items) / “(Sub Site) Plugin Support” (all site plugin items) / “(Sub) Site Specific Items” – useful to disable for specific Super Admin users…

To achieve this add one, some or all of the following constants to your main theme’s/child theme’s functions.php file, functionality plugin or MU plugin:

/**
 * Multisite Toolbar Additions:
 *    Remove Network Admin Specific Items
 */
define( 'MSTBA_DISPLAY_NETWORK_ITEMS', FALSE );

/**
 * Multisite Toolbar Additions:
 *    Remove Sub Site Specific Items
 */
define( 'MSTBA_DISPLAY_SUBSITE_ITEMS', FALSE );

/**
 * Multisite Toolbar Additions:
 *    Disable Custom Nav Menu for Super Admins
 */
define( 'MSTBA_SUPER_ADMIN_NAV_MENU', FALSE );

/**
 * Multisite Toolbar Additions:
 *    Disable restricted Custom Nav Menu for Site Admins
 */
define( 'MSTBA_RESRICTED_ADMIN_NAV_MENU', FALSE );

/**
 * Multisite Toolbar Additions:
 *    Disable Plugin Support for Network Wide Plugins
 */
define( 'MSTBA_DISPLAY_NETWORK_EXTEND_GROUP', FALSE );

/**
 * Multisite Toolbar Additions:
 *    Disable Plugin Support for (Sub) Site Specific Plugins
 */
define( 'MSTBA_DISPLAY_SITE_EXTEND_GROUP', FALSE );

/**
 * Multisite Toolbar Additions:
 *    Disable Site Specific Items
 */
define( 'MSTBA_DISPLAY_SITE_GROUP', FALSE );

/**
 * Multisite Toolbar Additions:
 *    Disable Nav Menu List Edit Items
 */
define( 'MSTBA_DISPLAY_LIST_EDIT_MENUS', FALSE );

Could the the whole toolbar entries be removed, especially for certain users?

Yes, that’s also possible! This could be useful if your site has special user roles/capabilities or other settings that are beyond the default WordPress stuff etc. For example: if you want to disable the display of any “Multisite Toolbar Additions” items for all user roles of “Editor” please use this code:

To hide only from the user with a user ID of “2”:

/**
 * Multisite Toolbar Additions:
 *    Remove Network Admin specific Items for user ID 2
 */
if ( 2 === get_current_user_id() ) {
    define( 'MSTBA_DISPLAY_NETWORK_ITEMS', FALSE );
}

To hide items only in frontend use this code:

/**
 * Multisite Toolbar Additions:
 *    Remove Network Admin specific Items from frontend
 */
if ( ! is_admin() ) {
    define( 'MSTBA_DISPLAY_NETWORK_ITEMS', FALSE );
}

Final note: I DON’T recommend to add customization code snippets to your main theme’s/ child theme’s functions.php file! Please use a functionality plugin or an MU-plugin instead! This way you can also use this better for Multisite environments. In general you are then more independent from theme/child theme changes etc. If you don’t know how to create such a plugin yourself just use one of my recommended ‘Code Snippets’ plugins. Read & bookmark these Sites:

• “Code Snippets” plugin by Shea Bunge – also network wide!
• Woody Snippets (Insert PHP) plugin by webcraftic
• “What is a functionality plugin and how to create one?” – blog post by WPCandy
• “Creating a custom functions plugin for end users” – blog post by Justin Tadlock

All the custom & branding stuff code above can also be found as a Gist on Github: https://gist.github.com/deckerweb/3498510 (you can also add your questions/ feedback there 🙂