Changeset 9210 for trunk/src/bp-core/bp-core-classes.php

Timestamp:

12/04/2014 01:47:49 AM (11 years ago)

Author:

boonebgorges

Message:

Introduce Member Types API.

BuddyPress member types are akin to WordPress's custom post types. Developers
can use bp_register_member_type() to register their types with BuddyPress,
and BP will automatically provide a number of pieces of functionality:

• Mechanisms for storing and fetching member types (as a WP taxonomy term), with full cache support.
• A 'member_type' argument for the bp_has_members()/BP_User_Query stack, which allows filtering member loops by member type.
• Admin UI for changing member types on Dashboard > Users > Community Profile (appears when member types have been registered).

We'll continue to build out more core member type functionality in future
versions of BuddyPress. In the meantime, this is a good starting point for BP
site implementations to have a shared infrastructure for storing and retrieving
this data.

See #6006.

File:

• trunk/src/bp-core/bp-core-classes.php (modified) (3 diffs)

trunk/src/bp-core/bp-core-classes.php

@@ -38 +38 @@
  *                                              override all others; BP User objects will be constructed using these
  *                                              IDs only. Default: false.
+ *     @type array|string      $member_type     Array or comma-separated list of member types to limit results to.
  *     @type string|bool       $meta_key        Limit results to users that have usermeta associated with this meta_key.
  *                                              Usually used with $meta_value. Default: false.
@@ -165 +166 @@
                 'exclude'         => false,
                 'user_ids'        => false,
+                'member_type'     => '',
                 'meta_key'        => false,
                 'meta_value'      => false,
@@ -400 +402 @@
                 $search_terms_space
             );
+        }
+
+        // Member type.
+        if ( ! empty( $member_type ) ) {
+            $member_types = array();
+
+            if ( ! is_array( $member_type ) ) {
+                $member_type = preg_split( '/[,\s+]/', $member_type );
+            }
+
+            foreach ( $member_type as $mt ) {
+                if ( ! bp_get_member_type_object( $mt ) ) {
+                    continue;
+                }
+
+                $member_types[] = $mt;
+            }
+
+            if ( ! empty( $member_types ) ) {
+                $member_type_tq = new WP_Tax_Query( array(
+                    array(
+                        'taxonomy' => 'bp_member_type',
+                        'field'    => 'name',
+                        'operator' => 'IN',
+                        'terms'    => $member_types,
+                    ),
+                ) );
+
+                // Switch to the root blog, where member type taxonomies live.
+                switch_to_blog( bp_get_root_blog_id() );
+
+                $member_type_sql_clauses = $member_type_tq->get_sql( 'u', $this->uid_name );
+                restore_current_blog();
+
+
+                // Grab the first term_relationships clause and convert to a subquery.
+                if ( preg_match( '/' . $wpdb->term_relationships . '\.term_taxonomy_id.*/', $member_type_sql_clauses['where'], $matches ) ) {
+                    $sql['where']['member_type'] = "u.{$this->uid_name} IN ( SELECT object_id FROM $wpdb->term_relationships WHERE {$matches[0]} )";
+                }
+            }
         }