Ticket #5657: bp-xprofile-functions-5657.diff

src/bp-xprofile/bp-xprofile-functions.php

@@ -1004 +1004 @@
 
         return $field_ids;
 }
+
+/**
+ * Populates the BP_XProfile_Group object with profile field groups, fields, and field data
+ *
+ * Procedural wrapper for BP_XProfile_Group::get() method.
+ *
+ * @since BuddyPress (2.1)
+ *
+ * @param array $args Takes an array of parameters:
+ *              'profile_group_id' - Limit results to a single profile group
+ *              'user_id' - Required if you want to load a specific user's data
+ *              'hide_empty_groups' - Hide groups without any fields
+ *              'hide_empty_fields' - Hide fields where the user has not provided data
+ *              'fetch_fields' - Load each group's fields
+ *              'fetch_field_data' - Load each field's data. Requires a user_id
+ *              'exclude_groups' - Comma-separated list of groups to exclude
+ *              'exclude_fields' - Comma-separated list of fields to exclude
+ *              'update_meta_cache' - Whether to pre-fetch xprofilemeta
+ *                 for all retrieved groups, fields, and data
+ *
+ * @return array $groups
+ */
+function bp_xprofile_get_groups( $args = array() ) {
+
+        $groups = BP_XProfile_Group::get( $args );
+
+        return apply_filters( 'bp_xprofile_get_groups', $groups, $args );
+}