From 0f9170b82d377ec6fac1913d2ed8344c909ba8e3 Mon Sep 17 00:00:00 2001 From: Sergey Biryukov Date: Tue, 24 Nov 2020 12:29:07 +0000 Subject: [PATCH] Docs: Clarify that the `$class` argument of `wp_list_bookmarks()` can accept an array. Follow-up to [32906]. See #51855, #51800. Built from https://develop.svn.wordpress.org/trunk@49688 git-svn-id: http://core.svn.wordpress.org/trunk@49411 1a063a9b-81f0-0310-95a4-ce76da25c4cd --- wp-includes/bookmark-template.php | 67 ++++++++++++++++--------------- wp-includes/version.php | 2 +- 2 files changed, 35 insertions(+), 34 deletions(-) diff --git a/wp-includes/bookmark-template.php b/wp-includes/bookmark-template.php index 0a3840502a..4a156a76cf 100644 --- a/wp-includes/bookmark-template.php +++ b/wp-includes/bookmark-template.php @@ -168,39 +168,40 @@ function _walk_bookmarks( $bookmarks, $args = '' ) { * @param string|array $args { * Optional. String or array of arguments to list bookmarks. * - * @type string $orderby How to order the links by. Accepts post fields. Default 'name'. - * @type string $order Whether to order bookmarks in ascending or descending order. - * Accepts 'ASC' (ascending) or 'DESC' (descending). Default 'ASC'. - * @type int $limit Amount of bookmarks to display. Accepts 1+ or -1 for all. - * Default -1. - * @type string $category Comma-separated list of category IDs to include links from. - * Default empty. - * @type string $category_name Category to retrieve links for by name. Default empty. - * @type int|bool $hide_invisible Whether to show or hide links marked as 'invisible'. Accepts - * 1|true or 0|false. Default 1|true. - * @type int|bool $show_updated Whether to display the time the bookmark was last updated. - * Accepts 1|true or 0|false. Default 0|false. - * @type int|bool $echo Whether to echo or return the formatted bookmarks. Accepts - * 1|true (echo) or 0|false (return). Default 1|true. - * @type int|bool $categorize Whether to show links listed by category or in a single column. - * Accepts 1|true (by category) or 0|false (one column). Default 1|true. - * @type int|bool $show_description Whether to show the bookmark descriptions. Accepts 1|true or 0|false. - * Default 0|false. - * @type string $title_li What to show before the links appear. Default 'Bookmarks'. - * @type string $title_before The HTML or text to prepend to the $title_li string. Default '

'. - * @type string $title_after The HTML or text to append to the $title_li string. Default '

'. - * @type string $class The CSS class to use for the $title_li. Default 'linkcat'. - * @type string $category_before The HTML or text to prepend to $title_before if $categorize is true. - * String must contain '%id' and '%class' to inherit the category ID and - * the $class argument used for formatting in themes. - * Default '
  • '. - * @type string $category_after The HTML or text to append to $title_after if $categorize is true. - * Default '
  • '. - * @type string $category_orderby How to order the bookmark category based on term scheme if $categorize - * is true. Default 'name'. - * @type string $category_order Whether to order categories in ascending or descending order if - * $categorize is true. Accepts 'ASC' (ascending) or 'DESC' (descending). - * Default 'ASC'. + * @type string $orderby How to order the links by. Accepts post fields. Default 'name'. + * @type string $order Whether to order bookmarks in ascending or descending order. + * Accepts 'ASC' (ascending) or 'DESC' (descending). Default 'ASC'. + * @type int $limit Amount of bookmarks to display. Accepts 1+ or -1 for all. + * Default -1. + * @type string $category Comma-separated list of category IDs to include links from. + * Default empty. + * @type string $category_name Category to retrieve links for by name. Default empty. + * @type int|bool $hide_invisible Whether to show or hide links marked as 'invisible'. Accepts + * 1|true or 0|false. Default 1|true. + * @type int|bool $show_updated Whether to display the time the bookmark was last updated. + * Accepts 1|true or 0|false. Default 0|false. + * @type int|bool $echo Whether to echo or return the formatted bookmarks. Accepts + * 1|true (echo) or 0|false (return). Default 1|true. + * @type int|bool $categorize Whether to show links listed by category or in a single column. + * Accepts 1|true (by category) or 0|false (one column). Default 1|true. + * @type int|bool $show_description Whether to show the bookmark descriptions. Accepts 1|true or 0|false. + * Default 0|false. + * @type string $title_li What to show before the links appear. Default 'Bookmarks'. + * @type string $title_before The HTML or text to prepend to the $title_li string. Default '

    '. + * @type string $title_after The HTML or text to append to the $title_li string. Default '

    '. + * @type string|array $class The CSS class or an array of classes to use for the $title_li. + * Default 'linkcat'. + * @type string $category_before The HTML or text to prepend to $title_before if $categorize is true. + * String must contain '%id' and '%class' to inherit the category ID and + * the $class argument used for formatting in themes. + * Default '
  • '. + * @type string $category_after The HTML or text to append to $title_after if $categorize is true. + * Default '
  • '. + * @type string $category_orderby How to order the bookmark category based on term scheme if $categorize + * is true. Default 'name'. + * @type string $category_order Whether to order categories in ascending or descending order if + * $categorize is true. Accepts 'ASC' (ascending) or 'DESC' (descending). + * Default 'ASC'. * } * @return void|string Void if 'echo' argument is true, HTML list of bookmarks if 'echo' is false. */ diff --git a/wp-includes/version.php b/wp-includes/version.php index 54a40533f5..2981d3b639 100644 --- a/wp-includes/version.php +++ b/wp-includes/version.php @@ -13,7 +13,7 @@ * * @global string $wp_version */ -$wp_version = '5.7-alpha-49685'; +$wp_version = '5.7-alpha-49688'; /** * Holds the WordPress DB revision, increments when changes are made to the WordPress DB schema.