WordPress.org

Make WordPress Core

Ticket #42019: 42019.2.patch

File 42019.2.patch, 3.5 KB (added by johnbillion, 4 years ago)
  • src/wp-includes/category-template.php

    diff --git a/src/wp-includes/category-template.php b/src/wp-includes/category-template.php
    index c9bf0d2f73..b026843a1e 100644
    a b function wp_list_categories( $args = '' ) { 
    633633}
    634634
    635635/**
    636  * Display tag cloud.
    637  *
    638  * The text size is set by the 'smallest' and 'largest' arguments, which will
    639  * use the 'unit' argument value for the CSS text size unit. The 'format'
    640  * argument can be 'flat' (default), 'list', or 'array'. The flat value for the
    641  * 'format' argument will separate tags with spaces. The list value for the
    642  * 'format' argument will format the tags in a UL HTML list. The array value for
    643  * the 'format' argument will return in PHP array type format.
    644  *
    645  * The 'orderby' argument will accept 'name' or 'count' and defaults to 'name'.
    646  * The 'order' is the direction to sort, defaults to 'ASC' and can be 'DESC'.
    647  *
    648  * The 'number' argument is how many tags to return. By default, the limit will
    649  * be to return the top 45 tags in the tag cloud list.
    650  *
    651  * The 'topic_count_text' argument is a nooped plural from _n_noop() to generate the
    652  * text for the tag link count.
    653  *
    654  * The 'topic_count_text_callback' argument is a function, which given the count
    655  * of the posts with that tag returns a text for the tag link count.
    656  *
    657  * The 'post_type' argument is used only when 'link' is set to 'edit'. It determines the post_type
    658  * passed to edit.php for the popular tags edit links.
    659  *
    660  * The 'exclude' and 'include' arguments are used for the get_tags() function. Only one
    661  * should be used, because only one will be used and the other ignored, if they are both set.
     636 * Displays a tag cloud.
    662637 *
    663638 * @since 2.3.0
    664  * @since 4.8.0 Added the `show_count` argument.
    665  *
    666  * @param array|string|null $args Optional. Override default arguments.
     639 * @see wp_generate_tag_cloud() and get_terms() for the full lists of arguments which can be passed in $args.
     640 *
     641 * @param array|string $args {
     642 *     Optional. Array or string of arguments for displaying a tag cloud.
     643 *
     644 *     @type int    $number    The number of tags to display. Accepts any positive integer
     645 *                             or zero to return all. Default 0 (all tags).
     646 *     @type string $link      Whether to display term editing links or term permalinks.
     647 *                             Accepts 'edit' and 'view'. Default 'view'.
     648 *     @type string $post_type The post type. Used to highlight the proper post type menu
     649 *                             on the linked edit page. Defaults to the first post type
     650 *                             associated with the taxonomy.
     651 *     @type bool   $echo      Whether or not to echo the return value. Default true.
     652 * }
    667653 * @return void|array Generated tag cloud, only if no failures and 'array' is set for the 'format' argument.
    668654 *                    Otherwise, this function outputs the tag cloud.
    669655 */
    function default_topic_count_scale( $count ) { 
    730716 * @since 2.3.0
    731717 * @since 4.8.0 Added the `show_count` argument.
    732718 *
    733  * @param array $tags List of tags.
     719 * @param array $tags Array of WP_Term objects to generate the tag cloud for.
    734720 * @param string|array $args {
    735  *     Optional. Array of string of arguments for generating a tag cloud.
     721 *     Optional. Array or string of arguments for generating a tag cloud.
    736722 *
    737723 *     @type int      $smallest                   Smallest font size used to display tags. Paired
    738724 *                                                with the value of `$unit`, to determine CSS text