WordPress.org
Get WordPress
WordPress.org

WordPress Developer Resources

wp_get_nav_menu_items

apply_filters( ‘wp_get_nav_menu_items’, array $items, object $menu, array $args )

In this article

Back to top

Filters the navigation menu items being returned.

Parameters

$itemsarray
An array of menu item post objects.
$menuobject
The menu object.
$argsarray
An array of arguments used to retrieve menu item objects.

Source

return apply_filters( 'wp_get_nav_menu_items', $items, $menu, $args );

View all references View on Trac View on GitHub

Used byDescription
wp_get_nav_menu_items()wp-includes/nav-menu.php

Retrieves all menu items of a navigation menu.

Changelog

VersionDescription
3.0.0Introduced.

User Contributed Notes

  1. Skip to note 2 content
    Dragi Postolovski
    You must log in to vote on the helpfulness of this noteVote results for this note: 0You must log in to vote on the helpfulness of this note
    function wpdocs_exclude_menu_items( $items ) {
    foreach ( $items as $key => $item ) {
        // If the menu item does not have the 'custom-item-class' class
        if ( ! in_array( 'custom-item-class', $item->classes ) ) {
            continue;
        }

        unset( $items[ $key ] );
    }

    return $items;
}

add_filter( 'wp_get_nav_menu_items', 'wpdocs_exclude_menu_items' );

You must log in before being able to contribute a note or feedback.