Control Panel Nav Changelog

Keep up to date with all the changes with Control Panel Nav.

Control Panel Nav 5.x is on version 4.0.12, released on Mar 04, 2024

  • theicons.co/svg/photo-09 Created with Sketch. 28 New features
  • theicons.co/svg/others-47 Created with Sketch. 33 Improvements
  • theicons.co/svg/home-36 Created with Sketch. 92 Bug fixes
View latest release (4.0.12) on the Plugin Store

4.0.12 - Latest Release

Released Mar 04, 2024

  • theicons.co/svg/home-36 Created with Sketch.

    Fix order of operations when uninstalling the plugin.

4.0.11

Released Oct 25, 2023

  • theicons.co/svg/home-36 Created with Sketch.

    Fix an error when migrating from Craft 3.

  • theicons.co/svg/home-36 Created with Sketch.

    Fix an error for some plugins when trying to determine any subnav items.

4.0.10

Released Jan 18, 2023

  • theicons.co/svg/others-47 Created with Sketch.

    Only admins are now allowed to access plugin settings.

  • theicons.co/svg/home-36 Created with Sketch.

    Fix an error when checking for an authenticated users too early before Craft (and other plugins) are ready.

  • theicons.co/svg/home-36 Created with Sketch.

    Fix icons not rendering correctly on Windows.

4.0.9

Released Nov 13, 2022

  • theicons.co/svg/home-36 Created with Sketch.

    Fix multiple nested subnav items not appearing correctly.

4.0.8

Released Nov 08, 2022

  • theicons.co/svg/home-36 Created with Sketch.

    Fix subnav items not showing correctly.

4.0.7

Released Oct 27, 2022

  • theicons.co/svg/photo-09 Created with Sketch.

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

  • theicons.co/svg/home-36 Created with Sketch.

    Fix top-level plugins with no subnavs being unable to be nested within another nav item.

  • theicons.co/svg/home-36 Created with Sketch.

    Fix multi-level navigation items expanding when re-ordered.

  • theicons.co/svg/home-36 Created with Sketch.

    Fix toggle/move indicator alignment for settings.

  • theicons.co/svg/home-36 Created with Sketch.

    Fix navigation items being duplicated in some instances.

  • theicons.co/svg/home-36 Created with Sketch.

    Fix an error when trying to set a custom icon on a navigation item.

  • theicons.co/svg/home-36 Created with Sketch.

    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!

4.0.6

Released Aug 23, 2022

  • theicons.co/svg/home-36 Created with Sketch.

    Fix an issue with subnav items getting saved before their parent navigation item.

  • theicons.co/svg/home-36 Created with Sketch.

    Fix an error when saving navigations and their layout was yet to exist.

  • theicons.co/svg/home-36 Created with Sketch.

    Fix lack of permissions checks for plugin subnav items.

  • theicons.co/svg/home-36 Created with Sketch.

    Fix Craft 3 migration for some plugins.

4.0.5

Released July 29, 2022

  • theicons.co/svg/home-36 Created with Sketch.

    Fix an error when updating from Craft 3.

4.0.4

Released July 22, 2022

  • theicons.co/svg/photo-09 Created with Sketch.

    Add english translations.

  • theicons.co/svg/home-36 Created with Sketch.

    Fix migration from Craft 3 not generating subnavs.

  • theicons.co/svg/home-36 Created with Sketch.

    Fix an error when rebuilding project config.

  • theicons.co/svg/home-36 Created with Sketch.

    Fix an error when uninstalling.

4.0.3

Released July 05, 2022

  • theicons.co/svg/home-36 Created with Sketch.

    Fix an error caused by Craft 4.1 removing font data.

  • theicons.co/svg/home-36 Created with Sketch.

    Add checks around JS waitForElm function.

4.0.2

Released June 08, 2022

  • theicons.co/svg/home-36 Created with Sketch.

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

4.0.1

Released May 26, 2022

  • theicons.co/svg/home-36 Created with Sketch.

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

4.0.0

Released May 05, 2022

  • theicons.co/svg/photo-09 Created with Sketch.

    Added the ability to create and manage subnav items.

  • theicons.co/svg/photo-09 Created with Sketch.

    Added "Craft" and "Plugin" navigation types, to have more fine-grained control over certain navigation items.

  • theicons.co/svg/photo-09 Created with Sketch.

    Added the ability to change the subnav behaviour. Either open only when the parent is active (Craft default), always open, or toggle-state open.

  • theicons.co/svg/photo-09 Created with Sketch.

    Added plugin setting to control default subnav behaviour for all navigations.

  • theicons.co/svg/photo-09 Created with Sketch.

    Minor UI polish inline with Craft 4 (spinners, colours, shadows, etc).

  • theicons.co/svg/photo-09 Created with Sketch.

    Added better support for Craft font-icons, which now parses their icon font files for available glyphs.

  • theicons.co/svg/photo-09 Created with Sketch.

    Added project-config/rebuild support.

  • theicons.co/svg/photo-09 Created with Sketch.

    Added archiveTableIfExists() to install migration.

  • theicons.co/svg/others-47 Created with Sketch.

    Now requires PHP 8.0.2+.

  • theicons.co/svg/others-47 Created with Sketch.

    Now requires Craft 4.0.0+.

  • theicons.co/svg/others-47 Created with Sketch.

    Improved performance when rendering navigation items.

  • theicons.co/svg/others-47 Created with Sketch.

    Revamped UI for navigations to allow for nested items.

  • theicons.co/svg/others-47 Created with Sketch.

    Plugin and Craft subpages can now be managed in the navigation builder.

  • theicons.co/svg/others-47 Created with Sketch.

    The rendered HTML navigation is now completely custom, giving us more control over output, allowances for customisation and more.

  • theicons.co/svg/others-47 Created with Sketch.

    Divider navigation items are now customisable.

  • theicons.co/svg/others-47 Created with Sketch.

    Divider navigation items now no longer require a label, and are rendered as a line.

  • theicons.co/svg/others-47 Created with Sketch.

    Navigation items without a URL now render as a heading.

  • theicons.co/svg/others-47 Created with Sketch.

    Navigation items with "New window" enabled now add rel="noopener" to the anchor tag.

  • theicons.co/svg/others-47 Created with Sketch.

    Now requires CP Nav 3.0.17 in order to update from Craft 3.

  • theicons.co/svg/others-47 Created with Sketch.

    Renamed service classes.

  • theicons.co/svg/others-47 Created with Sketch.

    Renamed base plugin methods.

  • theicons.co/svg/home-36 Created with Sketch.

    Fixed an issue where in some cases, menu items were still being shown in the user didn't have permission to access it.

  • theicons.co/svg/home-36 Created with Sketch.

    Fixed navigation items getting out of sync for different users.

  • theicons.co/svg/home-36 Created with Sketch.

    Fixed issues comparing the normal Craft-generated navigation with your custom one.

  • theicons.co/svg/home-36 Created with Sketch.

    Fixed an issue where project config wouldn't be kept up to date correctly for navigation items.

  • theicons.co/svg/home-36 Created with Sketch.

    Fixed default layout not always being created on-install.

  • theicons.co/svg/home-36 Created with Sketch.

    Fixed menu items to expand if two similarly-named pages exist and one is active.

  • theicons.co/svg/home-36 Created with Sketch.

    Fixed an error where some new navigation items weren’t created if they had similar handles to other items.

  • theicons.co/svg/home-36 Created with Sketch.

    Removed leftover debug badges.

  • theicons.co/svg/home-36 Created with Sketch.

    Removed cpnav_pending_navigations database table.

3.0.17

Released June 30, 2021

  • theicons.co/svg/home-36 Created with Sketch.

    Fix Plugin Store link being hidden for allowAdminChanges = false.

  • theicons.co/svg/home-36 Created with Sketch.

    Fix potential error when migrating nav items.

3.0.16

Released May 30, 2021

  • theicons.co/svg/home-36 Created with Sketch.

    Fix being unable to remove dividers.

  • theicons.co/svg/home-36 Created with Sketch.

    Fix divider’s not always displaying correctly.

  • theicons.co/svg/home-36 Created with Sketch.

    Fix selected state not being set for Globals.

3.0.15

Released Feb 03, 2021

  • theicons.co/svg/photo-09 Created with Sketch.

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

  • theicons.co/svg/home-36 Created with Sketch.

    Fix an error with PHP 7.2+ in some cases.

3.0.14

Released Jan 22, 2021

  • theicons.co/svg/home-36 Created with Sketch.

    Fixed potential error for layouts without a sortOrder setting.

3.0.13.1

Released Aug 12, 2020

  • theicons.co/svg/home-36 Created with Sketch.

    Fixed potential issue with migration.

3.0.13

Released Aug 12, 2020

  • theicons.co/svg/photo-09 Created with Sketch.

    Layouts can now be sorted in the control panel.

  • theicons.co/svg/home-36 Created with Sketch.

    Fix project config storing layoutId instead of layoutUid.

  • theicons.co/svg/home-36 Created with Sketch.

    Fix layout and navigation items getting out of sync with project config.

3.0.12

Released Apr 28, 2020

  • theicons.co/svg/home-36 Created with Sketch.

    Fix custom icon not working when editing items.

3.0.11

Released Apr 21, 2020

  • theicons.co/svg/home-36 Created with Sketch.

    Fix directory separator checks on Windows, causing icon issues.

  • theicons.co/svg/home-36 Created with Sketch.

    Fix over-zealous updates to originalNavHash.

3.0.10

Released Apr 16, 2020

  • theicons.co/svg/home-36 Created with Sketch.

    Fix logging error Call to undefined method setFileLogging().

3.0.9

Released Apr 15, 2020

  • theicons.co/svg/others-47 Created with Sketch.

    File logging now checks if the overall Craft app uses file logging.

  • theicons.co/svg/others-47 Created with Sketch.

    Log files now only include GET and POST additional variables.

  • theicons.co/svg/others-47 Created with Sketch.

    Ensure plugin project config is removed when uninstalling.

  • theicons.co/svg/home-36 Created with Sketch.

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

3.0.8.2

Released Apr 01, 2020

  • theicons.co/svg/home-36 Created with Sketch.

    Fix permissions migration causing errors for user group permissions.

3.0.8.1

Released Mar 16, 2020

  • theicons.co/svg/home-36 Created with Sketch.

    Fix migration introduced in 3.0.8.

3.0.8

Released Mar 16, 2020

  • theicons.co/svg/home-36 Created with Sketch.

    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.

  • theicons.co/svg/home-36 Created with Sketch.

    Add error-handling to checkUpdatedNavItems to prevent fatal errors.

3.0.7

Released Feb 28, 2020

  • theicons.co/svg/home-36 Created with Sketch.

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

3.0.6

Released Feb 25, 2020

  • theicons.co/svg/home-36 Created with Sketch.

    Fix error thrown on saving a navigation in some instances.

  • theicons.co/svg/home-36 Created with Sketch.

    Fix triggering project config changes when allowAdminChanges is set to false.

3.0.5

Released Feb 24, 2020

  • theicons.co/svg/others-47 Created with Sketch.

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

  • theicons.co/svg/home-36 Created with Sketch.

    Fix some icons (including GraphQL) not showing correctly.

  • theicons.co/svg/home-36 Created with Sketch.

    Fix missing order value when resetting nav.

3.0.4

Released Feb 15, 2020

  • theicons.co/svg/home-36 Created with Sketch.

    Fix migration errors from Craft 2 > Craft 3.

3.0.3

Released Feb 12, 2020

  • theicons.co/svg/others-47 Created with Sketch.

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

  • theicons.co/svg/home-36 Created with Sketch.

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

3.0.2

Released Feb 05, 2020

  • theicons.co/svg/home-36 Created with Sketch.

    Fix error in NavigationEvent.

3.0.1

Released Feb 02, 2020

  • theicons.co/svg/home-36 Created with Sketch.

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

3.0.0

Released Jan 14, 2020

  • theicons.co/svg/photo-09 Created with Sketch.

    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.

  • theicons.co/svg/photo-09 Created with Sketch.

    Nav URLs can now contains aliases.

  • theicons.co/svg/photo-09 Created with Sketch.

    Add navigation types, for better flexibility going forward.

  • theicons.co/svg/photo-09 Created with Sketch.

    Add new divider navigation type, handy for separating items in the menu.

  • theicons.co/svg/photo-09 Created with Sketch.

    You can now select an icon from Craft's built-in icons.

  • theicons.co/svg/photo-09 Created with Sketch.

    Add Project Config support.

  • theicons.co/svg/others-47 Created with Sketch.

    Now requires Craft 3.4.x and greater.

  • theicons.co/svg/others-47 Created with Sketch.

    Full refactor from ground-up, focusing on performance, cleanup and best-practices.

  • theicons.co/svg/others-47 Created with Sketch.

    Minimised overhead for CP requests, by removing changed navigation checks.

  • theicons.co/svg/others-47 Created with Sketch.

    Modified navigation items are only checked when enabling/installing or disabling/uninstalling plugins.

  • theicons.co/svg/others-47 Created with Sketch.

    Nav URL is now optional, and also acts like a heading.

  • theicons.co/svg/others-47 Created with Sketch.

    Nav regeneration has been changed to nav resetting. This will completely reset your layout back to stock Craft.

  • theicons.co/svg/home-36 Created with Sketch.

    Fix empty navigation handle issue. (thanks @fThues).

  • theicons.co/svg/home-36 Created with Sketch.

    Layout user group IDs now correctly use their UIDs.

  • theicons.co/svg/home-36 Created with Sketch.

    Fix error for non-local volumes when using a custom icon.

2.0.9

Released Nov 10, 2018

  • theicons.co/svg/photo-09 Created with Sketch.

    Added better visual notification when editing a nav.

  • theicons.co/svg/home-36 Created with Sketch.

    Fix custom icons not resolving with aliases.

  • theicons.co/svg/home-36 Created with Sketch.

    Fix errors when installing via console.

  • theicons.co/svg/home-36 Created with Sketch.

    Fix redirection issue for settings.

2.0.8

Released July 05, 2018

  • theicons.co/svg/photo-09 Created with Sketch.

    Add nav regenerate settings

  • theicons.co/svg/home-36 Created with Sketch.

    Fix default icons not appearing (showing as placeholders)

  • theicons.co/svg/home-36 Created with Sketch.

    Fix missing template translations

2.0.7

Released May 25, 2018

  • theicons.co/svg/home-36 Created with Sketch.

    Fix Craft native menu item icons

2.0.6

Released May 10, 2018

  • theicons.co/svg/home-36 Created with Sketch.

    Fix hardcoded plugin icons

2.0.5

Released May 08, 2018

  • theicons.co/svg/home-36 Created with Sketch.

    Fix for count() error in PHP 7.2+

  • theicons.co/svg/home-36 Created with Sketch.

    Badge support

  • theicons.co/svg/home-36 Created with Sketch.

    Fix incorrect column default values for plugin

  • theicons.co/svg/home-36 Created with Sketch.

    Fix subnav items not working correctly for some plugins

2.0.4

Released Apr 11, 2018

  • theicons.co/svg/home-36 Created with Sketch.

    Fix for Craft 3.0 (changing Client to Solo)

  • theicons.co/svg/home-36 Created with Sketch.

    Fix not including sub-navigation of plugins

  • theicons.co/svg/home-36 Created with Sketch.

    Fix not including sel class on menu items

  • theicons.co/svg/home-36 Created with Sketch.

    Fix icon path check to ignore directories

2.0.3

Released Feb 12, 2018

  • theicons.co/svg/home-36 Created with Sketch.

    Fix for siteUrl config settings throwing an error when more than one site is defined

  • theicons.co/svg/home-36 Created with Sketch.

    Update Craft CMS requirements

2.0.2

Released Dec 13, 2017

  • theicons.co/svg/home-36 Created with Sketch.

    Fixed issue when using arrays in configuration files. Thanks to @juresrpcic via #30.

  • theicons.co/svg/home-36 Created with Sketch.

    Fixed issue with volumes sources when adding a custom icon.

2.0.1

Released Dec 07, 2017

  • theicons.co/svg/others-47 Created with Sketch.

    Updated for Craft 3 RC1.

2.0.0

Released Oct 18, 2017

  • theicons.co/svg/photo-09 Created with Sketch.

    Craft 3 initial release.

1.7.8

Released Oct 17, 2017

  • theicons.co/svg/photo-09 Created with Sketch.

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

  • theicons.co/svg/others-47 Created with Sketch.

    Don’t store handle as an AttributeType::Handle.

  • theicons.co/svg/others-47 Created with Sketch.

    Better error-handling when adding/saving nav item.

1.7.7

Released Apr 21, 2017

  • theicons.co/svg/photo-09 Created with Sketch.

    Support for Craft 2.6.2951.

  • theicons.co/svg/others-47 Created with Sketch.

    Now restores original nav if errors are thrown during the nav generation process (PHP7+ only).

  • theicons.co/svg/others-47 Created with Sketch.

    Enforce only image selection for custom icon.

  • theicons.co/svg/others-47 Created with Sketch.

    Allow custom icons to override default Craft/Plugin icons.

  • theicons.co/svg/home-36 Created with Sketch.

    Fixed selected custom icon not populating asset element select field.

  • theicons.co/svg/home-36 Created with Sketch.

    Check if a custom icon asset exists before trying to apply it to the nav.

1.7.6

Released Nov 01, 2016

  • theicons.co/svg/home-36 Created with Sketch.

    Fixed issues when saving nav items in some cases.

  • theicons.co/svg/home-36 Created with Sketch.

    Fixed issue where Permissions option for layouts was required when saving/editing.

  • theicons.co/svg/home-36 Created with Sketch.

    Fixed minor UI issues with HUD when editing nav and layout items.

1.7.5

Released June 25, 2016

  • theicons.co/svg/photo-09 Created with Sketch.

    Added support for translations with menu labels.

  • theicons.co/svg/photo-09 Created with Sketch.

    Added ability to upload and set custom icons for menu items.

1.7.4

Released Feb 28, 2016

  • theicons.co/svg/home-36 Created with Sketch.

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

1.7.3

Released Feb 20, 2016

  • theicons.co/svg/photo-09 Created with Sketch.

    Added {siteUrl} twig tag when creating nav items.

1.7.2

Released Feb 02, 2016

  • theicons.co/svg/home-36 Created with Sketch.

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

1.7.1

Released Jan 13, 2016

  • theicons.co/svg/home-36 Created with Sketch.

    Fixed issue with plugin release feed url.

1.7.0

Released Dec 23, 2015

  • theicons.co/svg/photo-09 Created with Sketch.

    Craft 2.5 support, including release feed and icons.

  • theicons.co/svg/photo-09 Created with Sketch.

    Added Layouts - set different navigations and assign to user groups. Great for creating client-specific navigation, without changing navigation for other users.

  • theicons.co/svg/others-47 Created with Sketch.

    Completely re-written from the ground up for better performance and tidiness.

  • theicons.co/svg/others-47 Created with Sketch.

    Removed Quick-Add menu for the moment.