[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