wp_nav_menu_items
Filters the HTML list content for navigation menus.
Description
Parameters (2)
- 0. $items (string)
- The HTML list content for the menu items.
- 1. $args (stdClass)
- An object containing
wp_nav_menu(…)
arguments.
Usage
- To run the hook, copy the example below.
- $items = apply_filters( 'wp_nav_menu_items', $items, $args );
- if ( !empty( $items ) ) {
- // everything has led up to this point...
- }
- The following example is for adding a hook callback.
- // define the wp_nav_menu_items callback
- function filter_wp_nav_menu_items( $items, $args ) {
- // make filter magic happen here...
- return $items;
- };
- // add the filter
- add_filter( 'wp_nav_menu_items', 'filter_wp_nav_menu_items', 10, 2 );
- To remove a hook callback, use the example below.
- // remove the filter
- remove_filter( 'wp_nav_menu_items', 'filter_wp_nav_menu_items', 10, 2 );
Defined (1)
The filter is defined in the following location(s).
- /wp-includes/nav-menu-template.php
- $items = apply_filters( 'wp_nav_menu_items', $items, $args );