sergiotarxz/Wordpress
1
0
Fork 0
Code Issues Pull Requests Releases Wiki Activity

Docs: Further improve the note of caution within the DocBlock description for query_posts().

Browse Source 
See #32246.


git-svn-id: https://develop.svn.wordpress.org/trunk@37878 602fd350-edb4-49c9-b593-d223f7449a82
This commit is contained in:
Drew Jaynes 2016-06-26 18:05:22 +00:00
parent 6089491477
commit 095c705ffa
1 changed files with 5 additions and 3 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

8
src/wp-includes/query.php
View File

@ -79,9 +79,11 @@ function set_query_var( $var, $value ) {
/**
* Sets up The Loop with query parameters.
*
* Important: This will completely override the current WordPress Loop and can easily
* produce unexpected results. In most cases, the better option is to instead modify
* specific properties of the loop using the {@see 'pre_get_posts'} action.
* Note: This function will completely override the main query and isn't intended for use
* by plugins or themes. Its overly-simplistic approach to modifying the main query can be
* 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.
*