[wp-trac] [WordPress Trac] #38283: Document missing `WP_Query` query vars

WordPress Trac noreply at wordpress.org
Tue Oct 11 15:07:19 UTC 2016


#38283: Document missing `WP_Query` query vars
--------------------------+-----------------------------
 Reporter:  jdgrimes      |      Owner:
     Type:  defect (bug)  |     Status:  new
 Priority:  normal        |  Milestone:  Awaiting Review
Component:  Query         |    Version:  trunk
 Severity:  normal        |   Keywords:
  Focuses:  docs          |
--------------------------+-----------------------------
 While working on #38276, I noticed that the `has_password` and
 `post_password` query args (added in [27395]) aren't included in the
 inline docs for `WP_Query::parse_query()` with the other args. I did a
 search for all of the args used in `WP_Query`, and discovered that the
 following args are used but not documented:

 {{{
 attachment
 caller_get_posts
 embed
 error
 feed
 has_password
 minute
 post_password
 posts_per_rss
 preview
 robots
 search_orderby_title
 search_terms
 search_terms_count
 showposts
 static
 subpost
 subpost_id
 taxonomy
 tb
 term
 term_id
 withcomments
 withoutcomments
 }}}

 Some of these may be deprecated, discouraged, or internal. If there has
 been a previous decision not to include them for some reason, then I
 apologize for bringing it up. But I couldn't find any tickets relating to
 the password related args not being documented, so I have a feeling that
 some of these may have just been overlooked.

 Perhaps some of these shouldn't be documented, although we could document
 deprecated args and that they are deprecated, rather than just leaving
 them out. But at least this ticket will provide us a central place where
 we can state why certain ones aren't going to be documented, if indeed
 that's the decision.

--
Ticket URL: <https://core.trac.wordpress.org/ticket/38283>
WordPress Trac <https://core.trac.wordpress.org/>
WordPress publishing platform


More information about the wp-trac mailing list