=== Plugin Name === Plugin Name: WP Symposium Toolbar Description: The Ultimate Toolbar Plugin - And the WordPress Toolbar can finally be part of your site. Author: AlphaGolf_fr Contributors: AlphaGolf_fr Donate Link: https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick&hosted_button_id=3DELJEHZEFGHQ Tags: wp-symposium, toolbar, adminbar, bar, navigation, nav-menu, menu, menus, theme, brand, branding, members, membership Requires at least: 3.5 Tested up to: 3.8 Stable tag: 0.26.0 Version: 0.26.0 License: GPLv2 or later License URI: http://www.gnu.org/licenses/gpl-2.0.html == Description == Customize the WordPress Toolbar the way *you* want... This plugin is targetted for WP Symposium sites. However, if you're not running a Social Network site but you're willing to customize the Toolbar, you may use this plugin and benefit from its generic per-role settings, its custom menus, as well as its styling settings. Give this plugin a try! = In a nutshell = When I began this project, I was aiming at primarily providing WP Symposium sites with a little more functionality. I needed to ensure WP Symposium is actually activated, and what was initially a safeguard eventually became a feature : WP Symposium Toolbar can function as a stand alone plugin as well as integrate with WP Symposium. Looking at the result, I'd like to stress that the scope of the generic options of this plugin by far exceeds those dedicated to WP Symposium sites solely... Brand the Toolbar: put your logo over your menu at your colours. Gather personal information in one place: in the top right corner of the Toolbar, leaving room in the site for its actual content. Determine which information will be displayed in the Toolbar to each role of your site: hide unneeded information to your members, and eventually hide the backend of the site. Provide navigation from the Toolbar via per role access to custom menus: control which roles can access which parts of your site. Show the Toolbar to non logged-in members, with links to your Login page along with a custom Howdy message. Multisite wise: each site of your network can have individual links and styles, or your network can function as though it is one big site. On top of all this, style the Toolbar beyond the limits of your imagination: colours, gradients, shadow, fonts can all be changed from the Styles settings page, which by the way has a nice real-time preview mode for you to play with the styling before actually saving... You are no longer bound to showing to your members information you don't want them to see. You are no longer bound to using just a theme navbar for navigating your site, or network of sites. You are no longer bound to displaying that dark bar that doesn't fit with the overall look of your site. You are no longer bound to configuring several plugins to make the Toolbar at your wishes. My warm thanks go to Louis, my friend at [Central Geek](http://centralgeek.com), for his help in specifying and testing the plugin. He's always been available with wise advices whenever I was needing them, so that WPS Toolbar is as much his plugin as it is mine. Now the usual bulleted list of features... = Features = * Decide to show or hide each of the default items in the WordPress Toolbar: site-related, content-related and user-related items * Create your custom menus using the WordPress NavMenus page, and add them to the WP Toolbar, along with your custom icons on top of menus * Per-role management for most of the settings, items and menus, adding visitors to the roles of the site * Redesign the WP User Menu ("My Account"), by selecting each of its default items individually and adding your own custom items * WP Symposium sites - Add links to WP Symposium to the WP Toolbar, providing single-click access to WP Symposium from anywhere in your WordPress site * WP Symposium sites - Notify your users of new mails and new friend requests, while linking to their WP Symposium mailbox and friends' list * Style the Toolbar your way: custom colours, gradient, transparency, shadow, fonts, for the Toolbar and its menus * Real-time preview mode at the styling page :-) * Import / export the plugin settings, ideal for backups or exchanging those settings accross your sites == Installation == = Installing the plugin = Use the WordPress feature to install the plugin from the WP Dashboard, Plugins > Add New. Alternatively, download the ZIP file from wordpress.org, extract its content and upload the folder wp-symposium-toolbar via FTP in your path-to/wp-content/plugins folder. A WP Symposium Toolbar plugin should then be available in the 'Plugins' menu in WordPress: activate the plugin. = Upgrading the plugin = Use the WordPress feature to upgrade the plugin from the WP Dashboard. Alternatively, download the zip file and extract its content locally. Deactivate the previous version to avoid any warning due to changes, and upload the folder wp-symposium-toolbar via FTP in your path-to/wp-content/plugins folder. Re-activate the plugin. = Configuring the plugin for your site = A new menu item will appear in the WP Dashboard, called "Toolbar", where you will find options for the plugin. The plugin default settings are relatively conservative, hence upon activation you shouldn't notice much difference in the Toolbar: once the plugin is activated, you should visit the options page, and modify these options so they fit your needs. Please refer to the help tabs of the options page for more information. If you're running WP Symposium, the first activation of the plugin will create default items in the WordPress Toolbar: * For users, it'll add menu items under the WP User Menu on the upper right corner of the screen, and notification icons for mails and friend requests close to that WP User Menu. * It will also add an Admin Menu with links to WP Symposium settings pages, visible only by site admins. The content is that of the WP Dashboard sidebar menu for WP Symposium, you cannot edit it, only show or hide the whole menu. Whether you're running WP Symposium or not, the first activation of the plugin will create one menu, with links to the Login / Register / Lost Password pages, as defined on your site. You may, of course, modify these settings, create your own custom menus, edit the default ones, and eventually remove them from the WP Toolbar. = Sorting out issues (if any!) = If you're running WP Symposium, remember to visit the WP Symposium Install page "after you add a WP Symposium shortcode to a page; change pages with WP Symposium shortcodes; if you change WordPress Permalinks" (as stated by WP Symposium), that will re-generate the WP Symposium Admin menu in the Toolbar. In general, if you notice odd things with the plugin, visit the Options page, and save the options (even unchanged), that will trigger a few cleanup tasks. = Removing the plugin from your site = I would be really sorry to hear that you are not happy with this plugin, but whatever the reason is, you should know that the uninstall process will not remove NavMenus that were created for the Toolbar, since they could be used somewhere else in your site. Therefore, after uninstalling the plugin, please visit the NavMenus page at Appearance > Menus, and remove manually the menus you are no longer using. == Frequently Asked Questions == = When do I need this plugin? = You need this plugin when you'd like to take advantage from its main features: per-role settings and custom menus, as well as its styling settings. When you'd like to hide some of the WP Toolbar default items: the WP logo, the Comments icon (e.g. if comments are totally deactivated on your site, or replaced with a forum), the authors' icons (e.g. if your theme provides these links lower in the page). When you'd like to add or remove items from the User Menu. When you'd like to add a corporate menu in the upper left corner with your own icon. When you'd like to add navigation functionality to the Toolbar. When you'd like the Toolbar to show different information and links based on membership level. Etc... = When don't I need this plugin? = You don't need this plugin if your sole aim is to hide the WP Toolbar. There are other, smaller plugins that are targetted for that, or eventually you could achieve this with a few lines in your theme's functions.php file - google it. = With such a level of functionalities, this plugin must be a resources hog? = Performances have been addressed as best as possible. Most of the job of the plugin is performed off-line upon saving options from the options page. The remaining, dynamic part of the job is performed at page load: all it has to do is take the information or menu, and send it for display if the user can access it. = I have activated your plugin, set the option to show the Toolbar to my role, however I can't see the Toolbar in the frontend ! = In WPS Toolbar settings, make sure the Toolbar should actually show for the role you are using. Even if you already did this, check again. There's a personal setting in the WP profile page for each user to show or hide it independantly, the plugin doesn't enforce this setting so if it's hidden from there, it won't show. Some themes will interfere with the WP Toolbar, some will even stop it from showing at all. Likewise for plugins, but you should be a little more aware of what the plugins you installed do. If unsure, switch to the WordPress default theme, deactivate all plugins but WPS Toolbar, and check if the Toolbar now shows in the frontend. = According to my settings, the admin role should see the Search icon, however I can't see it ! = It will show only in the frontend and not in the backend, have you checked in the frontend, really ? == Screenshots == 1. Share your thoughts with the World in either format, under your custom Toolbar: gradients, transparency, colorful 2. Under the WP Help tabs, the first section of the options allows selecting Toolbar items for each role of your site 3. Create your custom User Menu ("My Account"), here in a minimalist set to which the WPS Profile menu was attached, displayed along with notification icons for WP Symposium mail and friends 4. Ever dreamt of attaching your custom menu to the WP Toolbar ? Now your dream comes true... Multisite users, even better: define Network Custom Menus from one place... == Changelog == = 0.26.0. = * Bugfix: WP 3.8, Styles, incorrect font and background colours, added default values based on WP default color scheme in case user has chosen another scheme * Bugfix: WP 3.8, Styles, icon not hovered when no hover color is set * Change: WP 3.8, Styles, added the option to choose to style the Toolbar in the whole dashboard, in addition to the plugin option page, Styles tab for the preview * Bugfix: make sure styles are generated upon upgrading the plugin * Change: WPMS, added the network feature to list All Sites in a dedicated menu for Super Admins (in addition to My Sites) = 0.25.0. = * Change: add WPS icon to WPS Admin menu * Bugfix: WP 3.8, Styles, preview mode, several issues: manage default values according to WP version, Toolbar items hover missing colour, User Info not picking colour * Bugfix: do not go through symposium_toolbar_custom_profile_update for single sites and do not create useless users metadata * Change: the rendering of the row for "new site settings" at the Sites tab of the plugin options page * Bugfix: WP 3.8, missing avatar in responsive mode when small avatar hidden from Toolbar in plugin settings * Bugfix: style secondary submenus to use their parent's background color even when using WP default value * Bugfix: WPMS, update subsites in all cases as needed, and update style upon new site creation * Bugfix: in RTL, list roles and sites' tabs in descending order from R to L * Bugfix: get rid of PHP notices due to WPST searching for WPS paths when WPS not activated * Bugfix: WPMS, network menus no longer clash with site menus * Bugfix: WP 3.8, WP Search icon had stopped folding / unfolding when on the left side of Toolbar * Bugfix: secure the hook 'symposium_toolbar_add_user_action' behind a test to ensure the current user is actually logged in * Bugfix: move 'symposium_toolbar_custom_profile_option' to the "public" part of the code so it can be found when Edit Profile is called from frontend by other plugins * Change: WPMS, add error messages to Multisite features * Change: error messages no longer removed upon clicking, need to reload page to get rid of them = 0.24.0. = * Bugfix: get rid of PHP warnings on get_option default values for some setups * Bugfix: WP 3.8, Styles tab, saved CSS, secondary-level dropdown menus no longer picking colours due to a change in WP 3.8 (submenu div vs. ul) * Bugfix: WP 3.8, Styles tab, preview mode, default value for icon colour * Change: WPMS, change internal name 'my_home_site' into 'wpst_my_home_site' for the field added to WP profile page * Bugfix: Styles tab, confirmation message no longer fired from the colorpickers, due to Javascript variable not shared between the splitted files * Bugfix: WP 3.7.1, styles not taken into account when no hover colour is selected for menus = 0.23.0. = Important! The plugin is now WP 3.8 compliant, as well as backwards compatible. Whether you are running WP 3.7.1 or WP 3.8, update this plugin now! Multisites installations will benefit from the significant addition of the following functionalities: 1. Force the display of the Toolbar network wide, for selected users, from one place 2. Home Site feature, users can then choose a home site, where the User Menu and the WPS notification icons will bring them preferably to any other of the network 3. Select the subsites you want to be synchronized with the Main Site, by propagating selected settings to these sites automatically rather than visiting subsites one by one 4. Create Network Custom Menus that will be displayed on all sites without Site Admins being able to remove them 5. Share WP Symposium features from the sites where WP Symposium is activated, with all sites of the network Now the detailed changelog entry... * Change: WPMS, when plugin is network activated, add tabs to the Main Site admin page, holding Network settings * Change: WPMS, from Main Site 'Custom Menus' tab, option to make a custom menu network-wide * Change: WPMS, from 'WP Symposium' tab, the option to *search* for WPS features network wide is replaced with the option to *share* them, so that subsites that are not running WPS and might actually need these features, can benefit from these even though WPS tab is hidden on plugin options page at these sites * Bugfix: WPMS, propagate options accross the network upon both activation and updates * Change: User Menu, option to edit the link to the Edit Profile page, defaulting to the WPS Profile page on WP Symposium sites * Change: on non WP Symposium sites, move the WPS Toolbar settings into the Appearance menu * Bugfix: ensure a role's name is set before using it for display on the plugin options page * Bugfix: removed redundant tabs in the HTML of the plugin options page * Bugfix: when forcing the display of the Toolbar from a subsite, remove the WP Profile option for all users * Bugfix: display custom rows with symposium_toolbar_add_user_action even when all the default items are removed * Change: added a carrousel of tabs, so that they display on one row regardless of the screen size while ensuring the active tab is always displayed * Change: User Guide and Dev Guide are now integrated in the admin page, and their content is set dynamically as per selected tabs (in Multisite) * Change: non-Javascript friendly admin page * Change: WP 3.8 compliance, preview now only active on the Styles tab, responsive mode for smaller screens, etc. * BugFix: ensure a full RTL display of the options page * Added Spanish translation, thanks to Maria Ramos at [WebHostingHub](http://www.webhostinghub.com) = 0.22.0. = * Bugfix: do not rely on register_activation_hook for upgrades to ensure options are updated * Bugfix: WP Symposium, avoid redirecting to WPS profile page upon saving from WP profile page * Bugfix: make the plugin work with alternate Search fields like the one proposed by JetPack, and ensure the best possible compatibility with styling its Toolbar items * Code cleanup in the JS file, and rename variables to comply with WordPress naming convention = 0.21.0. = * Bugfix: Styles, default height of the first row in the Site Name frontend dropdown menu * Bugfix: Styles, issue with hover overlapping some of the borders, but not all * Change: Toolbar tab, option to force the display of the WP Toolbar for logged-in users, and hide the checkbox "Show Toolbar while viewing site" at the WP Profile page * Change: Custom Menus, add an error message when the same menu is being displayed for a given role on different locations * Change: make translatable the error string displayed when the admin leaves the page without saving * Bugfix: Styles, dropdown menus highlighted items inheriting colour from normal ones when no specific colour set * Bugfix: Styles, preview mode, font shadow not removed whenever H or V are unset, both for Toolbar and Dropdown menus * Bugfix: Styles, preview mode, Toolbar borders "default" not working when coming from another, saved value = 0.20.0. = * Bugfix: Styles, preview mode, CSS issue in the User Menu, User Info not picking up changes in font color / attributes / shadow * Bugfix: Styles, saved mode, sort out rendering issues with font styles and shadow settings in the dropdown menus * Change: WPMS, autodetect URLs for WP Symposium profile / friends / mail accross the network, and option to deactivate this behaviour * Change: WPMS, add the pseudo-role "User" for network users not member of the current site, to add specific navigation items for such users = 0.19.0. = * Bugfix: Styles, CSS issue in the User Menu, User Info now displays colors and fonts as well as reacts to hover event * Bugfix: Styles, preview mode, menu font shadow, the normal and hover shadows were erroneously linked so that it was needed to define both to show them * Bugfix: Styles, preview mode, toplevel menu items now keep the focus, both in the Toolbar and the dropdown menus * Bugfix: Styles, make the font shadows settings save * Change: remove the Error messages from the options tab upon click, with a JQuery 'slide up' effect rather than a JS 'hide' * Bugfix: CSS issue with visitor's Howdy and blank avatar * Bugfix: sort out flat menus as replacement to WP Logo, by using the first parentless item as parent to any further parentless item * Change: WP Symposium, add the option to show notification icons only when a new event occurs (new mail, new friend) = 0.18.0. = **Important !! This release changes the way settings are stored for site visitors. After the upgrade, please check your settings for visitors. Sorry for the inconvenience and thanks for your understanding** * Options page reworked with tabs rather than closing boxes * Styles added, along with a preview mode at this tab. * Change: renamed pseudo-role 'visitor' into 'wpst_visitor' to avoid clashes with a home-made role or any other plugin or theme * Change: removed the checkbox under the Custom Menus table: WP highlighted links can now be styled specifically, while the plugin cannot create highlighted links in custom menus anyway (as it requires groups of links) * Bugfix: WPMS with menus in subsites being incorrectly linked to main site * Bugfix: WPMS, export in subsites now dumps the settings of the current site, not the main * Change: further to the bugfix above, WPMS subsites now have a button to import main site's settings * Bugfix: missing custom menus no longer mess up the Toolbar menus, and display an error message at the plugin options page * Bugfix: the search icon can now be moved and removed * Change: the hook 'symposium_toolbar_add_user_action' now allows to add several items to user actions - developers, make sure you are returning an array of arrays! PS: I am jumping from 0.0.17 to 0.18.0 to free up the third digit and use it for project internal communication. = 0.0.17. = * Bugfix: CSS issue in the User Menu - hopefully all cases are covered this time... * Bugfix: hide the WP Profile setting to show/hide the Toolbar ("Show Toolbar when viewing site"), when the role cannot see the Toolbar * Bugfix: make the option "add the username to the display name, if different" do what it's supposed to do * Change: Option to add the role under the display name, in the User Menu * First draft of the file developpers.txt, describing the hooks available so far. = 0.0.16. = * Bugfix: CSS issue in the User Menu = 0.0.15. = This release focuses on hardening the plugin: validate the import before saving, ensure the stored options are of the proper type, and warn the admin of any discrepency through the options page... * Protect all array_intersect() with check if the stored option is actually an array, to avoid PHP warnings * Narrow the output for the Export to this plugin options * Add checks to the Import: empty field, unknown option name, wrong option value, and error messages as appropriate * Add error messages to the options page to warn admin of discrepancies in stored options for: arrays of roles, checkboxes, missing menus = 0.0.14. = * Fix help tabs content that was affected by previous bugfix = 0.0.13. = * Getting rid of PHP notices - sorry = 0.0.12. = * Per-role management of the display for most of the items, including visitors' role for non-logged-in * Option to add custom menus at predefined locations in the WP Toolbar, for given roles, along with custom icons for toplevel items * Make use of WP NavMenus for the User Menu and other custom menus - but not the WPS Admin Menu which isn't supposed to be modified * Help tab at the top right of the dashboard options page describing the plugin and its options = 0.0.11. = * Bug fix, profile_url undefined * Remove capability from the User Menu (temporarilly, things will likely change here) = 0.0.10. = * Correct link to "symposium_debug" over the admin menu title "WP Symposium" * Options to hide the Toolbar top links: wp-logo, site-name, my-sites (for multisites), get-shortlink, edit, new-content, comments, updates, search * Option to hide the Howdy message = 0.0.9. = * Hide some debug info at the WPS Install page for multisites = 0.0.8. = * First official release, as beta, for feedback and tests