render_block_core_tag_cloud

The timeline below displays how wordpress function render_block_core_tag_cloud has changed across different WordPress versions. If a version is not listed, refer to the next available version below.

WordPress Version: 6.2

/**
 * 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)
{
    $smallest_font_size = $attributes['smallestFontSize'];
    $unit = preg_match('/^[0-9.]+(?P<unit>[a-z%]+)$/i', $smallest_font_size, $m) ? $m['unit'] : 'pt';
    $args = array('echo' => false, 'unit' => $unit, 'taxonomy' => $attributes['taxonomy'], 'show_count' => $attributes['showTagCounts'], 'number' => $attributes['numberOfTags'], 'smallest' => floatVal($attributes['smallestFontSize']), 'largest' => floatVal($attributes['largestFontSize']));
    $tag_cloud = wp_tag_cloud($args);
    if (!$tag_cloud) {
        $tag_cloud = __('There&#8217;s no content to show here yet.');
    }
    $wrapper_attributes = get_block_wrapper_attributes();
    return sprintf('<p %1$s>%2$s</p>', $wrapper_attributes, $tag_cloud);
}

WordPress Version: 6.1

/**
 * 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)
{
    $smallest_font_size = $attributes['smallestFontSize'];
    $unit = preg_match('/^[0-9.]+(?P<unit>[a-z%]+)$/i', $smallest_font_size, $m) ? $m['unit'] : 'pt';
    $args = array('echo' => false, 'unit' => $unit, 'taxonomy' => $attributes['taxonomy'], 'show_count' => $attributes['showTagCounts'], 'number' => $attributes['numberOfTags'], 'smallest' => floatVal($attributes['smallestFontSize']), 'largest' => floatVal($attributes['largestFontSize']));
    $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);
}

WordPress Version: 5.9

/**
 * 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'], 'number' => $attributes['numberOfTags']);
    $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);
}

WordPress Version: 5.6

/**
 * 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);
}

WordPress Version: 5.3

/**
 * 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)
{
    $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&#8217;t have any %s, so there&#8217;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);
}

WordPress Version: 5.2

/**
 * 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)
{
    $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) {
        $tag_cloud = esc_html(__('No terms to show.'));
    }
    return sprintf('<p class="%1$s">%2$s</p>', esc_attr($class), $tag_cloud);
}