Changeset 55867 for trunk/src/wp-includes/nav-menu.php

Timestamp:

05/30/2023 11:19:41 AM (3 years ago)

Author:

azaozz

Message:

Menus: Add a short-circuit filter to wp_setup_nav_menu_item().

Props: davidbinda, ironprogrammer, andizer.
Fixes: #56577.

File:

• trunk/src/wp-includes/nav-menu.php (modified) (1 diff)

trunk/src/wp-includes/nav-menu.php

@@ -821 +821 @@
  */
 function wp_setup_nav_menu_item( $menu_item ) {
+
+        /**
+         * 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(),
+         * and return that value.
+         *
+         * @param object|null $modified_menu_item Modified menu item. Default null.
+         * @param object      $menu_item          The menu item to modify.
+         */
+        $pre_menu_item = apply_filters( 'pre_wp_setup_nav_menu_item', null, $menu_item );
+
+        if ( null !== $pre_menu_item ) {
+                return $pre_menu_item;
+        }
+
         if ( isset( $menu_item->post_type ) ) {
                 if ( 'nav_menu_item' === $menu_item->post_type ) {