<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN"
"http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head><meta http-equiv="content-type" content="text/html; charset=utf-8" />
<title>[45894] trunk/src/wp-includes/category-template.php: Taxonomy: Standardize docs for `wp_list_categories()`.</title>
</head>
<body>
<style type="text/css"><!--
#msg dl.meta { border: 1px #006 solid; background: #369; padding: 6px; color: #fff; }
#msg dl.meta dt { float: left; width: 6em; font-weight: bold; }
#msg dt:after { content:':';}
#msg dl, #msg dt, #msg ul, #msg li, #header, #footer, #logmsg { font-family: verdana,arial,helvetica,sans-serif; font-size: 10pt; }
#msg dl a { font-weight: bold}
#msg dl a:link { color:#fc3; }
#msg dl a:active { color:#ff0; }
#msg dl a:visited { color:#cc6; }
h3 { font-family: verdana,arial,helvetica,sans-serif; font-size: 10pt; font-weight: bold; }
#msg pre { white-space: pre-line; overflow: auto; background: #ffc; border: 1px #fa0 solid; padding: 6px; }
#logmsg { background: #ffc; border: 1px #fa0 solid; padding: 1em 1em 0 1em; }
#logmsg p, #logmsg pre, #logmsg blockquote { margin: 0 0 1em 0; }
#logmsg p, #logmsg li, #logmsg dt, #logmsg dd { line-height: 14pt; }
#logmsg h1, #logmsg h2, #logmsg h3, #logmsg h4, #logmsg h5, #logmsg h6 { margin: .5em 0; }
#logmsg h1:first-child, #logmsg h2:first-child, #logmsg h3:first-child, #logmsg h4:first-child, #logmsg h5:first-child, #logmsg h6:first-child { margin-top: 0; }
#logmsg ul, #logmsg ol { padding: 0; list-style-position: inside; margin: 0 0 0 1em; }
#logmsg ul { text-indent: -1em; padding-left: 1em; }#logmsg ol { text-indent: -1.5em; padding-left: 1.5em; }
#logmsg > ul, #logmsg > ol { margin: 0 0 1em 0; }
#logmsg pre { background: #eee; padding: 1em; }
#logmsg blockquote { border: 1px solid #fa0; border-left-width: 10px; padding: 1em 1em 0 1em; background: white;}
#logmsg dl { margin: 0; }
#logmsg dt { font-weight: bold; }
#logmsg dd { margin: 0; padding: 0 0 0.5em 0; }
#logmsg dd:before { content:'\00bb';}
#logmsg table { border-spacing: 0px; border-collapse: collapse; border-top: 4px solid #fa0; border-bottom: 1px solid #fa0; background: #fff; }
#logmsg table th { text-align: left; font-weight: normal; padding: 0.2em 0.5em; border-top: 1px dotted #fa0; }
#logmsg table td { text-align: right; border-top: 1px dotted #fa0; padding: 0.2em 0.5em; }
#logmsg table thead th { text-align: center; border-bottom: 1px solid #fa0; }
#logmsg table th.Corner { text-align: left; }
#logmsg hr { border: none 0; border-top: 2px dashed #fa0; height: 1px; }
#header, #footer { color: #fff; background: #636; border: 1px #300 solid; padding: 6px; }
#patch { width: 100%; }
#patch h4 {font-family: verdana,arial,helvetica,sans-serif;font-size:10pt;padding:8px;background:#369;color:#fff;margin:0;}
#patch .propset h4, #patch .binary h4 {margin:0;}
#patch pre {padding:0;line-height:1.2em;margin:0;}
#patch .diff {width:100%;background:#eee;padding: 0 0 10px 0;overflow:auto;}
#patch .propset .diff, #patch .binary .diff {padding:10px 0;}
#patch span {display:block;padding:0 10px;}
#patch .modfile, #patch .addfile, #patch .delfile, #patch .propset, #patch .binary, #patch .copfile {border:1px solid #ccc;margin:10px 0;}
#patch ins {background:#dfd;text-decoration:none;display:block;padding:0 10px;}
#patch del {background:#fdd;text-decoration:none;display:block;padding:0 10px;}
#patch .lines, .info {color:#888;background:#fff;}
--></style>
<div id="msg">
<dl class="meta" style="font-size: 105%">
<dt style="float: left; width: 6em; font-weight: bold">Revision</dt> <dd><a style="font-weight: bold" href="https://core.trac.wordpress.org/changeset/45894">45894</a><script type="application/ld+json">{"@context":"http://schema.org","@type":"EmailMessage","description":"Review this Commit","action":{"@type":"ViewAction","url":"https://core.trac.wordpress.org/changeset/45894","name":"Review Commit"}}</script></dd>
<dt style="float: left; width: 6em; font-weight: bold">Author</dt> <dd>boonebgorges</dd>
<dt style="float: left; width: 6em; font-weight: bold">Date</dt> <dd>2019-08-26 15:23:48 +0000 (Mon, 26 Aug 2019)</dd>
</dl>
<pre style='padding-left: 1em; margin: 2em 0; border-left: 2px solid #ccc; line-height: 1.25; font-size: 105%; font-family: sans-serif'>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 <a href="https://core.trac.wordpress.org/ticket/47896">#47896</a>.</pre>
<h3>Modified Paths</h3>
<ul>
<li><a href="#trunksrcwpincludescategorytemplatephp">trunk/src/wp-includes/category-template.php</a></li>
</ul>
</div>
<div id="patch">
<h3>Diff</h3>
<a id="trunksrcwpincludescategorytemplatephp"></a>
<div class="modfile"><h4 style="background-color: #eee; color: inherit; margin: 1em 0; padding: 1.3em; font-size: 115%">Modified: trunk/src/wp-includes/category-template.php</h4>
<pre class="diff"><span>
<span class="info" style="display: block; padding: 0 10px; color: #888">--- trunk/src/wp-includes/category-template.php 2019-08-26 15:18:40 UTC (rev 45893)
+++ trunk/src/wp-includes/category-template.php 2019-08-26 15:23:48 UTC (rev 45894)
</span><span class="lines" style="display: block; padding: 0 10px; color: #888">@@ -470,9 +470,9 @@
</span><span class="cx" style="display: block; padding: 0 10px"> * optionally accept an array of values.
</span><span class="cx" style="display: block; padding: 0 10px"> *
</span><span class="cx" style="display: block; padding: 0 10px"> * @param string|array $args {
</span><del style="background-color: #fdd; text-decoration:none; display:block; padding: 0 10px">- * Array of optional arguments.
</del><ins style="background-color: #dfd; text-decoration:none; display:block; padding: 0 10px">+ * 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`.
</ins><span class="cx" style="display: block; padding: 0 10px"> *
</span><del style="background-color: #fdd; text-decoration:none; display:block; padding: 0 10px">- * @type int $child_of Term ID to retrieve child terms of. See get_terms(). Default 0.
</del><span class="cx" style="display: block; padding: 0 10px"> * @type int|array $current_category ID of category, or array of IDs of categories, that should get the
</span><span class="cx" style="display: block; padding: 0 10px"> * 'current-cat' class. Default 0.
</span><span class="cx" style="display: block; padding: 0 10px"> * @type int $depth Category depth. Used for tab indentation. Default 0.
</span><span class="lines" style="display: block; padding: 0 10px; color: #888">@@ -488,15 +488,8 @@
</span><span class="cx" style="display: block; padding: 0 10px"> * @type string $feed_image URL of an image to use for the feed link. Default empty string.
</span><span class="cx" style="display: block; padding: 0 10px"> * @type string $feed_type Feed type. Used to build feed link. See get_term_feed_link().
</span><span class="cx" style="display: block; padding: 0 10px"> * Default empty string (default feed).
</span><del style="background-color: #fdd; text-decoration:none; display:block; padding: 0 10px">- * @type bool|int $hide_empty Whether to hide categories that don't have any posts attached to them.
- * Default 1.
</del><span class="cx" style="display: block; padding: 0 10px"> * @type bool $hide_title_if_empty Whether to hide the `$title_li` element if there are no terms in
</span><span class="cx" style="display: block; padding: 0 10px"> * the list. Default false (title will always be shown).
</span><del style="background-color: #fdd; text-decoration:none; display:block; padding: 0 10px">- * @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'.
</del><span class="cx" style="display: block; padding: 0 10px"> * @type string $separator Separator between links. Default '<br />'.
</span><span class="cx" style="display: block; padding: 0 10px"> * @type bool|int $show_count Whether to show how many posts are in the category. Default 0.
</span><span class="cx" style="display: block; padding: 0 10px"> * @type string $show_option_all Text to display for showing all categories. Default empty string.
</span><span class="lines" style="display: block; padding: 0 10px; color: #888">@@ -505,7 +498,6 @@
</span><span class="cx" style="display: block; padding: 0 10px"> * @type string $style The style used to display the categories list. If 'list', categories
</span><span class="cx" style="display: block; padding: 0 10px"> * will be output as an unordered list. If left empty or another value,
</span><span class="cx" style="display: block; padding: 0 10px"> * categories will be output separated by `<br>` tags. Default 'list'.
</span><del style="background-color: #fdd; text-decoration:none; display:block; padding: 0 10px">- * @type string $taxonomy Taxonomy name. Default 'category'.
</del><span class="cx" style="display: block; padding: 0 10px"> * @type string $title_li Text to use for the list title `<li>` element. Pass an empty string
</span><span class="cx" style="display: block; padding: 0 10px"> * to disable. Default 'Categories'.
</span><span class="cx" style="display: block; padding: 0 10px"> * @type bool|int $use_desc_for_title Whether to use the category description as the title attribute.
</span></span></pre>
</div>
</div>
</body>
</html>