From 736e6a2977d0cd745bd22c1be28345a67a5ef274 Mon Sep 17 00:00:00 2001 From: Boone Gorges Date: Thu, 15 Jun 2017 09:39:42 +0000 Subject: [PATCH] Simplify documentation for `wp_dropdown_categories()`. Props ArnaudBan. Fixes #41058. Built from https://develop.svn.wordpress.org/trunk@40903 git-svn-id: http://core.svn.wordpress.org/trunk@40753 1a063a9b-81f0-0310-95a4-ce76da25c4cd --- wp-includes/category-template.php | 15 ++------------- wp-includes/version.php | 2 +- 2 files changed, 3 insertions(+), 14 deletions(-) diff --git a/wp-includes/category-template.php b/wp-includes/category-template.php index ce78471d21..a9679f529f 100644 --- a/wp-includes/category-template.php +++ b/wp-includes/category-template.php @@ -275,27 +275,17 @@ function category_description( $category = 0 ) { * @since 4.6.0 Introduced the `required` argument. * * @param string|array $args { - * Optional. Array or string of arguments to generate a categories drop-down element. + * Optional. Array or string of arguments to generate a categories drop-down element. See WP_Term_Query::__construct() + * for information on additional accepted arguments. * * @type string $show_option_all Text to display for showing all categories. Default empty. * @type string $show_option_none Text to display for showing no categories. Default empty. * @type string $option_none_value Value to use when no category is selected. Default empty. - * @type string $orderby Which column to use for ordering categories. See get_terms() for a list - * of accepted values. Default 'id' (term_id). - * @type string $order Whether to order terms in ascending or descending order. Accepts 'ASC' - * or 'DESC'. Default 'ASC'. * @type bool $pad_counts See get_terms() for an argument description. Default false. * @type bool|int $show_count Whether to include post counts. Accepts 0, 1, or their bool equivalents. * Default 0. - * @type bool|int $hide_empty Whether to hide categories that don't have any posts. Accepts 0, 1, or - * their bool equivalents. Default 1. - * @type int $child_of Term ID to retrieve child terms of. See get_terms(). Default 0. - * @type array|string $exclude Array or comma/space-separated string of term ids to exclude. - * If `$include` is non-empty, `$exclude` is ignored. Default empty array. * @type bool|int $echo Whether to echo or return the generated markup. Accepts 0, 1, or their * bool equivalents. Default 1. - * @type bool|int $hierarchical Whether to traverse the taxonomy hierarchy. Accepts 0, 1, or their bool - * equivalents. Default 0. * @type int $depth Maximum depth. Default 0. * @type int $tab_index Tab index for the select element. Default 0 (no tabindex). * @type string $name Value for the 'name' attribute of the select element. Default 'cat'. @@ -307,7 +297,6 @@ function category_description( $category = 0 ) { * of the option elements. Accepts any valid term field: 'term_id', 'name', * 'slug', 'term_group', 'term_taxonomy_id', 'taxonomy', 'description', * 'parent', 'count'. Default 'term_id'. - * @type string|array $taxonomy Name of the category or categories to retrieve. Default 'category'. * @type bool $hide_if_empty True to skip generating markup if no categories are found. * Default false (create select element even if no categories are found). * @type bool $required Whether the `