Filter hook 'pre_wp_setup_nav_menu_item'

in WP Core File wp-includes/nav-menu.php at line 858

View Source

pre_wp_setup_nav_menu_item

Filter Hook
Description
Filters whether to short-circuit the wp_setup_nav_menu_item() output. Returning a non-null value from the filter will short-circuit wp_setup_nav_menu_item(), returning that value instead.

Hook Information

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

Hook Parameters

Type Name Description
object|null $modified_menu_item Modified menu item. Default null.
object $menu_item The menu item to modify.

Usage Examples

Basic Usage
<?php
// Hook into pre_wp_setup_nav_menu_item
add_filter('pre_wp_setup_nav_menu_item', 'my_custom_filter', 10, 2);

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

Source Code Context

wp-includes/nav-menu.php:858 - How this hook is used in WordPress core
<?php
 853  	 * @since 6.3.0
 854  	 *
 855  	 * @param object|null $modified_menu_item Modified menu item. Default null.
 856  	 * @param object      $menu_item          The menu item to modify.
 857  	 */
 858  	$pre_menu_item = apply_filters( 'pre_wp_setup_nav_menu_item', null, $menu_item );
 859  
 860  	if ( null !== $pre_menu_item ) {
 861  		return $pre_menu_item;
 862  	}
 863  

PHP Documentation

<?php
/**
	 * Filters whether to short-circuit the wp_setup_nav_menu_item() output.
	 *
	 * Returning a non-null value from the filter will short-circuit wp_setup_nav_menu_item(),
	 * returning that value instead.
	 *
	 * @since 6.3.0
	 *
	 * @param object|null $modified_menu_item Modified menu item. Default null.
	 * @param object      $menu_item          The menu item to modify.
	 */
Quick Info
  • Hook Type: Filter
  • Parameters: 2
  • File: wp-includes/nav-menu.php
Related Hooks

Related hooks will be displayed here in future updates.