wp_get_nav_menu_items

Filter Hook

Description

Filters the navigation menu items being returned.

Hook Information

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

Hook Parameters

Type	Name	Description
`array`	`$items`	An array of menu item post objects.
`object`	`$menu`	The menu object.
`array`	`$args`	An array of arguments used to retrieve menu item objects.

Usage Examples

Basic Usage

<?php
// Hook into wp_get_nav_menu_items
add_filter('wp_get_nav_menu_items', 'my_custom_filter', 10, 3);

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

Source Code Context

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

<?php
 775  	 *
 776  	 * @param array  $items An array of menu item post objects.
 777  	 * @param object $menu  The menu object.
 778  	 * @param array  $args  An array of arguments used to retrieve menu item objects.
 779  	 */
 780  	return apply_filters( 'wp_get_nav_menu_items', $items, $menu, $args );
 781  }
 782  
 783  /**
 784   * Updates post and term caches for all linked objects for a list of menu items.
 785   *

PHP Documentation

<?php
/**
	 * Filters the navigation menu items being returned.
	 *
	 * @since 3.0.0
	 *
	 * @param array  $items An array of menu item post objects.
	 * @param object $menu  The menu object.
	 * @param array  $args  An array of arguments used to retrieve menu item objects.
	 */

Quick Info

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

Links

WordPress Docs View Source Code Search Examples

Related Hooks

Related hooks will be displayed here in future updates.