get_object_taxonomies

Advertisement

Summery Summery

Return the names or objects of the taxonomies which are registered for the requested object or object type, such as a post object or post type name.

Syntax Syntax

get_object_taxonomies( string|string[]|WP_Post $object, string $output = 'names' )

Description Description

Example:

$taxonomies = get_object_taxonomies( 'post' );

This results in:

Array( 'category', 'post_tag' )

Parameters Parameters

$object

(Required) Name of the type of taxonomy object, or an object (row from posts)

$output

(Optional) The type of output to return in the array. Accepts either 'names' or 'objects'. Default 'names'.

Default value: 'names'

Return Return

(string[]|WP_Taxonomy[]) The names or objects of all taxonomies of $object_type.

Source Source

File: wp-includes/taxonomy.php

function get_object_taxonomies( $object, $output = 'names' ) {
	global $wp_taxonomies;

	if ( is_object( $object ) ) {
		if ( 'attachment' === $object->post_type ) {
			return get_attachment_taxonomies( $object, $output );
		}
		$object = $object->post_type;
	}

	$object = (array) $object;

	$taxonomies = array();
	foreach ( (array) $wp_taxonomies as $tax_name => $tax_obj ) {
		if ( array_intersect( $object, (array) $tax_obj->object_type ) ) {
			if ( 'names' === $output ) {
				$taxonomies[] = $tax_name;
			} else {
				$taxonomies[ $tax_name ] = $tax_obj;
			}
		}
	}

	return $taxonomies;
}

Advertisement

Changelog Changelog

Changelog
Version Description
2.3.0 Introduced.

Advertisement

Leave a Reply