Codepress Menu

A better take on displaying a WordPress menu in your theme.

Author:	Codepress (profile at wordpress.org)
WordPress version required:	3.1
WordPress version tested:	3.6
Plugin version:	2.3.2
Added to WordPress repository:	17-08-2012
Last updated:	02-08-2013 Warning! This plugin has not been updated in over 2 years. It may no longer be maintained or supported and may have compatibility issues when used with more recent versions of WordPress.
Rating, %:	100
Rated by:	2
Plugin URI:	http://wordpress.org/extend/plugins/codepress...
Total downloads:	7 387
Active installs:	100+
Click to start download

Uses the native wp_nav_menu(). Add parameters to the wp_nav_menu() to enable functionality. Also, ships with one-click delete menu-items in the WordPress admin. Turned off or on using the screen-options. Sweet.

Examples

This will get the first sub-menu from the active branch and 2 levels beyond (menu + sub-menu + sub-menu):

wp_nav_menu( array(
    'level' => 2,
    'depth' => 3
));

Show the current branch only:

wp_nav_menu( array(
    'level' => 1
));

Aimed on simple use in various use cases:

// display first level in the header
wp_nav_menu( array(
    'depth' => 1
));

// display first sub-menu from the current branch somewhere else
wp_nav_menu( array(
    'depth' => 2,
    'level' => 2
));

Another feature is it's control over the css classes that are given to a menu-item. You might be faced with css selectors which you cannot change. The 'codepress_menu_filter_classes' filter can be used in your functions.php to set the class property:

/**
 * Change the classes of a menu item
 *
 * @param array $classes List current classes
 * @param object $item Current menu item
 * @param array $items Current list of items (per level)
 * @param integer $k Key of the current item in $items
 */
function codepress_menu_item_classes( $classes, $item, $items, $k ) {
    // mark the first item
    if ( reset( $items ) == $items[ $k ] )
        $classes[] = 'first';

    // mark the last item
    if ( end( $items ) == $items[ $k ] )
        $classes[] = 'last';

    // map the WordPress default 'current-menu-item' class to 'active'
    if ( in_array( 'current-menu-item', $classes ) )
        $classes[] = 'active';

    return $classes;
}
add_filter( 'codepress_menu_item_classes', 'codepress_menu_item_classes', 10, 4 );

Simple Menu Delete

It ships with one-click delete menu-items within WordPress. This functionality was integrated from our Simple Menu Delete plugin and enhanced a bit:

Turned off or on using the screen-options.
Display is more in line with WordPress's way of delete-links.
Works exactly the same now as the nested delete-link which is a click further inside the menu item.

FAQ
ChangeLog

2.3.2

Fixed a strict standards warning when calling walk()

2.3.1

Fixed a bug where adding menu items would not show the remove link

2.3

A more WordPress-like implementation of the menu-item class control.
Added a one-click delete for menu-items in wp-admin (can be turned off or on via screen options).
Minor code cleanup, adhering WordPress standards… even more!

2.2.2

get_nav_menu_locations() in WordPress < 3.6 can return false, will now check if it is an array and not break the foreach loop.
Minor code cleanup, adhering WordPress standards.

2.2.1

Now checks if a given theme_location exists and is set or will just return the $args and let WordPress handle the parsing.
Unsets an item once it has a match in the indent function, better performance.
Removed the extraction from the indent function, slightly better performance.
Minor code cleanup, adhering WordPress standards.

2.2

Bugfix: level set higher then 2 sometimes gave incorrect results.
Recoded it to match the WordPress coding standards (hope we managed to do this).
The items no longer have a separate class. It was not needed after all and this is more of a WordPress approach.
Added a filter (codepress_ignore_theme_locations) to tell the plugin not to apply on certain theme locations.
Removed some hooks that could only cause unwanted behavior and mostly targeted the separate item class (codepress_menu_return_false_on_empty_list_after_filters, codepress_menu_filter_classes, codepress_menu_items, codepress_menu_set_walker, codepress_menu_item_sanitize_classes).
Allowed the item-id. We see no harm in it after all. (codepress_menu_item_sanitize_id)

2.1.2

Now checks if the filters have not reduced the amount of items to zero. If so, act as wp_nav_menu and return false.
When a theme location is used in conjunction with the plugin, it now returns an empty string.

2.1.1

‘sanitize’ option is replaced by ‘classes’ and now defaults to doing nothing. Choosing ‘simple’ as option will result in what the default sanitize did in the 2.0 version.

2.1

Now hooks into the native wp_nav_menu() and abandons the use of a custom function.
Extends the Walker_Nav_Menu class and most of it’s filters and functions are used to keep as close to the WordPress core as possible.
You can no longer fetch an array of items and apply filters on it as you see fit. This functionality may return, but the focus of this version was on integration with wp_nav_menu().

2.0

Initial public release.

Hide ChangeLog

Choose right WordPress plugin from thousands others in a moment

Something is broken? Have an idea?