Control Panel Nav

Fixed

• Fix an error when updating nav items.
• Fix icon not working for nav item, when set to “First Letter”.

Added

• Add Craft Teams support for permissions.

Changed

• Update English translations.

Fixed

• Fix an error when saving or creating layouts.

Changed

• Now requires PHP 8.2.0+.
• Now requires Craft 5.0.0+.
• Update compatibility with Craft 5 menu changes.

Removed

• Remove subnavBehaviour in favour of native Craft 5 menu updates.

Fixed

• Fix order of operations when uninstalling the plugin.

Fixed

• Fix an error when migrating from Craft 3.
• Fix an error for some plugins when trying to determine any subnav items.

Changed

• Only admins are now allowed to access plugin settings.

Fixed

• Fix an error when checking for an authenticated users too early before Craft (and other plugins) are ready.
• Fix icons not rendering correctly on Windows.

Fixed

• Fix multiple nested subnav items not appearing correctly.

Fixed

• Fix subnav items not showing correctly.

Added

• Add support for plugins that use EVENT_REGISTER_CP_NAV_ITEMS to register nav items.

Fixed

• Fix top-level plugins with no subnavs being unable to be nested within another nav item.
• Fix multi-level navigation items expanding when re-ordered.
• Fix toggle/move indicator alignment for settings.
• Fix navigation items being duplicated in some instances.
• Fix an error when trying to set a custom icon on a navigation item.

Removed

• Removed the ability to collapse/expand subnav items in the navigation builder, to fix a few tricky edge cases that are too tricky to deal with!

Fixed

• Fix an issue with subnav items getting saved before their parent navigation item.
• Fix an error when saving navigations and their layout was yet to exist.
• Fix lack of permissions checks for plugin subnav items.
• Fix Craft 3 migration for some plugins.

Fixed

• Fix an error when updating from Craft 3.

Added

• Add english translations.

Fixed

• Fix migration from Craft 3 not generating subnavs.
• Fix an error when rebuilding project config.
• Fix an error when uninstalling.

Fixed

• Fix an error caused by Craft 4.1 removing font data.
• Add checks around JS waitForElm function.

Fixed

• Fix an error when upgrading from Craft 3, when also having for some plugins (SEOmatic) installed.

Fixed

• Fix an error when trying to fetch a layout for a user, when no user session was detected.

Added

• Added the ability to create and manage subnav items.
• Added "Craft" and "Plugin" navigation types, to have more fine-grained control over certain navigation items.
• Added the ability to change the subnav behaviour. Either open only when the parent is active (Craft default), always open, or toggle-state open.
• Added plugin setting to control default subnav behaviour for all navigations.
• Minor UI polish inline with Craft 4 (spinners, colours, shadows, etc).
• Added better support for Craft font-icons, which now parses their icon font files for available glyphs.
• Added project-config/rebuild support.
• Added archiveTableIfExists() to install migration.

Changed

• Now requires PHP 8.0.2+.
• Now requires Craft 4.0.0+.
• Improved performance when rendering navigation items.
• Revamped UI for navigations to allow for nested items.
• Plugin and Craft subpages can now be managed in the navigation builder.
• The rendered HTML navigation is now completely custom, giving us more control over output, allowances for customisation and more.
• Divider navigation items are now customisable.
• Divider navigation items now no longer require a label, and are rendered as a line.
• Navigation items without a URL now render as a heading.
• Navigation items with "New window" enabled now add rel="noopener" to the anchor tag.
• Now requires CP Nav 3.0.17 in order to update from Craft 3.
• Renamed service classes.
• Renamed base plugin methods.

Fixed

• Fixed an issue where in some cases, menu items were still being shown in the user didn't have permission to access it.
• Fixed navigation items getting out of sync for different users.
• Fixed issues comparing the normal Craft-generated navigation with your custom one.
• Fixed an issue where project config wouldn't be kept up to date correctly for navigation items.
• Fixed default layout not always being created on-install.
• Fixed menu items to expand if two similarly-named pages exist and one is active.
• Fixed an error where some new navigation items weren’t created if they had similar handles to other items.
• Removed leftover debug badges.

Removed

• Removed cpnav_pending_navigations database table.

Fixed

• Fix Plugin Store link being hidden for allowAdminChanges = false.
• Fix potential error when migrating nav items.

Fixed

• Fix being unable to remove dividers.
• Fix divider’s not always displaying correctly.
• Fix selected state not being set for Globals.

Added

• Allow CpNav plugin services to be used in console requests. (thanks @jamesmacwhite).

Fixed

• Fix an error with PHP 7.2+ in some cases.

Fixed

• Fixed potential error for layouts without a sortOrder setting.

Fixed

• Fixed potential issue with migration.

Added

• Layouts can now be sorted in the control panel.

Fixed

• Fix project config storing layoutId instead of layoutUid.
• Fix layout and navigation items getting out of sync with project config.

Fixed

• Fix custom icon not working when editing items.

Fixed

• Fix directory separator checks on Windows, causing icon issues.
• Fix over-zealous updates to originalNavHash.

Fixed

• Fix logging error Call to undefined method setFileLogging().

Changed

• File logging now checks if the overall Craft app uses file logging.
• Log files now only include GET and POST additional variables.
• Ensure plugin project config is removed when uninstalling.

Fixed

• Add checks to prevent multiple nav items being added in some instances.

Fixed

• Fix permissions migration causing errors for user group permissions.

Fixed

• Fix migration introduced in 3.0.8.

Fixed

• Add better support for multi-users. Previously, nav's could get confused with multiple CP-enabled users logging in, and being able to run change-detection.
• Add error-handling to checkUpdatedNavItems to prevent fatal errors.

Fixed

• Fix nav re-generating in some circumstances, when it didn't need to.

Fixed

• Fix error thrown on saving a navigation in some instances.
• Fix triggering project config changes when allowAdminChanges is set to false.

Changed

• Add better handling and detection of changed nav, rather than just plugin install/uninstall. For instance, when adding your first section or global.

Fixed

• Fix some icons (including GraphQL) not showing correctly.
• Fix missing order value when resetting nav.

Fixed

• Fix migration errors from Craft 2 > Craft 3.

Changed

• Update icons and sort alphabetically by label. (thanks @dennisfrank).

Fixed

• Fix situations where saving a node throws an error because its layout doesn’t exist.

Fixed

• Fix error in NavigationEvent.

Fixed

• Fix error on brand-new installs, where the default layout wasn’t being created.

Added

• Add better support for user permissions. Previously, even if a user didn't have access to a navigation item, it'd still be shown. Now respects Craft's native user permissions.
• Nav URLs can now contains aliases.
• Add navigation types, for better flexibility going forward.
• Add new divider navigation type, handy for separating items in the menu.
• You can now select an icon from Craft's built-in icons.
• Add Project Config support.

Changed

• Now requires Craft 3.4.x and greater.
• Full refactor from ground-up, focusing on performance, cleanup and best-practices.
• Minimised overhead for CP requests, by removing changed navigation checks.
• Modified navigation items are only checked when enabling/installing or disabling/uninstalling plugins.
• Nav URL is now optional, and also acts like a heading.
• Nav regeneration has been changed to nav resetting. This will completely reset your layout back to stock Craft.

Fixed

• Fix empty navigation handle issue. (thanks @fThues).
• Layout user group IDs now correctly use their UIDs.
• Fix error for non-local volumes when using a custom icon.

Added

• Added better visual notification when editing a nav.

Fixed

• Fix custom icons not resolving with aliases.
• Fix errors when installing via console.
• Fix redirection issue for settings.

Added

• Add nav regenerate settings

Fixed

• Fix default icons not appearing (showing as placeholders)
• Fix missing template translations

Fixed

• Fix Craft native menu item icons

Fixed

• Fix hardcoded plugin icons

Fixed

• Fix for count() error in PHP 7.2+
• Badge support
• Fix incorrect column default values for plugin
• Fix subnav items not working correctly for some plugins

Fixed

• Fix for Craft 3.0 (changing Client to Solo)
• Fix not including sub-navigation of plugins
• Fix not including sel class on menu items
• Fix icon path check to ignore directories

Fixed

• Fix for siteUrl config settings throwing an error when more than one site is defined
• Update Craft CMS requirements

Fixed

• Fixed issue when using arrays in configuration files. Thanks to @juresrpcic via #30.
• Fixed issue with volumes sources when adding a custom icon.

Changed

• Updated for Craft 3 RC1.

Added

• Craft 3 initial release.

Added

• Verbb marketing (new plugin icon, readme, etc).

Changed

• Don’t store handle as an AttributeType::Handle.
• Better error-handling when adding/saving nav item.

Added

• Support for Craft 2.6.2951.

Changed

• Now restores original nav if errors are thrown during the nav generation process (PHP7+ only).
• Enforce only image selection for custom icon.
• Allow custom icons to override default Craft/Plugin icons.

Fixed

• Fixed selected custom icon not populating asset element select field.
• Check if a custom icon asset exists before trying to apply it to the nav.

Fixed

• Fixed issues when saving nav items in some cases.
• Fixed issue where Permissions option for layouts was required when saving/editing.
• Fixed minor UI issues with HUD when editing nav and layout items.

Added

• Added support for translations with menu labels.
• Added ability to upload and set custom icons for menu items.

Fixed

• Fixed issue with {siteUrl} being an array not a string. Thanks to @slelorrain.

Added

• Added {siteUrl} twig tag when creating nav items.

Fixed

• Fixed issue with url's not being properly sanitised and processed.

Fixed

• Fixed issue with plugin release feed url.

Added

• Craft 2.5 support, including release feed and icons.
• Added Layouts - set different navigations and assign to user groups. Great for creating client-specific navigation, without changing navigation for other users.

Changed

• Completely re-written from the ground up for better performance and tidiness.
• Removed Quick-Add menu for the moment.

• Minor fix when editing non-manual nav items. URL field is disabled - therefore not passed to controller.

• Added Quick-Add menu button to right-hand utilities area of CP navigation. Can be turned off globally, or restricted via user permissions.