WordPress/wp-includes/blocks/tag-cloud.php

55 lines
1.2 KiB
PHP

<?php
/**
* Server-side rendering of the `core/tag-cloud` block.
*
* @package WordPress
*/
/**
* Renders the `core/tag-cloud` block on server.
*
* @param array $attributes The block attributes.
*
* @return string Returns the tag cloud for selected taxonomy.
*/
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&#8217;t have any %s, so there&#8217;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
);
}
/**
* Registers the `core/tag-cloud` block on server.
*/
function register_block_core_tag_cloud() {
register_block_type_from_metadata(
__DIR__ . '/tag-cloud',
array(
'render_callback' => 'render_block_core_tag_cloud',
)
);
}
add_action( 'init', 'register_block_core_tag_cloud' );