get_the_taxonomies( int|WP_Post $post = 0, array $args = array() ): string[]

Description

Parameters

$postint|WP_Postoptional

Post ID or WP_Post object. Default is global $post.Default: 0

$argsarrayoptional

Arguments about how to format the list of taxonomies. Default empty array.Default: array()

• $templatestringdefault: is the term name linked to its archive

  Template for displaying a taxonomy label and list of terms. Default is "Label: Terms." @type string $term_template Template for displaying a single term in the list.

Return

string[]

List of taxonomies.

Uses · 10

• get_post()Retrieves post data given a post ID or post object.
• wp_parse_args()Merges user defined arguments into defaults array.
• __()Retrieves the translation of $text.
• get_object_taxonomies()Returns 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.
• get_taxonomy()Retrieves the taxonomy object of $taxonomy.
• get_object_term_cache()Retrieves the cached term objects for the given object ID.
• wp_get_object_terms()Retrieves the terms associated with the given object(s), in the supplied taxonomies.
• wp_sprintf()WordPress' implementation of PHP sprintf() with filters.
• esc_attr()Escaping for HTML attributes.
• get_term_link()Generates a permalink for a taxonomy term archive.

Used by · 1

• the_taxonomies()Displays the taxonomies of a post with available options.

Source

View on Trac ↗View on GitHub ↗

4798function get_the_taxonomies( $post = 0, $args = array() ) {4799	$post = get_post( $post );4800 4801	$args = wp_parse_args(4802		$args,4803		array(4804			/* translators: %s: Taxonomy label, %l: List of terms formatted as per $term_template. */4805			'template'      => __( '%s: %l.' ),4806			'term_template' => '<a href="%1$s">%2$s</a>',4807		)4808	);4809 4810	$taxonomies = array();4811 4812	if ( ! $post ) {4813		return $taxonomies;4814	}4815 4816	foreach ( get_object_taxonomies( $post ) as $taxonomy ) {4817		$t = (array) get_taxonomy( $taxonomy );4818		if ( empty( $t['label'] ) ) {4819			$t['label'] = $taxonomy;4820		}4821		if ( empty( $t['args'] ) ) {4822			$t['args'] = array();4823		}4824		if ( empty( $t['template'] ) ) {4825			$t['template'] = $args['template'];4826		}4827		if ( empty( $t['term_template'] ) ) {4828			$t['term_template'] = $args['term_template'];4829		}4830 4831		$terms = get_object_term_cache( $post->ID, $taxonomy );4832		if ( false === $terms ) {4833			$terms = wp_get_object_terms( $post->ID, $taxonomy, $t['args'] );4834		}4835		$links = array();4836 4837		foreach ( $terms as $term ) {4838			$links[] = wp_sprintf( $t['term_template'], esc_attr( get_term_link( $term ) ), $term->name );4839		}4840		if ( $links ) {4841			$taxonomies[ $taxonomy ] = wp_sprintf( $t['template'], $t['label'], $links, $terms );4842		}4843	}4844	return $taxonomies;4845}

History

Introduced in 2.5.0. Unchanged from 6.7.7 through 7.1.0.

1. 6.7.7
2. 6.8.8
3. 6.9.7
4. 7.0.4
5. 7.1.0

Signature, return type and hooks compared across 5 parsed releases.

About this page

Parsed data

Generated from the wordpress-develop 6.8.8 tag, from src/wp-includes/taxonomy.php, and regenerated for each WordPress release so it tracks the code rather than a snapshot of it.

Corrections

Something wrong on this page? Report it and it gets fixed in the next regeneration.