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 

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.