A WordPress-centric search engine for devs and theme authors



render_block_core_tag_cloud ›

Sincen/a
Deprecatedn/a
› render_block_core_tag_cloud ( $attributes )
Parameters:
  • (array) $attributes The block attributes.
    Required: Yes
Returns:
  • (string) Returns the tag cloud for selected taxonomy.
Defined at:
Codex:

Renders the `core/tag-cloud` block on server.



Related Functions: register_block_core_tag_cloud, render_block_core_block, render_block_core_calendar, render_block_core_search, render_block_core_rss

Source 

function render_block_core_tag_cloud( $attributes ) {
	$class = isset( $attributes['align'] ) ?
		"wp-block-tag-cloud align{$attributes['align']}" :
		'wp-block-tag-cloud';

	if ( isset( $attributes['className'] ) ) {
		$class .= ' ' . $attributes['className'];
	}

	$args = array(
		'echo'       => false,
		'taxonomy'   => $attributes['taxonomy'],
		'show_count' => $attributes['showTagCounts'],
	);

	$tag_cloud = wp_tag_cloud( $args );

	if ( ! $tag_cloud ) {
		$labels    = get_taxonomy_labels( get_taxonomy( $attributes['taxonomy'] ) );
		$tag_cloud = esc_html(
			sprintf(
				/* translators: %s: taxonomy name */
				__( 'Your site doesn’t have any %s, so there’s nothing to display here at the moment.' ),
				strtolower( $labels->name )
			)
		);
	}

	return sprintf(
		'<p class="%1$s">%2$s</p>',
		esc_attr( $class ),
		$tag_cloud
	);
}