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 ↗

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

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.7.7 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.