[wp-trac] [WordPress Trac] #53467: Correct and standardise the meta query documentation
WordPress Trac
noreply at wordpress.org
Sun Jun 20 22:35:03 UTC 2021
#53467: Correct and standardise the meta query documentation
-------------------------+-----------------------------
Reporter: johnbillion | Owner: (none)
Type: enhancement | Status: new
Priority: normal | Milestone: Awaiting Review
Component: General | Version:
Severity: normal | Keywords:
Focuses: docs |
-------------------------+-----------------------------
The following query classes all support `meta_*` arguments because they
pass their arguments onto `WP_Meta_Query`, however their documentation is
inconsistent, incomplete, and in some cases incorrect.
* `WP_Comment_Query`
* `WP_Query`
* `WP_Site_Query`
* `WP_Term_Query`
* `WP_User_Query`
Notably, `WP_Query` documents a `meta_value_num` argument which does not
exist. This was erroneously introduced in [28887]. `meta_value_num` is an
allowed value for `orderby` arguments, but is not the name of an argument
itself.
Let's standardise the documentation and guide users to `WP_Meta_Query` for
the canonical documentation.
--
Ticket URL: <https://core.trac.wordpress.org/ticket/53467>
WordPress Trac <https://core.trac.wordpress.org/>
WordPress publishing platform
More information about the wp-trac
mailing list