pre_wp_setup_nav_menu_item
Filter HookDescription
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.