Changeset 12765 for trunk/src/bp-members/bp-members-functions.php

Timestamp:

10/24/2020 12:20:39 PM (4 years ago)

Author:

imath

Message:

Administration: add support for multiple member types assignment

Community Administrators can now use the multiple select box of the User's Extended Profile Member Type metabox to assign one or more Member Types to the user.

Data for the Member Type column of the WP Users List Table are now displaying a comma separated list of Member Types for Users being assigned to more than one Member Type (which was the original ticket's need).

The bulk removing or assigning member types functionalities have been improved to behave as follows :

• Bulk removing member types is removing all assigned member types.
• Bulk assigning a member type is replacing all assigned member types with the selected member type.

Props etatus, vapvarun

Fixes #8292

File:

• trunk/src/bp-members/bp-members-functions.php (modified) (3 diffs)

trunk/src/bp-members/bp-members-functions.php

@@ -2994 +2994 @@
  *
  * @since 2.2.0
- *
- * @param int    $user_id     ID of the user.
- * @param string $member_type Member type.
- * @param bool   $append      Optional. True to append this to existing types for user,
- *                            false to replace. Default: false.
+ * @since 7.0.0 $member_type parameter also accepts an array of member type names.
+ *
+ * @param int          $user_id     ID of the user.
+ * @param string|array $member_type The member type name or an array of member type names.
+ * @param bool         $append      Optional. True to append this to existing types for user,
+ *                                  false to replace. Default: false.
  * @return false|array $retval See {@see bp_set_object_terms()}.
  */
 function bp_set_member_type( $user_id, $member_type, $append = false ) {
     // Pass an empty $member_type to remove a user's type.
-    if ( ! empty( $member_type ) && ! bp_get_member_type_object( $member_type ) ) {
-        return false;
+    if ( ! empty( $member_type ) ) {
+        $member_types = (array) $member_type;
+        $valid_types  = array_filter( array_map( 'bp_get_member_type_object', $member_types ) );
+
+        if ( $valid_types ) {
+            $member_type = wp_list_pluck( $valid_types, 'name' );
+        } else {
+            return false;
+        }
     }
 
@@ -3018 +3026 @@
          * @since 2.2.0
          *
-         * @param int    $user_id     ID of the user whose member type has been updated.
-         * @param string $member_type Member type.
-         * @param bool   $append      Whether the type is being appended to existing types.
+         * @param int          $user_id     ID of the user whose member type has been updated.
+         * @param string|array $member_type The member type name or an array of member type names.
+         * @param bool         $append      Whether the type is being appended to existing types.
          */
         do_action( 'bp_set_member_type', $user_id, $member_type, $append );
@@ -3123 +3131 @@
      * @since 2.2.0
      *
-     * @param string $type    Member type.
-     * @param int    $user_id ID of the user.
-     * @param bool   $single  Whether to return a single type string, or an array.
+     * @param string|array|bool $type    a single member type (if $single is true) or an array of member types
+     *                                   (if $single is false) or false on failure.
+     * @param int               $user_id ID of the user.
+     * @param bool              $single  Whether to return a single type string, or an array.
      */
     return apply_filters( 'bp_get_member_type', $type, $user_id, $single );