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 ↗

4866function get_the_taxonomies( $post = 0, $args = array() ) {4867	$post = get_post( $post );4868 4869	$args = wp_parse_args(4870		$args,4871		array(4872			/* translators: %s: Taxonomy label, %l: List of terms formatted as per $term_template. */4873			'template'      => __( '%s: %l.' ),4874			'term_template' => '<a href="%1$s">%2$s</a>',4875		)4876	);4877 4878	$taxonomies = array();4879 4880	if ( ! $post ) {4881		return $taxonomies;4882	}4883 4884	foreach ( get_object_taxonomies( $post ) as $taxonomy ) {4885		$t = (array) get_taxonomy( $taxonomy );4886		if ( empty( $t['label'] ) ) {4887			$t['label'] = $taxonomy;4888		}4889		if ( empty( $t['args'] ) ) {4890			$t['args'] = array();4891		}4892		if ( empty( $t['template'] ) ) {4893			$t['template'] = $args['template'];4894		}4895		if ( empty( $t['term_template'] ) ) {4896			$t['term_template'] = $args['term_template'];4897		}4898 4899		$terms = get_object_term_cache( $post->ID, $taxonomy );4900		if ( false === $terms ) {4901			$terms = wp_get_object_terms( $post->ID, $taxonomy, $t['args'] );4902		}4903		$links = array();4904 4905		foreach ( $terms as $term ) {4906			$links[] = wp_sprintf( $t['term_template'], esc_attr( get_term_link( $term ) ), $term->name );4907		}4908		if ( $links ) {4909			$taxonomies[ $taxonomy ] = wp_sprintf( $t['template'], $t['label'], $links, $terms );4910		}4911	}4912	return $taxonomies;4913}

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