Ticket #7263: 7263.diff

src/bp-core/bp-core-taxonomy.php

@@ -193 +193 @@
 
         return $retval;
 }
+
+/**
+ * Retrieve IDs of objects in valid taxonomies and terms for BuddyPress-related taxonomies.
+ *
+ * Note that object IDs are from the `bp_get_taxonomy_term_site_id()`, which on some
+ * multisite configurations may not be the same as the current site.
+ *
+ * @since 2.7.0
+ *
+ * @see get_objects_in_term() for a full description of function and parameters.
+ *
+ * @param int|array    $term_ids   Term id or array of term ids of terms that will be used.
+ * @param string|array $taxonomies String of taxonomy name or Array of string values of taxonomy names.
+ * @param array|string $args       Change the order of the object_ids, either ASC or DESC.
+ *
+ * @return WP_Error|array If the taxonomy does not exist, then WP_Error will be returned. On success,
+ *                        the array can be empty, meaning that there are no $object_ids found. When
+ *                        object IDs are found, an array of those IDs will be returned.
+ */
+function bp_get_objects_in_term( $term_ids, $taxonomies, $args = array() ) {
+        // Different taxonomies may be stored on different sites.
+        $taxonomy_site_map = array();
+        foreach ( (array) $taxonomies as $taxonomy ) {
+                $taxonomy_site_id = bp_get_taxonomy_term_site_id( $taxonomy );
+                $taxonomy_site_map[ $taxonomy_site_id ][] = $taxonomy;
+        }
+
+        $retval = array();
+        foreach ( $taxonomy_site_map as $taxonomy_site_id => $site_taxonomies ) {
+                $switched = false;
+                if ( $taxonomy_site_id !== get_current_blog_id() ) {
+                        switch_to_blog( $taxonomy_site_id );
+                        bp_register_taxonomies();
+                        $switched = true;
+                }
+
+                $site_objects = get_objects_in_term( $term_ids, $taxonomies, $args );
+                $retval       = array_merge( $retval, $site_objects );
+
+                if ( $switched ) {
+                        restore_current_blog();
+                }
+        }
+
+        return $retval;
+}
+
+/**
+ * Get term data for terms in BuddyPress taxonomies.
+ *
+ * Note that term data is from the `bp_get_taxonomy_term_site_id()`, which on some
+ * multisite configurations may not be the same as the current site.
+ *
+ * @since 2.7.0
+ *
+ * @see get_term_by() for a full description of function and parameters.
+ *
+ * @param string     $field    Either 'slug', 'name', 'id' (term_id), or 'term_taxonomy_id'
+ * @param string|int $value    Search for this term value
+ * @param string     $taxonomy Taxonomy name. Optional, if `$field` is 'term_taxonomy_id'.
+ * @param string     $output   Constant OBJECT, ARRAY_A, or ARRAY_N
+ * @param string     $filter   Optional, default is raw or no WordPress defined filter will applied.
+ *
+ * @return WP_Term|bool WP_Term instance on success. Will return false if `$taxonomy` does not exist
+ *                      or `$term` was not found.
+ */
+function bp_get_term_by( $field, $value, $taxonomy = '', $output = OBJECT, $filter = 'raw' ) {
+        $site_id = bp_get_taxonomy_term_site_id( $taxonomy );
+
+        $switched = false;
+        if ( $site_id !== get_current_blog_id() ) {
+                switch_to_blog( $site_id );
+                bp_register_taxonomies();
+                $switched = true;
+        }
+
+        $term = get_term_by( $field, $value, $taxonomy, $output, $filter );
+
+        if ( $switched ) {
+                restore_current_blog();
+        }
+
+        return $term;
+}