Changeset 62664

Timestamp:

07/08/2026 07:03:59 AM (5 weeks ago)

Author:

westonruter

Message:

Sitemaps: Add the is_sitemap() conditional tag.

Introduce is_sitemap() as a conditional tag, mirroring the existing is_robots() and is_favicon() tags, and add the corresponding $is_sitemap property to WP_Query. The flag is set whenever the sitemap query variable is present, and a sitemap request is now excluded from being treated as the home page.

Developed in ​https://github.com/WordPress/wordpress-develop/pull/12142.
Follow-up to r47018, r48072.

Props masteradhoc, nimeshatxecurify, westonruter, mukesh27, madtownlems, ravanh, cybr, swissspidy.
See #51117.
Fixes #51542, #51543.

Location:

trunk

Files:

• src/wp-includes/class-wp-query.php (modified) (5 diffs)
• src/wp-includes/query.php (modified) (1 diff)
• tests/phpunit/includes/abstract-testcase.php (modified) (1 diff)
• tests/phpunit/tests/query/isSitemap.php (added)

trunk/src/wp-includes/class-wp-query.php

@@ -410 +410 @@
          */
         public $is_favicon = false;
+
+        /**
+         * Signifies whether the current query is for a sitemap.
+         *
+         * @since 7.1.0
+         */
+        public bool $is_sitemap = false;
 
         /**
@@ -520 +527 @@
                 $this->is_robots            = false;
                 $this->is_favicon           = false;
+                $this->is_sitemap           = false;
                 $this->is_posts_page        = false;
                 $this->is_post_type_archive = false;
@@ -818 +826 @@
                 } elseif ( ! empty( $query_vars['favicon'] ) ) {
                         $this->is_favicon = true;
+                } elseif ( ! empty( $query_vars['sitemap'] ) ) {
+                        $this->is_sitemap = true;
                 }
 
@@ -1041 +1051 @@
                 if ( ! ( $this->is_singular || $this->is_archive || $this->is_search || $this->is_feed
                                 || ( wp_is_serving_rest_request() && $this->is_main_query() )
-                                || $this->is_trackback || $this->is_404 || $this->is_admin || $this->is_robots || $this->is_favicon ) ) {
+                                || $this->is_trackback || $this->is_404 || $this->is_admin || $this->is_robots || $this->is_favicon || $this->is_sitemap ) ) {
                         $this->is_home = true;
                 }
@@ -4644 +4654 @@
 
         /**
+         * Determines whether the query is for a sitemap.
+         *
+         * @since 7.1.0
+         *
+         * @return bool Whether the query is for a sitemap.
+         */
+        public function is_sitemap(): bool {
+                return $this->is_sitemap;
+        }
+
+        /**
          * Determines whether the query is for a search.
          *

trunk/src/wp-includes/query.php

@@ -679 +679 @@
 
         return $wp_query->is_favicon();
+}
+
+/**
+ * Is the query for a sitemap?
+ *
+ * @since 7.1.0
+ *
+ * @global WP_Query $wp_query WordPress Query object.
+ *
+ * @return bool Whether the query is for a sitemap.
+ */
+function is_sitemap(): bool {
+        global $wp_query;
+
+        if ( ! isset( $wp_query ) ) {
+                _doing_it_wrong( __FUNCTION__, __( 'Conditional query tags do not work before the query is run. Before then, they always return false.' ), '7.1.0' );
+                return false;
+        }
+
+        return $wp_query->is_sitemap();
 }
 

trunk/tests/phpunit/includes/abstract-testcase.php

@@ -1188 +1188 @@
                         'is_robots',
                         'is_favicon',
+                        'is_sitemap',
                         'is_search',
                         'is_single',