Changeset 53520

Timestamp:

06/18/2022 03:36:20 PM (2 years ago)

Author:

SergeyBiryukov

Message:

Docs: Consistently declare the $wp_query global in link template functions.

This ensures that the global is explicitly declared and documented in:

• get_next_posts_link()
• get_posts_nav_link()
• get_the_posts_navigation()
• get_the_posts_pagination()
• get_next_comments_link()

Follow-up to [30065].

Props mt8.biz, sabernhardt.
Fixes #43164.

File:

• trunk/src/wp-includes/link-template.php (modified) (3 diffs)

trunk/src/wp-includes/link-template.php

@@ -2766 +2766 @@
  */
 function get_the_posts_navigation( $args = array() ) {
+    global $wp_query;
+
     $navigation = '';
 
     // Don't print empty markup if there's only one page.
-    if ( $GLOBALS['wp_query']->max_num_pages > 1 ) {
+    if ( $wp_query->max_num_pages > 1 ) {
         // Make sure the nav element has an aria-label attribute: fallback to the screen reader text.
         if ( ! empty( $args['screen_reader_text'] ) && empty( $args['aria_label'] ) ) {
@@ -2822 +2824 @@
  * @since 5.5.0 Added the `class` parameter.
  *
+ * @global WP_Query $wp_query WordPress Query object.
+ *
  * @param array $args {
  *     Optional. Default pagination arguments, see paginate_links().
@@ -2833 +2837 @@
  */
 function get_the_posts_pagination( $args = array() ) {
+    global $wp_query;
+
     $navigation = '';
 
     // Don't print empty markup if there's only one page.
-    if ( $GLOBALS['wp_query']->max_num_pages > 1 ) {
+    if ( $wp_query->max_num_pages > 1 ) {
         // Make sure the nav element has an aria-label attribute: fallback to the screen reader text.
         if ( ! empty( $args['screen_reader_text'] ) && empty( $args['aria_label'] ) ) {