This version is chalked full of developer improvements.
There have been some follow-up bug fixes already so be sure to update to version 3.11.3.
Developer improvements
The major focus of this release was to make things a bit easier and more consistent when extending this plugin’s functionality or styling the menus. These improvements not only make it easier for you to implement custom functionality, but also make it easier for us to help you customize the plugin via the support area.
Markup improvements
Targeting a specific “post” item in a category menu is now possible using a new cat-item-<id> added to each post item. For example, the markup will look similar to this if the post has an id of 6.
Theming for all widgets and/or a specific widget is now even more straightforward due to a unified widget content wrap. Now all 3 widget types have the same markup and class structure.
New hook
Sometimes you want to work directly with navigation menu items right after they have been split into their corresponding hierarchy. Once the structure has been generated for you, it’s much easier to move levels around or remove them.
A new action has been added which receives the current hierarchy, current page, object class, and all menu items.
advanced-sidebar-menu/menus/navigation/objects/parse-hierarchy
For example, if you wanted to limit the menu to only display the bottom two levels, you could do something like this:
New code structure
A while back we officially stopped supporting PHP version 5.2. This opened up all sorts of possibilities for code base improvements. This version created the structure for moving classes to namespaces and deprecating their originals.
As usual, anything that is deprecated will use WordPress core’s system of deprecation and display a warning as well as the appropriate replacement when using something that is deprecated. Sites using deprecated code will not break until the code is officially removed, which usually happens a year or two after being deprecated.
If you are creating filters or extensions for this plugin I highly recommend turning on
WP_DEBUGwhile you are working so you will be notified of anything deprecated.If you are simply using the plugin as is and not writing code to extend it, you can ignore this as the plugin will automatically manage itself as the code changes.
So far only 1 class has been moved to the new namespace.
Miscellaneous
- 7 bug fixes were completed in this version.
- 2 text and language improves were added.
- 2 sections of deprecated code were removed.