[wp-trac] [WordPress Trac] #51378: Taxonomy is missing from wp_list_categories inline documentation
WordPress Trac
noreply at wordpress.org
Sun Sep 27 08:00:55 UTC 2020
#51378: Taxonomy is missing from wp_list_categories inline documentation
------------------------------+-----------------------------
Reporter: grapplerulrich | Owner: SergeyBiryukov
Type: defect (bug) | Status: reviewing
Priority: normal | Milestone: 5.6
Component: Taxonomy | Version:
Severity: normal | Resolution:
Keywords: has-patch commit | Focuses: docs
------------------------------+-----------------------------
Comment (by SergeyBiryukov):
Thanks for the PR! The first part of it is now committed.
Some history on the second part:
* The description of the `taxonomy` argument in `wp_list_categories()` was
intentionally removed in [45894], see comment:12:ticket:47896 and
comment:8:ticket:41058 for the reasoning. The DocBlock includes a
reference to `get_categories()`, `get_terms()`, and
`WP_Term_Query::__construct()` for information on additional accepted
arguments.
* That said, the same was done for `wp_dropdown_categories()`. The
`taxonomy` parameter was removed in [40903] and then reinstated in
[41767], since it's different from the default in
`WP_Term_Query::__construct()`.
* With the above in mind, it should probably be reinstated for
`wp_list_categories()` too.
--
Ticket URL: <https://core.trac.wordpress.org/ticket/51378#comment:7>
WordPress Trac <https://core.trac.wordpress.org/>
WordPress publishing platform
More information about the wp-trac
mailing list