Skip to content
Permalink
Browse files

Taxonomy: Standardize docs for `wp_list_categories()`.

Many of the parameters historically documented on this function are merely
passed through to `get_categories()` and its underlying functions. In order to
avoid unnecessary duplication of function arguments, we remove documentation of
these parameters, and replace it with reference to the wrapped functions.

Parameters that receive special treatment or are otherwise changed before
being passed through continue to be documented as part of `wp_list_categories()`.

Props audrasjb, itowhid06, birgire.
Fixes #47896.

git-svn-id: https://develop.svn.wordpress.org/trunk@45894 602fd350-edb4-49c9-b593-d223f7449a82
  • Loading branch information...
boonebgorges committed Aug 26, 2019
1 parent c2c8a68 commit 7dac24c681c1ede818c5e1957a61089252ec82c0
Showing with 2 additions and 10 deletions.
  1. +2 −10 src/wp-includes/category-template.php
@@ -470,9 +470,9 @@ function wp_dropdown_categories( $args = '' ) {
* optionally accept an array of values.
*
* @param string|array $args {
* Array of optional arguments.
* Array of optional arguments. See get_categories(), get_terms(), and WP_Tax_Query::construct()
* for full lists of arguments that can be passed in `$args`.
*
* @type int $child_of Term ID to retrieve child terms of. See get_terms(). Default 0.
* @type int|array $current_category ID of category, or array of IDs of categories, that should get the
* 'current-cat' class. Default 0.
* @type int $depth Category depth. Used for tab indentation. Default 0.
@@ -488,15 +488,8 @@ function wp_dropdown_categories( $args = '' ) {
* @type string $feed_image URL of an image to use for the feed link. Default empty string.
* @type string $feed_type Feed type. Used to build feed link. See get_term_feed_link().
* Default empty string (default feed).
* @type bool|int $hide_empty Whether to hide categories that don't have any posts attached to them.
* Default 1.
* @type bool $hide_title_if_empty Whether to hide the `$title_li` element if there are no terms in
* the list. Default false (title will always be shown).
* @type bool $hierarchical Whether to include terms that have non-empty descendants.
* See get_terms(). Default true.
* @type string $order Which direction to order categories. Accepts 'ASC' or 'DESC'.
* Default 'ASC'.
* @type string $orderby The column to use for ordering categories. Default 'name'.
* @type string $separator Separator between links. Default '<br />'.
* @type bool|int $show_count Whether to show how many posts are in the category. Default 0.
* @type string $show_option_all Text to display for showing all categories. Default empty string.
@@ -505,7 +498,6 @@ function wp_dropdown_categories( $args = '' ) {
* @type string $style The style used to display the categories list. If 'list', categories
* will be output as an unordered list. If left empty or another value,
* categories will be output separated by `<br>` tags. Default 'list'.
* @type string $taxonomy Taxonomy name. Default 'category'.
* @type string $title_li Text to use for the list title `<li>` element. Pass an empty string
* to disable. Default 'Categories'.
* @type bool|int $use_desc_for_title Whether to use the category description as the title attribute.

0 comments on commit 7dac24c

Please sign in to comment.
You can’t perform that action at this time.