Changeset 37878

Timestamp:

06/26/2016 06:05:22 PM (8 years ago)

Author:

DrewAPicture

Message:

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

See #32246.

File:

• trunk/src/wp-includes/query.php (modified) (1 diff)

trunk/src/wp-includes/query.php

@@ -80 +80 @@
  * 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.