Changeset 31325 for trunk/src/wp-includes/default-widgets.php

Timestamp:

02/03/2015 02:55:21 AM (10 years ago)

Author:

SergeyBiryukov

Message:

Add 'widget_nav_menu_args' filter for Custom Menu widget arguments.

props cyman, DrewAPicture.
fixes #29463.

File:

• trunk/src/wp-includes/default-widgets.php (modified) (1 diff)

trunk/src/wp-includes/default-widgets.php

@@ -1345 +1345 @@
             echo $args['before_title'] . $instance['title'] . $args['after_title'];
 
-        wp_nav_menu( array( 'fallback_cb' => '', 'menu' => $nav_menu ) );
+        $nav_menu_args = array(
+            'fallback_cb' => '',
+            'menu'        => $nav_menu
+        );
+
+        /**
+         * Filter the arguments for the Custom Menu widget.
+         *
+         * @since 4.2.0
+         *
+         * @param array    $nav_menu_args {
+         *     An array of arguments passed to wp_nav_menu() to retrieve a custom menu.
+         *
+         *     @type callback|bool $fallback_cb Callback to fire if the menu doesn't exist. Default empty.
+         *     @type mixed         $menu        Menu ID, slug, or name.
+         * }
+         * @param stdClass $nav_menu      Nav menu object for the current menu.
+         * @param array    $args          Display arguments for the current widget.
+         */
+        wp_nav_menu( apply_filters( 'widget_nav_menu_args', $nav_menu_args, $nav_menu, $args ) );
 
         echo $args['after_widget'];