Docs: Further improve the note of caution within the DocBlock description for `query_posts()`.
See #32246. git-svn-id: https://develop.svn.wordpress.org/trunk@37878 602fd350-edb4-49c9-b593-d223f7449a82
This commit is contained in:
parent
6089491477
commit
095c705ffa
|
@ -79,9 +79,11 @@ function set_query_var( $var, $value ) {
|
||||||
/**
|
/**
|
||||||
* Sets up The Loop with query parameters.
|
* Sets up The Loop with query parameters.
|
||||||
*
|
*
|
||||||
* Important: This will completely override the current WordPress Loop and can easily
|
* Note: This function will completely override the main query and isn't intended for use
|
||||||
* produce unexpected results. In most cases, the better option is to instead modify
|
* by plugins or themes. Its overly-simplistic approach to modifying the main query can be
|
||||||
* specific properties of the loop using the {@see 'pre_get_posts'} action.
|
* problematic and should be avoided wherever possible. In most cases, there are better,
|
||||||
|
* more performant options for modifying the main query such as via the {@see 'pre_get_posts'}
|
||||||
|
* action within WP_Query.
|
||||||
*
|
*
|
||||||
* This must not be used within the WordPress Loop.
|
* This must not be used within the WordPress Loop.
|
||||||
*
|
*
|
||||||
|
|
Loading…
Reference in New Issue