wp_nav_menu_{$menu->slug}_items

Filter Hook

Description

Filters the HTML list content for a specific navigation menu.

Hook Information

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

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_{$menu->slug}_items
add_filter('wp_nav_menu_{$menu->slug}_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:283 - How this hook is used in WordPress core

<?php
 278  	 * @see wp_nav_menu()
 279  	 *
 280  	 * @param string   $items The HTML list content for the menu items.
 281  	 * @param stdClass $args  An object containing wp_nav_menu() arguments.
 282  	 */
 283  	$items = apply_filters( "wp_nav_menu_{$menu->slug}_items", $items, $args );
 284  
 285  	// Don't print any markup if there are no items at this point.
 286  	if ( empty( $items ) ) {
 287  		return false;
 288  	}

PHP Documentation

<?php
/**
	 * Filters the HTML list content for a specific navigation menu.
	 *
	 * @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.