[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