=== 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.5
Stable tag: 1.2.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, useful third-party 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, Code Snippets, BackWPup, User Management Tools, Network Mass Email, Organizational Message Notifier, Snapshot (premium), Ultimate Branding (premium), Login Security Solution
* *(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), Code With WP Code Snippets, Toolbox Modules, Relevanssi & Relevanssi Premium, Multisite Language Switcher
* Plugin is fully internationalized, English & German by default :)
* Fully WPML compatible!
* WordPress 3.3 or higher (3.4+ recommended)! 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
* ["User Management Tools" (free, by scribu/AppThemes)](http://wordpress.org/extend/plugins/user-management-tools/) - also network wide
* ["Network Mass Email" (free, Kenny Zaron)](http://wordpress.org/extend/plugins/network-mass-email/) - also network wide
* ["Organizational Message Notifier" (free, Zaantar)](http://wordpress.org/extend/plugins/organizational-message-notifier/) - also network wide
* ["Code Snippets" (free, by Shea Bunge)](http://wordpress.org/extend/plugins/code-snippets/) - also network wide
* ["BackWPup" (free, by Daniel Hüsken)](http://wordpress.org/extend/plugins/backwpup/) - also network wide
* ["Snapshot" (premium, by Paul Menard (Incsub)/ WPMU DEV)](http://ddwb.me/8f) - also network wide
* ["Ultimate Branding" (premium, by Incsub Team/ WPMU DEV)](http://ddwb.me/8g) - also network wide
* ["Login Security Solution" (free, by Daniel Convissor)](http://wordpress.org/extend/plugins/login-security-solution/) - also network wide
* ["Multisite Language Switcher" (free, Dennis Ploetner)](http://wordpress.org/extend/plugins/multisite-language-switcher/)
* ["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/)
* ["Code With WP Code Snippets" (free, by Thomas Griffin)](https://github.com/thomasgriffin/CWWP-Custom-Snippets) (plugin currently in beta, hosted at GitHub)
* ["Toolbox Modules" (free, by Sergej Müller)](http://wordpress.org/extend/plugins/toolbox/) - see also his [plugin instructions](http://playground.ebiene.de/toolbox-wordpress-plugin/)
* ["Relevanssi" (free)](http://wordpress.org/extend/plugins/relevanssi/) and ["Relevanssi Premium" (premium)](http://www.relevanssi.com) both by Mikko Saari
* *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 :)

**Single install:** The plugin also working like a charm - 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 :).

**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.

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

= 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:

* [**"What is a functionality plugin and how to create one?"**](http://wpcandy.com/teaches/how-to-create-a-functionality-plugin) - *blog post by WPCandy*
* [**"Creating a custom functions plugin for end users"**](http://justintadlock.com/archives/2011/02/02/creating-a-custom-functions-plugin-for-end-users) - *blog post by Justin Tadlock*
* DON'T hack your `functions.php` file: [Resource One](http://thomasgriffinmedia.com/custom-snippets-plugin/) - [Resource Two](http://thomasgriffinmedia.com/blog/2012/09/calling-on-the-wordpress-community/) *(both by Thomas Griffin Media)*
* [**"Code Snippets"** plugin by Shea Bunge](http://wordpress.org/extend/plugins/code-snippets/) - also network wide!
* [**"Code With WP Code Snippets"** plugin by Thomas Griffin](https://github.com/thomasgriffin/CWWP-Custom-Snippets) - Note: Plugin currently in development at GitHub.
* [**"Toolbox Modules"** plugin by Sergej Müller](http://wordpress.org/extend/plugins/toolbox/) - see also his [plugin instructions](http://playground.ebiene.de/toolbox-wordpress-plugin/).

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 ([click on image for larger view](https://www.dropbox.com/s/m6w6h8icr44e568/screenshot-1.png)).
2. Multisite Toolbar Additions: Included plugin support for Network aware plugins ([click on image for larger view](https://www.dropbox.com/s/ztu9haeh48eg6lr/screenshot-2.png)).
3. Multisite Toolbar Additions: New Sub Site/ Blog items located in the parent item for each site ([click on image for larger view](https://www.dropbox.com/s/a0qhymxlpkn1qox/screenshot-3.png)).
4. Multisite Toolbar Additions: New (Sub) Site specific menu items - plus included plugin support for useful site specific plugins ([click on image for larger view](https://www.dropbox.com/s/w0aoaxwfqfw7iq2/screenshot-4.png)).
5. Multisite Toolbar Additions: How the optional Nav Menu for Super Admins works ([click on image for larger view](https://www.dropbox.com/s/7u83c0g5ehk4ozq/screenshot-5.png)).
6. Multisite Toolbar Additions: Plugin's help tab on Nav Menu admin page ([click on image for larger view](https://www.dropbox.com/s/dt6kkxqsh7yvbfn/screenshot-6.png)).

== Changelog ==

= 1.2.0 (2012-11-27) =
* *Extended plugin support:*
 * NEW: Added support for "Snapshot" (premium, by Paul Menard (Incsub)/ WPMU DEV).
 * NEW: Added support for "Ultimate Branding" (premium, by Incsub Team/ WPMU DEV).
 * NEW: Added support for "Login Security Solution" (free, by Daniel Convissor).
* NEW: In Network Admin added 'Dashboard' link for main site to 'site-name' menu.
* CODE: Minor code/ documentation updates & improvements.
* UPDATE: Updated German translations and also the .pot file for all translators!

= 1.1.1 (2012-10-05) =
* BUGFIX: Corrected settings link for "Multisite Language Switcher" plugin - sorry!

= 1.1.0 (2012-09-18) =
* *Extended plugin support:*
 * NEW: Added support for "User Management Tools" (free, by scribu/AppThemes).
 * NEW: Added support for "Network Mass Email" (free, Kenny Zaron).
 * NEW: Added support for "Organizational Message Notifier" (free, Zaantar).
 * NEW: Added support for "Multisite Language Switcher" (free, Dennis Ploetner).
 * NEW: Added support for "Code Snippets" (free, by Shea Bunge).
 * NEW: Added support for "Code With WP Code Snippets" (free, by Thomas Griffin) (plugin currently in beta, [hosted at GitHub](https://github.com/thomasgriffin/CWWP-Custom-Snippets)).
 * NEW: Added support for "BackWPup" (free, by Daniel Hüsken).
 * NEW: Added support for "Toolbox Modules" (free, by Sergej Müller) - see also his [plugin instructions](http://playground.ebiene.de/toolbox-wordpress-plugin/).
 * NEW: Added support for "Relevanssi" (free) and "Relevanssi Premium" (premium) both by Mikko Saari, http://www.relevanssi.com.
* CODE: Performance optimizing to load code for a lot of plugins only if ever needed (when activated).
* NEW: Added CSS class suport for the Custom WP Nav Menu for Super Admins (via regular WP Menus!).
* UPDATE: Updated and improved readme.txt file here.
* UPDATE: Updated German translations and also the .pot file for all translators!
* UPDATE: Initiated new three digits versioning, starting with this version.
* UPDATE: Moved screenshots to 'assets' folder in WP.org SVN to reduce plugin package size.

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

== Upgrade Notice ==

= 1.2.0 =
Several Additions & Improvements: Extended plugin support. Updated German translations as well as .pot file for translators.

= 1.1.1 =
Small update: Corrected a supported plugin's settings link.

= 1.1.0 =
Several Additions & Improvements: Extended plugin support. Code performance optimizing. Updated German translations as well as .pot file for translators.

= 1.0.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 :).