=== Multisite Toolbar Additions ===
Contributors: daveshine, deckerweb
Donate link: http://genesisthemes.de/en/donate/
Tags: toolbar, tool bar, adminbar, admin bar, multisite, network, administration, menu, super admins, links, settings, manage, deckerweb, ddwtoolbar
Requires at least: 3.3
Tested up to: 3.4.1
Stable tag: 1.0
License: GPLv2 or later
License URI: http://www.opensource.org/licenses/gpl-license.php

This plugin adds a few useful admin links to the WordPress Toolbar / Admin Bar in Multisite or Network installs.

== Description ==

= Quick Access to Super Admin Resources - Time Saver! =
This **small and lightweight** plugin just adds some missed and very useful admin links to your toolbar / admin bar in Multisite installs. Also included is support for some awesome plugins out of the box. So you might just switch from the backend or frontend of your site to the 'Network Wide Plugins' or access the 'Nav Menu' Settings of a sub site/blog. To make you even more happy, the plugin also works just perfectly in single WordPress installs (non-Multisite), just fewer menu items then... -- Use this time saver and get quicker access :-)

= General Features =
* The plugin is **only intended towards Super Admins / Admins**.
* *Global stuff:*
 * Add a **Custom Nav Menu** to the toolbar via WP Menu system - great for instructions for your staff members or other resources... ([see FAQ for more...](http://wordpress.org/extend/plugins/multisite-toolbar-additions/faq/))
 * Recommended in Multisite: to use the main site for this (but menu is available globally)
 * Only visible and accessable for Super Admins!
* *For Multisite Networks:*
 * Network wide Plugins
 * Network wide Themes (plus Theme Editor)
 * Network Settings, Updates plus Site Upgrade
 * Multisite aware plugin support, to date for: Quick Cache, WP Super Cache, WP-Piwik, WPMS Site Maintenance Mode
* *(Sub) Site specific stuff:*
 * Media Library
 * Edit Posts / Edit Pages
 * Theme Editor (also detects Multisite network-admin!), great for fast editions on the fly...
 * Plugin support, to date for: Howdy Tweaks, Cachify, Hyper Cache, Hyper Cache Extended, Limit Login Attempts, WP-Optimize, Installer (by WMPL.org Team)
* Plugin is fully internationalized, English & German by default :)
* Fully WPML compatible!
* WordPress 3.3 or higher! Tested with WP_DEBUG on :)

= Included Plugin Support =
*Out of the box the plugin supports the following other plugins if installed:*

* ["Quick Cache" (free, by PriMoThemes.com / WebSharks, Inc.)](http://wordpress.org/extend/plugins/quick-cache/) - also network wide
* ["WP Super Cache" (free, by Donncha O Caoimh)](http://wordpress.org/extend/plugins/wp-super-cache/) - also network wide
* ["WP-Piwik" (free, by André Bräkling)](http://wordpress.org/extend/plugins/wp-piwik/) - also network wide
* ["WPMS Site Maintenance Mode" (free, 7 Media Web Solutions, LLC)](http://wordpress.org/extend/plugins/wpms-site-maintenance-mode/) - also network wide
* ["Howdy Tweaks" (free, by Kailey Lampert)](http://wordpress.org/extend/plugins/howdy-tweaks/)
* ["Cachify" (free, by Sergej Müller)](http://wordpress.org/extend/plugins/cachify/)
* ["Hyper Cache" (free, by Stefano Lissa)](http://wordpress.org/extend/plugins/hyper-cache/)
* ["Hyper Cache Extended" (free, by Martin Lazarov)](http://wordpress.org/extend/plugins/hyper-cache-extended/)
* ["Limit Login Attempts" (free, by Johan Eenfeldt)](http://wordpress.org/extend/plugins/limit-login-attempts/)
* ["WP-Optimize" (free, by Ruhani Rabin)](http://wordpress.org/extend/plugins/wp-optimize/)
* ["Installer (WPRC Installer)" (free, by OnTheGoSystems, Inc. (WPML.org team))](http://wp-compatibility.com/installer-plugin/)
* *Your plugin? - [Just contact me with specific data](http://genesisthemes.de/en/contact/)*

= Localization =
* English (default) - always included
* German (de_DE) - always included
* .pot file (`multisite-toolbar-additions.pot`) for translators is also always included :)
* Easy plugin translation platform with GlotPress tool: [Translate "Multisite Toolbar Additions"...](http://translate.wpautobahn.com/projects/wordpress-plugins-deckerweb/multisite-toolbar-additions)
* *Your translation? - [Just send it in](http://genesisthemes.de/en/contact/)*

[A plugin from deckerweb.de and GenesisThemes](http://genesisthemes.de/en/)

= Feedback =
* I am open for your suggestions and feedback - Thank you for using or trying out one of my plugins!
* Drop me a line [@deckerweb](http://twitter.com/deckerweb) on Twitter
* Follow me on [my Facebook page](http://www.facebook.com/deckerweb.service)
* Or follow me on [+David Decker](http://deckerweb.de/gplus) on Google Plus ;-)

= More =
* For more WordPress Toolbar / Admin Bar specific plugins, [**have a look at my Toolbar Plugin Series**](http://wordpress.org/extend/plugins/tags/ddwtoolbar) :-)
* [Also see my other plugins](http://genesisthemes.de/en/wp-plugins/) or see [my WordPress.org profile page](http://profiles.wordpress.org/daveshine/)
* Tip: [*GenesisFinder* - Find then create. Your Genesis Framework Search Engine.](http://genesisfinder.com/)

== Installation ==

1. Upload the entire `multisite-toolbar-additions` folder to the `/wp-content/plugins/` directory -- or just upload the ZIP package via 'Plugins > Add New > Upload' in your WP Admin
2. In your Network Dashboard network activate the plugin through the (Network) 'Plugins' menu -- or in a sub site dashboard: per-site activate this plugin through the (Site) 'Plugins' menu
3. Look at your toolbar / admin bar within the "My Sites" menu and enjoy using the new links there :)
4. If you want you could add a special custom Nav Menu via "Design > Menus" (best if using the main site of your Network for that) and assign it to the new "Multisite Toolbar Menu" menu location (only visible & accessable for Super Admins!). [(See FAQ here for more instructions)](http://wordpress.org/extend/plugins/multisite-toolbar-additions/faq/)
4. Go and manage your Multisite Network :)

**Please note, this plugin requires WordPress 3.3 or higher in order to work!**

**Also note:** This plugin has NO settings page because I believe it's just not neccessarry. All customizing could be done via filters, constants and regular WordPress user roles & capabilities. As the plugin is only indended for a Super Admin (Network Admin) usage - that's the way to go. This way we can save the overhaul of an options panel/settings page, additional database requests, uninstall routines and such. End result: a lightweight system that just works and saves clicks & time :-).

**Multisite install:** Of course, it's fully compatible but have a look in the [FAQ section here](http://wordpress.org/extend/plugins/multisite-toolbar-additions/faq/) for more info :)

**Own translation/wording:** For custom and update-secure language files please upload them to `/wp-content/languages/multisite-toolbar-additions/` (just create this folder) - This enables you to use fully custom translations that won't be overridden on plugin updates. Also, complete custom English wording is possible with that, just use a language file like `multisite-toolbar-extras-en_US.mo/.po` to achieve that (for creating one see the tools on "Other Notes").

== Frequently Asked Questions ==

= 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 give back to the community!

= Does this plugin work with latest WP version and also older versions? =
Yes, this plugin works really fine with the LATEST WordPress branch 3.4+! :-)
And sorry, it DOES NOT work with WordPress versions older than 3.3 so please update your install if you haven't done yet :).

= How do I use the custom Nav Menu 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 are new resources being added to the toolbar/admin bar? =
Just drop me a note on [my Twitter @deckerweb](http://twitter.com/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.

= Can 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 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 );
`

= Can 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:** If you don't like to add your customizations to your main theme's/child theme's `functions.php` file you can also add them to a functionality plugin or an MU-plugin. This way you can also use this better for Multisite environments. In general you are then more independent from theme/child theme changes etc.

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

== Screenshots ==

1. Multisite Toolbar Additions: New Network specific menu items located in "My Sites" toolbar parent item.
2. Multisite Toolbar Additions: Included plugin support for Network aware plugins.
3. Multisite Toolbar Additions: New Sub Site/ Blog items located in the parent item for each site.
4. Multisite Toolbar Additions: New (Sub) Site specific menu items - plus included plugin support for useful site specific plugins.
5. Multisite Toolbar Additions: How the optional Nav Menu for Super Admins works ([click on image for larger view](http://s.wordpress.org/extend/plugins/multisite-toolbar-additions/screenshot-5.png)).
6. Multisite Toolbar Additions: Plugin's help tab on Nav Menu admin page.

== Changelog ==

= 1.0 (2012-08-28) =
* Initial release
* Including support for 4 Multisite aware plugins
* Including support for 7 site specific plugins

== Upgrade Notice ==

= 1.0 =
Just released into the wild.

== Plugin Links ==
* [Translations (GlotPress)](http://translate.wpautobahn.com/projects/wordpress-plugins-deckerweb/multisite-toolbar-additions)
* [User support forums](http://wordpress.org/support/plugin/multisite-toolbar-additions)
* [Code snippets archive for customizing, GitHub Gist](https://gist.github.com/3498510)

== Donate ==
Enjoy using *Multisite Toolbar Additions*? Please consider [making a small donation](http://genesisthemes.de/en/donate/) to support the project's continued development.

== Translations ==

* English - default, always included
* German (de_DE): Deutsch - immer dabei! [Download auch via deckerweb.de](http://deckerweb.de/material/sprachdateien/genesis-plugins/#multisite-toolbar-additions)
* For custom and update-secure language files please upload them to `/wp-content/languages/multisite-toolbar-additions/` (just create this folder) - This enables you to use fully custom translations that won't be overridden on plugin updates. Also, complete custom English wording is possible with that as well, just use a language file like `multisite-toolbar-additions-en_US.mo/.po` to achieve that (for creating one see the following tools).

**Easy plugin translation platform with GlotPress tool:** [**Translate "Multisite Toolbar Additions"...**](http://translate.wpautobahn.com/projects/wordpress-plugins-deckerweb/multisite-toolbar-additions)

*Note:* All my plugins are internationalized/ translateable by default. This is very important for all users worldwide. So please contribute your language to the plugin to make it even more useful. For translating I recommend the awesome ["Codestyling Localization" plugin](http://wordpress.org/extend/plugins/codestyling-localization/) and for validating the ["Poedit Editor"](http://www.poedit.net/), which works fine on Windows, Mac and Linux.

== Additional Info ==
**Idea Behind / Philosophy:** Just a little lightweight plugin for all the Multisite Super Admins out there to make their daily network admin life a bit easier. I'll try to add more plugin support if it makes some sense. So stay tuned :).