=== Admin Menu Editor Pro === Contributors: whiteshadow Donate link: https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick&hosted_button_id=A6P9S6CE3SRSW Tags: admin, dashboard, menu, security, wpmu Requires at least: 4.1 Tested up to: 4.9.1 Stable tag: 2.6.1 Lets you directly edit the WordPress admin menu. You can re-order, hide or rename existing menus, add custom menus and more. == Description == Pro version of the Admin Menu Editor plugin. Lets you manually edit the Dashboard menu. You can reorder the menus, show/hide specific items, change access rights, and more. [Get the latest version here.](http://adminmenueditor.com/updates/) **Pro Version Features** - Import/export custom menus. - Set menu items to open in a new window or IFrame. - Improved, role-based menu permissions interface. - Use shortcodes in menu fields. - Create menus accessible only to a specific user (by setting extra capability to "user:username"). **Other Features** - Change menu title, access rights, URL and more. - Create custom menus. - Sort items using a simple drag & drop interface. - Move items to a different submenus. - Hide any menu or submenu item. - Supports WordPress MultiSite/WPMU. **Requirements** - WordPress 4.1 or later _For maximum compatibility and security, using a modern web browser such as Firefox, Opera, Chrome or Safari is recommended. Certain advanced features (e.g. menu import) may not work reliably or at all in Internet Explorer and other outdated browsers._ **Credits** This plugin uses some icons from the ["Silk" icon set](http://fortawesome.github.io/Font-Awesome/) by Mark James. These icons are licensed under the [Creative Commons Attribution 3.0 License](http://creativecommons.org/licenses/by/3.0/). == Installation == _If you already have the free version of Admin Menu Editor installed, deactivate it before installing the Pro version._ **Normal installation** 1. Download the admin-menu-editor-pro.zip file to your computer. 1. Unzip the file. 1. Upload the `admin-menu-editor-pro` directory to your `/wp-content/plugins/` directory. 1. Activate the plugin through the 'Plugins' menu in WordPress. That's it. You can access the the menu editor by going to _Settings -> Menu Editor Pro_. The plugin will automatically load your current menu configuration the first time you run it. **WP MultiSite installation** If you have WordPress set up in multisite ("Network") mode, you can also install Admin Menu Editor as a global plugin. This will enable you to edit the Dashboard menu for all sites and users at once. 1. Download the admin-menu-editor-pro.zip file to your computer. 1. Unzip the file. 1. Create a new directory named `mu-plugins` in your site's `wp-content` directory (unless it already exists). 1. Upload the `admin-menu-editor-pro` directory to `/wp-content/mu-plugins/`. 1. Move `admin-menu-editor-mu.php` from `admin-menu-editor-pro/includes` to `/wp-content/mu-plugins/`. Plugins installed in the `mu-plugins` directory are treated as "always on", so you don't need to explicitly activate the menu editor. Just go to _Settings -> Menu Editor_ and start customizing your admin menu :) _Notes_ - Instead of installing Admin Menu Editor in `mu-plugins`, you can also install it normally and then activate it globally via "Network Activate". However, this will make the plugin visible to normal users when it is inactive (e.g. during upgrades). - When Admin Menu Editor is installed in `mu-plugins` or activated via "Network Activate", only the "super admin" user can access the menu editor page. Other users will see the customized Dashboard menu, but be unable to edit it. - It is currently not possible to install Admin Menu Editor as both a normal and global plugin on the same site. == Notes == Here are some usage tips and other things that can be good to know when using the menu editor : - WordPress uses the concept of [roles and capabilities](http://codex.wordpress.org/Roles_and_Capabilities "An overview of roles and capabilities") to manage access rights. Each Dashboard menu item has an associated capability setting, and only the users that possess that capability can see and use that menu item. - "Hidden" menus are invisible to everyone - including the administrator - but they can still be accessed via the direct page URL. To make a menu inaccessible to certain users, edit its permissions. - If you delete any of the default menus they will reappear after saving. This is by design. To get rid of a menu for good, either hide it or set it's access rights to a higher level. == Changelog == [Get the latest version here.](http://adminmenueditor.com/updates/) = 2.6.1 (2018-01-07) = ##### Added * Added a list of basic tutorials to the menu editor screen. ##### Fixed * Fixed a bug where menu items that use meta capabilities would have the "hidden from everyone" icon even if there were not actually hidden. * Fixed incorrect version numbers in the "can't import settings from a newer version" error message. * Fixed a bug that could cause some network admin menus to be highlighted as if they were new. * Fixed a conflict with WP Courseware 4.1.2 where activating AME would cause a lot of extra menu items to show up unexpectedly. ##### Changed * The plugin will display a warning if you try to hide the "Slug" metabox. Due to a known bug in WordPress, hiding this box can prevent you from changing the post permalink. * Replaced the green puzzle-piece icon that was used to mark new items with an icon that just says "new". * Tested with 4.9.1. = 2.6 (2017-11-09) = ##### Fixed * Added a workaround for a buggy "defer_parsing_of_js" code snippet that some users have added to their functions.php. This snippet produces invalid HTML code, which used to break the menu editor. * Fixed a bug that caused WP-CLI to behave as if there were no installed plugins and no available updates. * Fixed the "Tags" menu showing up as inaccessible. * Fixed missing color labels in WordPress 4.9. * Fixed a PHP warning that appeared when using this plugin together with WooCommerce or YITH WooCommerce Gift Cards and running PHP 7.1. * Fixed a bug that prevented some capability changes from being applied. * Fixed a bug where submenu items would not inherit FontAwesome icons from their parent menu. ##### Added * You can now edit the network admin menu. The settings page is in the network admin, under "Settings -> Menu Editor Pro". Note that you still need to go to a site dashboard to edit the regular admin menu. * The "Embed WP page" feature now works with private pages and posts, not just public pages. * Added the ability to hide the special "Welcome" widget. ##### Changed * Minor performance improvements. * Tested with WP 4.8.3 and 4.9-RC2. = 2.5.1 (2017-06-09) = ##### Fixed * Fixed a WP-CLI compatibility issue where some CLI commands would fail with a fatal error: "Call to a member function check_current_user_access() on null". * Fixed a couple of UI layout issues that affected RTL sites. * Fixed a conflict with WP Nag Hide that prevented the "Open in": "New window" setting from working. * Fixed an oversight that could cause a fatal error if a theme or plugin was using magic methods (i.e. __call and __callStatic) for hook callbacks. * Fixed a CSS issue where, when changing the menu icon, certain Dashicons wouldn't properly replace the original icon. = 2.5 (2017-06-05) = ##### Added * You can edit plugin names and descriptions through the "Plugins" tab. This only changes how plugins are displayed on the "Plugins" page. It doesn't affect plugin files on disk. * Added "Meta Boxes" tab. It lets you hide meta boxes and custom fields from roles and users. * Added an option to highlight new menu items. This feature is off by default. You can enable it in the "Settings" tab. * Added an option to compress menu data that the plugin stores in the database. This significantly reduces the size of the relevant database entries, but it also adds some decompression overhead to every admin page load. You can enable this feature in the "Settings" tab. ##### Fixed * Added a compatibility workaround for the Divi Training plugin. The hidden menu items that it adds to the "Dashboard" menu should no longer show up when you activate AME. * Added a workaround that improves compatibility with plugins that set their menu icons using CSS. Previously, there were situations where users were not able to change menu icons because the plugin that created the menu item used CSS to override the normal icon. AME now adds an extra stylesheet that overrides icons with !important. * Fixed an old bug where sorting menu items would put all separators at the top. Now they'll stay near their preceding menu item. * Fixed incorrect shadows on custom screen options links. * Fixed a couple of UI layout issues that were caused by bugs in other plugins. * Fixed a rare issue where hiding the admin bar would leave behind empty space. ##### Changed * Minor performance optimizations. * When you use the "A-Z" button to sort top level menus, it also sorts submenu items. To avoid compatibility issues, the first item of each submenu stays in its original position. * Automatically reset plugin access if the only allowed user no longer exists. This should cut down on the number of users who accidentally lock themselves out by setting "Who can access the plugin" to "Only the current user" and then later deleting that user account. = 2.4.3 (2017-01-05) = * Added a workaround for WooCommerce 2.6.8 to display the number of new orders in the "Orders" menu title. * Tested with WP 4.7 and 4.8-alpha. = 2.4.2 (2016-10-21) = ##### Added * Added a way to completely hide the admin menu and the Toolbar (a.k.a Admin Bar) from specific roles or users. * You can now copy menu permissions from one user to another with the "Copy permissions" toolbar button. Note that this button is hidden by default. To reveal it, click the rightmost button that looks like a double down arrow. ##### Fixed * Fixed a bug where opening and closing the properties of a new menu item would set "extra capability" to "read". * The "Welcome to All in One SEO Pack" menu item no longer shows up after activating the menu editor. * Fixed an inconsequential "403 Forbidden" error in Chrome dev toools that was caused by Chrome trying and failing to load source maps for certain CSS & JS files. = 2.4.1 (2016-08-29) = * The plugin now remembers the last selected menu item and re-selects it after you save changes. * Fixed a layout issue where menus with very long titles would appear incorrectly in the menu editor. * When you change the menu title, the window title will also be changed to match it. You can still edit the window title separately if necessary. * Moved the "Icon URL" field up and moved "Window title" down. = 2.4 (2016-08-15) = * Added Font Awesome icons. * Added a "Users" tab that lets you hide individual users. Hidden users don't show up on the "All Users" page and they can't be edited or deleted by normal users. However, they can still show up in other parts of the WP admin (e.g. as post authors), and their content is not specially protected. * Added more detailed permission error messages. You can turn them off in the "Settings" tab by changing "Error verbosity level" to "Low". * Fixed the "Cancel" button in the "Select Visible Users" dialog not working when the "Plugins" tab is open. * Tested up to WP 4.6. = 2.3.1 (2016-06-16) = * Allow the activation of license keys that no longer have access to updates. Previously activation could fail, which was confusing and made some users think that their key was invalid. Now "expired" keys can be properly activated (though they still don't get plugin updates). = 2.3 (2016-06-11) = * Added the "Plugins" tab. It lets you hide specific plugins from other users. Note that this only affects the list on the "Plugins" page and tasks like editing plugin files, but it doesn't affect the admin menu. If you hide a plugin, its menu items will still show up (assuming the user has the required permissions). * Fixed the role/user list in the "Permissions" popup. Now it should show all selected users, not just the current user. * Fixed wp-cli integration. = 2.2.3 (2016-05-22) = * Fixed a bug where selecting a role and then creating a new menu item could render most of the admin menu inaccessible to all other roles. This bug was introduced in version 2.2.2. = 2.2.2 (2016-05-11) = ##### Fixed * Fixed a bug that made menu items "jump" slightly to the left when you start to drag them. * Fixed a bug that caused menu items with the required capability "administrator" to appear unchecked (= hidden) for the Administrator role. This also applies to other roles. * Fixed a Multisite-specific bug where temporarily switching to another site using the switch_to_blog() function could result in the user having the wrong permissions. ##### Changed * When saving settings, the plugin will compress the menu data before sending it to the server. This reduces the chances of exceeding request size limits that are imposed by some hosting companies. * Tested up to WordPress 4.5.2. = 2.2.1 (2016-04-16) = ##### Fixed * Fixed a bug where typing in the search box in the "Choose Visible Users" dialog didn't do anything. Now it will actually search the list of registered users. This bug was introduced in version 2.2. * Fixed a bug that prevented CPT permissions from working. This bug was also introduced in version 2.2. * Fixed a backwards-compatibility bug related to the Ninja Forms plugin. * Fixed a bug in the "Modern" editor theme that caused the "embed WordPress page" panel to appear underneath the selected menu item, making it near-impossible to see the panel. ##### Changed * You can dismiss the "Settings saved" notification by clicking the "x" button. = 2.2 = ##### Added * Added a "Colors" button that lets you set the default color scheme for all admin menus at once. * Added a few more menu icons. * Added basic support for the special "customize" and "delete_site" meta capabilities. ##### Fixed * Fixed a "deprecated constructor" warning on sites running PHP 7. * Fixed a bug that prevented menu items with an empty slug (i.e. no URL) from showing up. * Fixed a bug where collapsing submenu properties would flag the "Icon URL" field as having a custom value even if you hadn't actually changed it. * Fixed a rare WPML conflict that sometimes caused the admin menu to use a mix of different languages. * Improved compatibility with buggy plugins and themes that throw JavaScript errors in their DOM-ready handlers. * Renamed jquery.cookie.js to jquery.biscuit.js as a workaround for servers with overly aggressive ModSecurity configuration. Apparently, some servers block access to any URL that contains the text ".cookie". * Added a compatibility workaround for the DW Question & Answer plugin. The hidden "Welcome", "Changelog" and "Credits" menu items should no longer show up when you activate AME. * Added locking to reduce the risk of triggering a race condition when saving menu settings. ##### Changed * Added tabs to the settings page: "Admin Menu" and "Settings". These tabs replace the heading buttons that were previously used to switch between the menu editor and general plugin settings. * Tested up to WordPress 4.5-RC1. = 2.1 = ##### Added * Added a new editor colour scheme that makes the menu editor look more like other WordPress admin pages (e.g. Appearance -> Menus). You can enable it through the plugin settings page. * New menu items that are added by other plugins will now show up in the same relative position as they would be in the default admin menu. Alternatively, they can be displayed at the bottom of the menu. You can configure this in plugin settings. ##### Fixed * Fixed JavaScript error "_.empty is not a function". * Improved compatibility with IP Geo Block. * Fixed a layout issue where starting to drag one menu item would cause some other items to move around or change size very slightly. * Fixed a misleading tooltip. ##### Changed * Tested up to WordPress 4.4-RC1. * Show an error message if an update fails due to license problems (expired key, key not activated, etc). Previously updates done through the "Dashboard -> Updates" pages would fail with a vague download error, and inline updates would hang at "Updating..." indefinitely. = 2.0 = ##### Added * Added "Choose users..." link that lets you select which users will show up in the menu editor. This makes it easier to change menu permissions for specific users. * Added "Hide all submenu items when this item is hidden" setting. Normally, a top level menu stays visible as long as it has at least one accessible submenu item (that's just how WordPress works). You can use this setting to override that, forcing all submenu items to stay hidden if the user doesn't have access to the parent menu. Note that this can break plugins that rely on the default WordPress behaviour, so use with care. * Added "Frame height" field. You can manually set the height of `