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 ) {
	$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 )
			)
		);
	}

	$wrapper_attributes = get_block_wrapper_attributes();

	return sprintf(
		'<p %1$s>%2$s</p>',
		$wrapper_attributes,
		$tag_cloud
	);
}