Contents

Code Reference Functions bp_get_object_terms()

bp_get_object_terms( int|array $object_ids, string|array $taxonomies, array $args = array() )

Get taxonomy terms for a BuddyPress object.

Description

See also

Parameters

$object_ids

(Required) ID or IDs of objects.

$taxonomies

(Required) Name or names of taxonomies to match.

$args

(Optional) See wp_get_object_terms().

Default value: array()

Return

(array)

Source

File: bp-core/bp-core-taxonomy.php

133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
function bp_get_object_terms( $object_ids, $taxonomies, $args = array() ) {
    // Different taxonomies must 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_terms = wp_get_object_terms( $object_ids, $site_taxonomies, $args );
        $retval     = array_merge( $retval, $site_terms );
 
        if ( $switched ) {
            restore_current_blog();
        }
    }
 
    return $retval;
}

Expand full source code Collapse full source code

Changelog

Changelog
Version Description
BuddyPress 2.2.0 Introduced.

Uses

Uses
Uses Description
bp-core/bp-core-taxonomy.php: bp_get_taxonomy_term_site_id()

Gets the ID of the site that BP should use for taxonomy term storage.
bp-core/bp-core-dependency.php: bp_register_taxonomies()

Fire the ‘bp_register_taxonomies’ action, where plugins should register taxonomies.
bp-core/bp-core-wpabstraction.php: switch_to_blog()

Switch to specified blog.
bp-core/bp-core-wpabstraction.php: restore_current_blog()

Restore current blog.

Questions?

We're always happy to help with code or other questions you might have! Search our developer docs, contact support, or connect with our sales team.