Changeset 34692

Timestamp:

09/29/2015 03:39:26 PM (9 years ago)

Author:

DrewAPicture

Message:

Users: Introduce the wp_dropdown_users_args filter, making it possible to filter the arguments for wp_dropdown_users() before the query is run.

The 'name' argument (or the WP_Screen object if in the admin) can be used to help target specific instances of wp_dropdown_users() via this hook.

Props norcross.
See #19867.

File:

• trunk/src/wp-includes/user-functions.php (modified) (1 diff)

trunk/src/wp-includes/user-functions.php

@@ -923 +923 @@
     $query_args = wp_array_slice_assoc( $r, array( 'blog_id', 'include', 'exclude', 'orderby', 'order', 'who' ) );
     $query_args['fields'] = array( 'ID', 'user_login', $show );
+
+    /**
+     * Filter the arguments for user drop-down arguments before being passed into the query.
+     *
+     * @since 4.4.0
+     *
+     * @param array $query_args The default arguments for wp_dropdown_users().
+     */
+    $query_args = apply_filters( 'wp_dropdown_users_args', $query_args );
+
     $users = get_users( $query_args );