wp_nav_menu_items

Filter Hook

Description

Filters the HTML list content for navigation menus.

Hook Information

File Location	`wp-includes/nav-menu-template.php` View on GitHub
Hook Type	Filter
Line Number	`272`

Hook Parameters

Type	Name	Description
`string`	`$items`	The HTML list content for the menu items.
`stdClass`	`$args`	An object containing wp_nav_menu() arguments.

Usage Examples

Basic Usage

<?php
// Hook into wp_nav_menu_items
add_filter('wp_nav_menu_items', 'my_custom_filter', 10, 2);

function my_custom_filter($items, $args) {
    // Your custom filtering logic here
    return $items;
}

Source Code Context

wp-includes/nav-menu-template.php:272 - How this hook is used in WordPress core

<?php
 267  	 * @see wp_nav_menu()
 268  	 *
 269  	 * @param string   $items The HTML list content for the menu items.
 270  	 * @param stdClass $args  An object containing wp_nav_menu() arguments.
 271  	 */
 272  	$items = apply_filters( 'wp_nav_menu_items', $items, $args );
 273  	/**
 274  	 * Filters the HTML list content for a specific navigation menu.
 275  	 *
 276  	 * @since 3.0.0
 277  	 *

PHP Documentation

<?php
/**
	 * Filters the HTML list content for navigation menus.
	 *
	 * @since 3.0.0
	 *
	 * @see wp_nav_menu()
	 *
	 * @param string   $items The HTML list content for the menu items.
	 * @param stdClass $args  An object containing wp_nav_menu() arguments.
	 */

Quick Info

Hook Type: Filter
Parameters: 2
File: wp-includes/nav-menu-template.php

Links

WordPress Docs View Source Code Search Examples

Related Hooks

Related hooks will be displayed here in future updates.