[Summary view] [Print] [Text view]

   1  <?php
   2  /**
   3   * WordPress Query API
   4   *
   5   * The query API attempts to get which part of WordPress the user is on. It
   6   * also provides functionality for getting URL query information.
   7   *
   8   * @link https://developer.wordpress.org/themes/basics/the-loop/ More information on The Loop.
   9   *
  10   * @package WordPress
  11   * @subpackage Query
  12   */
  13  
  14  /**
  15   * Retrieves the value of a query variable in the WP_Query class.
  16   *
  17   * @since 1.5.0
  18   * @since 3.9.0 The `$default_value` argument was introduced.
  19   *
  20   * @global WP_Query $wp_query WordPress Query object.
  21   *
  22   * @param string $query_var     The variable key to retrieve.
  23   * @param mixed  $default_value Optional. Value to return if the query variable is not set.
  24   *                              Default empty string.
  25   * @return mixed Contents of the query variable.
  26   */
  27  function get_query_var( $query_var, $default_value = '' ) {
  28      global $wp_query;
  29      return $wp_query->get( $query_var, $default_value );
  30  }
  31  
  32  /**
  33   * Retrieves the currently queried object.
  34   *
  35   * Wrapper for WP_Query::get_queried_object().
  36   *
  37   * @since 3.1.0
  38   *
  39   * @global WP_Query $wp_query WordPress Query object.
  40   *
  41   * @return WP_Term|WP_Post_Type|WP_Post|WP_User|null The queried object.
  42   */
  43  function get_queried_object() {
  44      global $wp_query;
  45      return $wp_query->get_queried_object();
  46  }
  47  
  48  /**
  49   * Retrieves the ID of the currently queried object.
  50   *
  51   * Wrapper for WP_Query::get_queried_object_id().
  52   *
  53   * @since 3.1.0
  54   *
  55   * @global WP_Query $wp_query WordPress Query object.
  56   *
  57   * @return int ID of the queried object.
  58   */
  59  function get_queried_object_id() {
  60      global $wp_query;
  61      return $wp_query->get_queried_object_id();
  62  }
  63  
  64  /**
  65   * Sets the value of a query variable in the WP_Query class.
  66   *
  67   * @since 2.2.0
  68   *
  69   * @global WP_Query $wp_query WordPress Query object.
  70   *
  71   * @param string $query_var Query variable key.
  72   * @param mixed  $value     Query variable value.
  73   */
  74  function set_query_var( $query_var, $value ) {
  75      global $wp_query;
  76      $wp_query->set( $query_var, $value );
  77  }
  78  
  79  /**
  80   * Sets up The Loop with query parameters.
  81   *
  82   * Note: This function will completely override the main query and isn't intended for use
  83   * by plugins or themes. Its overly-simplistic approach to modifying the main query can be
  84   * problematic and should be avoided wherever possible. In most cases, there are better,
  85   * more performant options for modifying the main query such as via the {@see 'pre_get_posts'}
  86   * action within WP_Query.
  87   *
  88   * This must not be used within the WordPress Loop.
  89   *
  90   * @since 1.5.0
  91   *
  92   * @global WP_Query $wp_query WordPress Query object.
  93   *
  94   * @param array|string $query Array or string of WP_Query arguments.
  95   * @return WP_Post[]|int[] Array of post objects or post IDs.
  96   */
  97  function query_posts( $query ) {
  98      $GLOBALS['wp_query'] = new WP_Query();
  99      return $GLOBALS['wp_query']->query( $query );
 100  }
 101  
 102  /**
 103   * Destroys the previous query and sets up a new query.
 104   *
 105   * This should be used after query_posts() and before another query_posts().
 106   * This will remove obscure bugs that occur when the previous WP_Query object
 107   * is not destroyed properly before another is set up.
 108   *
 109   * @since 2.3.0
 110   *
 111   * @global WP_Query $wp_query     WordPress Query object.
 112   * @global WP_Query $wp_the_query Copy of the global WP_Query instance created during wp_reset_query().
 113   */
 114  function wp_reset_query() {
 115      $GLOBALS['wp_query'] = $GLOBALS['wp_the_query'];
 116      wp_reset_postdata();
 117  }
 118  
 119  /**
 120   * After looping through a separate query, this function restores
 121   * the $post global to the current post in the main query.
 122   *
 123   * @since 3.0.0
 124   *
 125   * @global WP_Query $wp_query WordPress Query object.
 126   */
 127  function wp_reset_postdata() {
 128      global $wp_query;
 129  
 130      if ( isset( $wp_query ) ) {
 131          $wp_query->reset_postdata();
 132      }
 133  }
 134  
 135  /*
 136   * Query type checks.
 137   */
 138  
 139  /**
 140   * Determines whether the query is for an existing archive page.
 141   *
 142   * Archive pages include category, tag, author, date, custom post type,
 143   * and custom taxonomy based archives.
 144   *
 145   * For more information on this and similar theme functions, check out
 146   * the {@link https://developer.wordpress.org/themes/basics/conditional-tags/
 147   * Conditional Tags} article in the Theme Developer Handbook.
 148   *
 149   * @since 1.5.0
 150   *
 151   * @see is_category()
 152   * @see is_tag()
 153   * @see is_author()
 154   * @see is_date()
 155   * @see is_post_type_archive()
 156   * @see is_tax()
 157   * @global WP_Query $wp_query WordPress Query object.
 158   *
 159   * @return bool Whether the query is for an existing archive page.
 160   */
 161  function is_archive() {
 162      global $wp_query;
 163  
 164      if ( ! isset( $wp_query ) ) {
 165          _doing_it_wrong( __FUNCTION__, __( 'Conditional query tags do not work before the query is run. Before then, they always return false.' ), '3.1.0' );
 166          return false;
 167      }
 168  
 169      return $wp_query->is_archive();
 170  }
 171  
 172  /**
 173   * Determines whether the query is for an existing post type archive page.
 174   *
 175   * For more information on this and similar theme functions, check out
 176   * the {@link https://developer.wordpress.org/themes/basics/conditional-tags/
 177   * Conditional Tags} article in the Theme Developer Handbook.
 178   *
 179   * @since 3.1.0
 180   *
 181   * @global WP_Query $wp_query WordPress Query object.
 182   *
 183   * @param string|string[] $post_types Optional. Post type or array of posts types
 184   *                                    to check against. Default empty.
 185   * @return bool Whether the query is for an existing post type archive page.
 186   */
 187  function is_post_type_archive( $post_types = '' ) {
 188      global $wp_query;
 189  
 190      if ( ! isset( $wp_query ) ) {
 191          _doing_it_wrong( __FUNCTION__, __( 'Conditional query tags do not work before the query is run. Before then, they always return false.' ), '3.1.0' );
 192          return false;
 193      }
 194  
 195      return $wp_query->is_post_type_archive( $post_types );
 196  }
 197  
 198  /**
 199   * Determines whether the query is for an existing attachment page.
 200   *
 201   * For more information on this and similar theme functions, check out
 202   * the {@link https://developer.wordpress.org/themes/basics/conditional-tags/
 203   * Conditional Tags} article in the Theme Developer Handbook.
 204   *
 205   * @since 2.0.0
 206   *
 207   * @global WP_Query $wp_query WordPress Query object.
 208   *
 209   * @param int|string|int[]|string[] $attachment Optional. Attachment ID, title, slug, or array of such
 210   *                                              to check against. Default empty.
 211   * @return bool Whether the query is for an existing attachment page.
 212   */
 213  function is_attachment( $attachment = '' ) {
 214      global $wp_query;
 215  
 216      if ( ! isset( $wp_query ) ) {
 217          _doing_it_wrong( __FUNCTION__, __( 'Conditional query tags do not work before the query is run. Before then, they always return false.' ), '3.1.0' );
 218          return false;
 219      }
 220  
 221      return $wp_query->is_attachment( $attachment );
 222  }
 223  
 224  /**
 225   * Determines whether the query is for an existing author archive page.
 226   *
 227   * If the $author parameter is specified, this function will additionally
 228   * check if the query is for one of the authors specified.
 229   *
 230   * For more information on this and similar theme functions, check out
 231   * the {@link https://developer.wordpress.org/themes/basics/conditional-tags/
 232   * Conditional Tags} article in the Theme Developer Handbook.
 233   *
 234   * @since 1.5.0
 235   *
 236   * @global WP_Query $wp_query WordPress Query object.
 237   *
 238   * @param int|string|int[]|string[] $author Optional. User ID, nickname, nicename, or array of such
 239   *                                          to check against. Default empty.
 240   * @return bool Whether the query is for an existing author archive page.
 241   */
 242  function is_author( $author = '' ) {
 243      global $wp_query;
 244  
 245      if ( ! isset( $wp_query ) ) {
 246          _doing_it_wrong( __FUNCTION__, __( 'Conditional query tags do not work before the query is run. Before then, they always return false.' ), '3.1.0' );
 247          return false;
 248      }
 249  
 250      return $wp_query->is_author( $author );
 251  }
 252  
 253  /**
 254   * Determines whether the query is for an existing category archive page.
 255   *
 256   * If the $category parameter is specified, this function will additionally
 257   * check if the query is for one of the categories specified.
 258   *
 259   * For more information on this and similar theme functions, check out
 260   * the {@link https://developer.wordpress.org/themes/basics/conditional-tags/
 261   * Conditional Tags} article in the Theme Developer Handbook.
 262   *
 263   * @since 1.5.0
 264   *
 265   * @global WP_Query $wp_query WordPress Query object.
 266   *
 267   * @param int|string|int[]|string[] $category Optional. Category ID, name, slug, or array of such
 268   *                                            to check against. Default empty.
 269   * @return bool Whether the query is for an existing category archive page.
 270   */
 271  function is_category( $category = '' ) {
 272      global $wp_query;
 273  
 274      if ( ! isset( $wp_query ) ) {
 275          _doing_it_wrong( __FUNCTION__, __( 'Conditional query tags do not work before the query is run. Before then, they always return false.' ), '3.1.0' );
 276          return false;
 277      }
 278  
 279      return $wp_query->is_category( $category );
 280  }
 281  
 282  /**
 283   * Determines whether the query is for an existing tag archive page.
 284   *
 285   * If the $tag parameter is specified, this function will additionally
 286   * check if the query is for one of the tags specified.
 287   *
 288   * For more information on this and similar theme functions, check out
 289   * the {@link https://developer.wordpress.org/themes/basics/conditional-tags/
 290   * Conditional Tags} article in the Theme Developer Handbook.
 291   *
 292   * @since 2.3.0
 293   *
 294   * @global WP_Query $wp_query WordPress Query object.
 295   *
 296   * @param int|string|int[]|string[] $tag Optional. Tag ID, name, slug, or array of such
 297   *                                       to check against. Default empty.
 298   * @return bool Whether the query is for an existing tag archive page.
 299   */
 300  function is_tag( $tag = '' ) {
 301      global $wp_query;
 302  
 303      if ( ! isset( $wp_query ) ) {
 304          _doing_it_wrong( __FUNCTION__, __( 'Conditional query tags do not work before the query is run. Before then, they always return false.' ), '3.1.0' );
 305          return false;
 306      }
 307  
 308      return $wp_query->is_tag( $tag );
 309  }
 310  
 311  /**
 312   * Determines whether the query is for an existing custom taxonomy archive page.
 313   *
 314   * If the $taxonomy parameter is specified, this function will additionally
 315   * check if the query is for that specific $taxonomy.
 316   *
 317   * If the $term parameter is specified in addition to the $taxonomy parameter,
 318   * this function will additionally check if the query is for one of the terms
 319   * specified.
 320   *
 321   * For more information on this and similar theme functions, check out
 322   * the {@link https://developer.wordpress.org/themes/basics/conditional-tags/
 323   * Conditional Tags} article in the Theme Developer Handbook.
 324   *
 325   * @since 2.5.0
 326   *
 327   * @global WP_Query $wp_query WordPress Query object.
 328   *
 329   * @param string|string[]           $taxonomy Optional. Taxonomy slug or slugs to check against.
 330   *                                            Default empty.
 331   * @param int|string|int[]|string[] $term     Optional. Term ID, name, slug, or array of such
 332   *                                            to check against. Default empty.
 333   * @return bool Whether the query is for an existing custom taxonomy archive page.
 334   *              True for custom taxonomy archive pages, false for built-in taxonomies
 335   *              (category and tag archives).
 336   */
 337  function is_tax( $taxonomy = '', $term = '' ) {
 338      global $wp_query;
 339  
 340      if ( ! isset( $wp_query ) ) {
 341          _doing_it_wrong( __FUNCTION__, __( 'Conditional query tags do not work before the query is run. Before then, they always return false.' ), '3.1.0' );
 342          return false;
 343      }
 344  
 345      return $wp_query->is_tax( $taxonomy, $term );
 346  }
 347  
 348  /**
 349   * Determines whether the query is for an existing date archive.
 350   *
 351   * For more information on this and similar theme functions, check out
 352   * the {@link https://developer.wordpress.org/themes/basics/conditional-tags/
 353   * Conditional Tags} article in the Theme Developer Handbook.
 354   *
 355   * @since 1.5.0
 356   *
 357   * @global WP_Query $wp_query WordPress Query object.
 358   *
 359   * @return bool Whether the query is for an existing date archive.
 360   */
 361  function is_date() {
 362      global $wp_query;
 363  
 364      if ( ! isset( $wp_query ) ) {
 365          _doing_it_wrong( __FUNCTION__, __( 'Conditional query tags do not work before the query is run. Before then, they always return false.' ), '3.1.0' );
 366          return false;
 367      }
 368  
 369      return $wp_query->is_date();
 370  }
 371  
 372  /**
 373   * Determines whether the query is for an existing day archive.
 374   *
 375   * A conditional check to test whether the page is a date-based archive page displaying posts for the current day.
 376   *
 377   * For more information on this and similar theme functions, check out
 378   * the {@link https://developer.wordpress.org/themes/basics/conditional-tags/
 379   * Conditional Tags} article in the Theme Developer Handbook.
 380   *
 381   * @since 1.5.0
 382   *
 383   * @global WP_Query $wp_query WordPress Query object.
 384   *
 385   * @return bool Whether the query is for an existing day archive.
 386   */
 387  function is_day() {
 388      global $wp_query;
 389  
 390      if ( ! isset( $wp_query ) ) {
 391          _doing_it_wrong( __FUNCTION__, __( 'Conditional query tags do not work before the query is run. Before then, they always return false.' ), '3.1.0' );
 392          return false;
 393      }
 394  
 395      return $wp_query->is_day();
 396  }
 397  
 398  /**
 399   * Determines whether the query is for a feed.
 400   *
 401   * For more information on this and similar theme functions, check out
 402   * the {@link https://developer.wordpress.org/themes/basics/conditional-tags/
 403   * Conditional Tags} article in the Theme Developer Handbook.
 404   *
 405   * @since 1.5.0
 406   *
 407   * @global WP_Query $wp_query WordPress Query object.
 408   *
 409   * @param string|string[] $feeds Optional. Feed type or array of feed types
 410   *                                         to check against. Default empty.
 411   * @return bool Whether the query is for a feed.
 412   */
 413  function is_feed( $feeds = '' ) {
 414      global $wp_query;
 415  
 416      if ( ! isset( $wp_query ) ) {
 417          _doing_it_wrong( __FUNCTION__, __( 'Conditional query tags do not work before the query is run. Before then, they always return false.' ), '3.1.0' );
 418          return false;
 419      }
 420  
 421      return $wp_query->is_feed( $feeds );
 422  }
 423  
 424  /**
 425   * Is the query for a comments feed?
 426   *
 427   * @since 3.0.0
 428   *
 429   * @global WP_Query $wp_query WordPress Query object.
 430   *
 431   * @return bool Whether the query is for a comments feed.
 432   */
 433  function is_comment_feed() {
 434      global $wp_query;
 435  
 436      if ( ! isset( $wp_query ) ) {
 437          _doing_it_wrong( __FUNCTION__, __( 'Conditional query tags do not work before the query is run. Before then, they always return false.' ), '3.1.0' );
 438          return false;
 439      }
 440  
 441      return $wp_query->is_comment_feed();
 442  }
 443  
 444  /**
 445   * Determines whether the query is for the front page of the site.
 446   *
 447   * This is for what is displayed at your site's main URL.
 448   *
 449   * Depends on the site's "Front page displays" Reading Settings 'show_on_front' and 'page_on_front'.
 450   *
 451   * If you set a static page for the front page of your site, this function will return
 452   * true when viewing that page.
 453   *
 454   * Otherwise the same as {@see is_home()}.
 455   *
 456   * For more information on this and similar theme functions, check out
 457   * the {@link https://developer.wordpress.org/themes/basics/conditional-tags/
 458   * Conditional Tags} article in the Theme Developer Handbook.
 459   *
 460   * @since 2.5.0
 461   *
 462   * @global WP_Query $wp_query WordPress Query object.
 463   *
 464   * @return bool Whether the query is for the front page of the site.
 465   */
 466  function is_front_page() {
 467      global $wp_query;
 468  
 469      if ( ! isset( $wp_query ) ) {
 470          _doing_it_wrong( __FUNCTION__, __( 'Conditional query tags do not work before the query is run. Before then, they always return false.' ), '3.1.0' );
 471          return false;
 472      }
 473  
 474      return $wp_query->is_front_page();
 475  }
 476  
 477  /**
 478   * Determines whether the query is for the blog homepage.
 479   *
 480   * The blog homepage is the page that shows the time-based blog content of the site.
 481   *
 482   * is_home() is dependent on the site's "Front page displays" Reading Settings 'show_on_front'
 483   * and 'page_for_posts'.
 484   *
 485   * If a static page is set for the front page of the site, this function will return true only
 486   * on the page you set as the "Posts page".
 487   *
 488   * For more information on this and similar theme functions, check out
 489   * the {@link https://developer.wordpress.org/themes/basics/conditional-tags/
 490   * Conditional Tags} article in the Theme Developer Handbook.
 491   *
 492   * @since 1.5.0
 493   *
 494   * @see is_front_page()
 495   * @global WP_Query $wp_query WordPress Query object.
 496   *
 497   * @return bool Whether the query is for the blog homepage.
 498   */
 499  function is_home() {
 500      global $wp_query;
 501  
 502      if ( ! isset( $wp_query ) ) {
 503          _doing_it_wrong( __FUNCTION__, __( 'Conditional query tags do not work before the query is run. Before then, they always return false.' ), '3.1.0' );
 504          return false;
 505      }
 506  
 507      return $wp_query->is_home();
 508  }
 509  
 510  /**
 511   * Determines whether the query is for the Privacy Policy page.
 512   *
 513   * The Privacy Policy page is the page that shows the Privacy Policy content of the site.
 514   *
 515   * is_privacy_policy() is dependent on the site's "Change your Privacy Policy page" Privacy Settings 'wp_page_for_privacy_policy'.
 516   *
 517   * This function will return true only on the page you set as the "Privacy Policy page".
 518   *
 519   * For more information on this and similar theme functions, check out
 520   * the {@link https://developer.wordpress.org/themes/basics/conditional-tags/
 521   * Conditional Tags} article in the Theme Developer Handbook.
 522   *
 523   * @since 5.2.0
 524   *
 525   * @global WP_Query $wp_query WordPress Query object.
 526   *
 527   * @return bool Whether the query is for the Privacy Policy page.
 528   */
 529  function is_privacy_policy() {
 530      global $wp_query;
 531  
 532      if ( ! isset( $wp_query ) ) {
 533          _doing_it_wrong( __FUNCTION__, __( 'Conditional query tags do not work before the query is run. Before then, they always return false.' ), '3.1.0' );
 534          return false;
 535      }
 536  
 537      return $wp_query->is_privacy_policy();
 538  }
 539  
 540  /**
 541   * Determines whether the query is for an existing month archive.
 542   *
 543   * For more information on this and similar theme functions, check out
 544   * the {@link https://developer.wordpress.org/themes/basics/conditional-tags/
 545   * Conditional Tags} article in the Theme Developer Handbook.
 546   *
 547   * @since 1.5.0
 548   *
 549   * @global WP_Query $wp_query WordPress Query object.
 550   *
 551   * @return bool Whether the query is for an existing month archive.
 552   */
 553  function is_month() {
 554      global $wp_query;
 555  
 556      if ( ! isset( $wp_query ) ) {
 557          _doing_it_wrong( __FUNCTION__, __( 'Conditional query tags do not work before the query is run. Before then, they always return false.' ), '3.1.0' );
 558          return false;
 559      }
 560  
 561      return $wp_query->is_month();
 562  }
 563  
 564  /**
 565   * Determines whether the query is for an existing single page.
 566   *
 567   * If the $page parameter is specified, this function will additionally
 568   * check if the query is for one of the pages specified.
 569   *
 570   * For more information on this and similar theme functions, check out
 571   * the {@link https://developer.wordpress.org/themes/basics/conditional-tags/
 572   * Conditional Tags} article in the Theme Developer Handbook.
 573   *
 574   * @since 1.5.0
 575   *
 576   * @see is_single()
 577   * @see is_singular()
 578   * @global WP_Query $wp_query WordPress Query object.
 579   *
 580   * @param int|string|int[]|string[] $page Optional. Page ID, title, slug, or array of such
 581   *                                        to check against. Default empty.
 582   * @return bool Whether the query is for an existing single page.
 583   */
 584  function is_page( $page = '' ) {
 585      global $wp_query;
 586  
 587      if ( ! isset( $wp_query ) ) {
 588          _doing_it_wrong( __FUNCTION__, __( 'Conditional query tags do not work before the query is run. Before then, they always return false.' ), '3.1.0' );
 589          return false;
 590      }
 591  
 592      return $wp_query->is_page( $page );
 593  }
 594  
 595  /**
 596   * Determines whether the query is for a paged result and not for the first page.
 597   *
 598   * For more information on this and similar theme functions, check out
 599   * the {@link https://developer.wordpress.org/themes/basics/conditional-tags/
 600   * Conditional Tags} article in the Theme Developer Handbook.
 601   *
 602   * @since 1.5.0
 603   *
 604   * @global WP_Query $wp_query WordPress Query object.
 605   *
 606   * @return bool Whether the query is for a paged result.
 607   */
 608  function is_paged() {
 609      global $wp_query;
 610  
 611      if ( ! isset( $wp_query ) ) {
 612          _doing_it_wrong( __FUNCTION__, __( 'Conditional query tags do not work before the query is run. Before then, they always return false.' ), '3.1.0' );
 613          return false;
 614      }
 615  
 616      return $wp_query->is_paged();
 617  }
 618  
 619  /**
 620   * Determines whether the query is for a post or page preview.
 621   *
 622   * For more information on this and similar theme functions, check out
 623   * the {@link https://developer.wordpress.org/themes/basics/conditional-tags/
 624   * Conditional Tags} article in the Theme Developer Handbook.
 625   *
 626   * @since 2.0.0
 627   *
 628   * @global WP_Query $wp_query WordPress Query object.
 629   *
 630   * @return bool Whether the query is for a post or page preview.
 631   */
 632  function is_preview() {
 633      global $wp_query;
 634  
 635      if ( ! isset( $wp_query ) ) {
 636          _doing_it_wrong( __FUNCTION__, __( 'Conditional query tags do not work before the query is run. Before then, they always return false.' ), '3.1.0' );
 637          return false;
 638      }
 639  
 640      return $wp_query->is_preview();
 641  }
 642  
 643  /**
 644   * Is the query for the robots.txt file?
 645   *
 646   * @since 2.1.0
 647   *
 648   * @global WP_Query $wp_query WordPress Query object.
 649   *
 650   * @return bool Whether the query is for the robots.txt file.
 651   */
 652  function is_robots() {
 653      global $wp_query;
 654  
 655      if ( ! isset( $wp_query ) ) {
 656          _doing_it_wrong( __FUNCTION__, __( 'Conditional query tags do not work before the query is run. Before then, they always return false.' ), '3.1.0' );
 657          return false;
 658      }
 659  
 660      return $wp_query->is_robots();
 661  }
 662  
 663  /**
 664   * Is the query for the favicon.ico file?
 665   *
 666   * @since 5.4.0
 667   *
 668   * @global WP_Query $wp_query WordPress Query object.
 669   *
 670   * @return bool Whether the query is for the favicon.ico file.
 671   */
 672  function is_favicon() {
 673      global $wp_query;
 674  
 675      if ( ! isset( $wp_query ) ) {
 676          _doing_it_wrong( __FUNCTION__, __( 'Conditional query tags do not work before the query is run. Before then, they always return false.' ), '3.1.0' );
 677          return false;
 678      }
 679  
 680      return $wp_query->is_favicon();
 681  }
 682  
 683  /**
 684   * Is the query for a sitemap?
 685   *
 686   * @since 7.1.0
 687   *
 688   * @global WP_Query $wp_query WordPress Query object.
 689   *
 690   * @return bool Whether the query is for a sitemap.
 691   */
 692  function is_sitemap(): bool {
 693      global $wp_query;
 694  
 695      if ( ! isset( $wp_query ) ) {
 696          _doing_it_wrong( __FUNCTION__, __( 'Conditional query tags do not work before the query is run. Before then, they always return false.' ), '7.1.0' );
 697          return false;
 698      }
 699  
 700      return $wp_query->is_sitemap();
 701  }
 702  
 703  /**
 704   * Determines whether the query is for a search.
 705   *
 706   * For more information on this and similar theme functions, check out
 707   * the {@link https://developer.wordpress.org/themes/basics/conditional-tags/
 708   * Conditional Tags} article in the Theme Developer Handbook.
 709   *
 710   * @since 1.5.0
 711   *
 712   * @global WP_Query $wp_query WordPress Query object.
 713   *
 714   * @return bool Whether the query is for a search.
 715   */
 716  function is_search() {
 717      global $wp_query;
 718  
 719      if ( ! isset( $wp_query ) ) {
 720          _doing_it_wrong( __FUNCTION__, __( 'Conditional query tags do not work before the query is run. Before then, they always return false.' ), '3.1.0' );
 721          return false;
 722      }
 723  
 724      return $wp_query->is_search();
 725  }
 726  
 727  /**
 728   * Determines whether the query is for an existing single post.
 729   *
 730   * Works for any post type, except attachments and pages
 731   *
 732   * If the $post parameter is specified, this function will additionally
 733   * check if the query is for one of the Posts specified.
 734   *
 735   * For more information on this and similar theme functions, check out
 736   * the {@link https://developer.wordpress.org/themes/basics/conditional-tags/
 737   * Conditional Tags} article in the Theme Developer Handbook.
 738   *
 739   * @since 1.5.0
 740   *
 741   * @see is_page()
 742   * @see is_singular()
 743   * @global WP_Query $wp_query WordPress Query object.
 744   *
 745   * @param int|string|int[]|string[] $post Optional. Post ID, title, slug, or array of such
 746   *                                        to check against. Default empty.
 747   * @return bool Whether the query is for an existing single post.
 748   */
 749  function is_single( $post = '' ) {
 750      global $wp_query;
 751  
 752      if ( ! isset( $wp_query ) ) {
 753          _doing_it_wrong( __FUNCTION__, __( 'Conditional query tags do not work before the query is run. Before then, they always return false.' ), '3.1.0' );
 754          return false;
 755      }
 756  
 757      return $wp_query->is_single( $post );
 758  }
 759  
 760  /**
 761   * Determines whether the query is for an existing single post of any post type
 762   * (post, attachment, page, custom post types).
 763   *
 764   * If the $post_types parameter is specified, this function will additionally
 765   * check if the query is for one of the Posts Types specified.
 766   *
 767   * For more information on this and similar theme functions, check out
 768   * the {@link https://developer.wordpress.org/themes/basics/conditional-tags/
 769   * Conditional Tags} article in the Theme Developer Handbook.
 770   *
 771   * @since 1.5.0
 772   *
 773   * @see is_page()
 774   * @see is_single()
 775   * @global WP_Query $wp_query WordPress Query object.
 776   *
 777   * @param string|string[] $post_types Optional. Post type or array of post types
 778   *                                    to check against. Default empty.
 779   * @return bool Whether the query is for an existing single post
 780   *              or any of the given post types.
 781   */
 782  function is_singular( $post_types = '' ) {
 783      global $wp_query;
 784  
 785      if ( ! isset( $wp_query ) ) {
 786          _doing_it_wrong( __FUNCTION__, __( 'Conditional query tags do not work before the query is run. Before then, they always return false.' ), '3.1.0' );
 787          return false;
 788      }
 789  
 790      return $wp_query->is_singular( $post_types );
 791  }
 792  
 793  /**
 794   * Determines whether the query is for a specific time.
 795   *
 796   * For more information on this and similar theme functions, check out
 797   * the {@link https://developer.wordpress.org/themes/basics/conditional-tags/
 798   * Conditional Tags} article in the Theme Developer Handbook.
 799   *
 800   * @since 1.5.0
 801   *
 802   * @global WP_Query $wp_query WordPress Query object.
 803   *
 804   * @return bool Whether the query is for a specific time.
 805   */
 806  function is_time() {
 807      global $wp_query;
 808  
 809      if ( ! isset( $wp_query ) ) {
 810          _doing_it_wrong( __FUNCTION__, __( 'Conditional query tags do not work before the query is run. Before then, they always return false.' ), '3.1.0' );
 811          return false;
 812      }
 813  
 814      return $wp_query->is_time();
 815  }
 816  
 817  /**
 818   * Determines whether the query is for a trackback endpoint call.
 819   *
 820   * For more information on this and similar theme functions, check out
 821   * the {@link https://developer.wordpress.org/themes/basics/conditional-tags/
 822   * Conditional Tags} article in the Theme Developer Handbook.
 823   *
 824   * @since 1.5.0
 825   *
 826   * @global WP_Query $wp_query WordPress Query object.
 827   *
 828   * @return bool Whether the query is for a trackback endpoint call.
 829   */
 830  function is_trackback() {
 831      global $wp_query;
 832  
 833      if ( ! isset( $wp_query ) ) {
 834          _doing_it_wrong( __FUNCTION__, __( 'Conditional query tags do not work before the query is run. Before then, they always return false.' ), '3.1.0' );
 835          return false;
 836      }
 837  
 838      return $wp_query->is_trackback();
 839  }
 840  
 841  /**
 842   * Determines whether the query is for an existing year archive.
 843   *
 844   * For more information on this and similar theme functions, check out
 845   * the {@link https://developer.wordpress.org/themes/basics/conditional-tags/
 846   * Conditional Tags} article in the Theme Developer Handbook.
 847   *
 848   * @since 1.5.0
 849   *
 850   * @global WP_Query $wp_query WordPress Query object.
 851   *
 852   * @return bool Whether the query is for an existing year archive.
 853   */
 854  function is_year() {
 855      global $wp_query;
 856  
 857      if ( ! isset( $wp_query ) ) {
 858          _doing_it_wrong( __FUNCTION__, __( 'Conditional query tags do not work before the query is run. Before then, they always return false.' ), '3.1.0' );
 859          return false;
 860      }
 861  
 862      return $wp_query->is_year();
 863  }
 864  
 865  /**
 866   * Determines whether the query has resulted in a 404 (returns no results).
 867   *
 868   * For more information on this and similar theme functions, check out
 869   * the {@link https://developer.wordpress.org/themes/basics/conditional-tags/
 870   * Conditional Tags} article in the Theme Developer Handbook.
 871   *
 872   * @since 1.5.0
 873   *
 874   * @global WP_Query $wp_query WordPress Query object.
 875   *
 876   * @return bool Whether the query is a 404 error.
 877   */
 878  function is_404() {
 879      global $wp_query;
 880  
 881      if ( ! isset( $wp_query ) ) {
 882          _doing_it_wrong( __FUNCTION__, __( 'Conditional query tags do not work before the query is run. Before then, they always return false.' ), '3.1.0' );
 883          return false;
 884      }
 885  
 886      return $wp_query->is_404();
 887  }
 888  
 889  /**
 890   * Is the query for an embedded post?
 891   *
 892   * @since 4.4.0
 893   *
 894   * @global WP_Query $wp_query WordPress Query object.
 895   *
 896   * @return bool Whether the query is for an embedded post.
 897   */
 898  function is_embed() {
 899      global $wp_query;
 900  
 901      if ( ! isset( $wp_query ) ) {
 902          _doing_it_wrong( __FUNCTION__, __( 'Conditional query tags do not work before the query is run. Before then, they always return false.' ), '3.1.0' );
 903          return false;
 904      }
 905  
 906      return $wp_query->is_embed();
 907  }
 908  
 909  /**
 910   * Determines whether the query is the main query.
 911   *
 912   * For more information on this and similar theme functions, check out
 913   * the {@link https://developer.wordpress.org/themes/basics/conditional-tags/
 914   * Conditional Tags} article in the Theme Developer Handbook.
 915   *
 916   * @since 3.3.0
 917   *
 918   * @global WP_Query $wp_query WordPress Query object.
 919   *
 920   * @return bool Whether the query is the main query.
 921   */
 922  function is_main_query() {
 923      global $wp_query;
 924  
 925      if ( ! isset( $wp_query ) ) {
 926          _doing_it_wrong( __FUNCTION__, __( 'Conditional query tags do not work before the query is run. Before then, they always return false.' ), '6.1.0' );
 927          return false;
 928      }
 929  
 930      if ( 'pre_get_posts' === current_filter() ) {
 931          _doing_it_wrong(
 932              __FUNCTION__,
 933              sprintf(
 934                  /* translators: 1: pre_get_posts, 2: WP_Query->is_main_query(), 3: is_main_query(), 4: Documentation URL. */
 935                  __( 'In %1$s, use the %2$s method, not the %3$s function. See %4$s.' ),
 936                  '<code>pre_get_posts</code>',
 937                  '<code>WP_Query->is_main_query()</code>',
 938                  '<code>is_main_query()</code>',
 939                  __( 'https://developer.wordpress.org/reference/functions/is_main_query/' )
 940              ),
 941              '3.7.0'
 942          );
 943      }
 944  
 945      return $wp_query->is_main_query();
 946  }
 947  
 948  /*
 949   * The Loop. Post loop control.
 950   */
 951  
 952  /**
 953   * Determines whether current WordPress query has posts to loop over.
 954   *
 955   * @since 1.5.0
 956   *
 957   * @global WP_Query $wp_query WordPress Query object.
 958   *
 959   * @return bool True if posts are available, false if end of the loop.
 960   */
 961  function have_posts() {
 962      global $wp_query;
 963  
 964      if ( ! isset( $wp_query ) ) {
 965          return false;
 966      }
 967  
 968      return $wp_query->have_posts();
 969  }
 970  
 971  /**
 972   * Determines whether the caller is in the Loop.
 973   *
 974   * For more information on this and similar theme functions, check out
 975   * the {@link https://developer.wordpress.org/themes/basics/conditional-tags/
 976   * Conditional Tags} article in the Theme Developer Handbook.
 977   *
 978   * @since 2.0.0
 979   *
 980   * @global WP_Query $wp_query WordPress Query object.
 981   *
 982   * @return bool True if caller is within loop, false if loop hasn't started or ended.
 983   */
 984  function in_the_loop() {
 985      global $wp_query;
 986  
 987      if ( ! isset( $wp_query ) ) {
 988          return false;
 989      }
 990  
 991      return $wp_query->in_the_loop;
 992  }
 993  
 994  /**
 995   * Rewind the loop posts.
 996   *
 997   * @since 1.5.0
 998   *
 999   * @global WP_Query $wp_query WordPress Query object.
1000   */
1001  function rewind_posts() {
1002      global $wp_query;
1003  
1004      if ( ! isset( $wp_query ) ) {
1005          return;
1006      }
1007  
1008      $wp_query->rewind_posts();
1009  }
1010  
1011  /**
1012   * Iterate the post index in the loop.
1013   *
1014   * @since 1.5.0
1015   *
1016   * @global WP_Query $wp_query WordPress Query object.
1017   */
1018  function the_post() {
1019      global $wp_query;
1020  
1021      if ( ! isset( $wp_query ) ) {
1022          return;
1023      }
1024  
1025      $wp_query->the_post();
1026  }
1027  
1028  /*
1029   * Comments loop.
1030   */
1031  
1032  /**
1033   * Determines whether current WordPress query has comments to loop over.
1034   *
1035   * @since 2.2.0
1036   *
1037   * @global WP_Query $wp_query WordPress Query object.
1038   *
1039   * @return bool True if comments are available, false if no more comments.
1040   */
1041  function have_comments() {
1042      global $wp_query;
1043  
1044      if ( ! isset( $wp_query ) ) {
1045          return false;
1046      }
1047  
1048      return $wp_query->have_comments();
1049  }
1050  
1051  /**
1052   * Iterate comment index in the comment loop.
1053   *
1054   * @since 2.2.0
1055   *
1056   * @global WP_Query $wp_query WordPress Query object.
1057   */
1058  function the_comment() {
1059      global $wp_query;
1060  
1061      if ( ! isset( $wp_query ) ) {
1062          return;
1063      }
1064  
1065      $wp_query->the_comment();
1066  }
1067  
1068  /**
1069   * Redirect old slugs to the correct permalink.
1070   *
1071   * Attempts to find the current slug from the past slugs.
1072   *
1073   * @since 2.1.0
1074   */
1075  function wp_old_slug_redirect() {
1076      if ( is_404() && '' !== get_query_var( 'name' ) ) {
1077          // Guess the current post type based on the query vars.
1078          if ( get_query_var( 'post_type' ) ) {
1079              $post_type = get_query_var( 'post_type' );
1080          } elseif ( get_query_var( 'attachment' ) ) {
1081              $post_type = 'attachment';
1082          } elseif ( get_query_var( 'pagename' ) ) {
1083              $post_type = 'page';
1084          } else {
1085              $post_type = 'post';
1086          }
1087  
1088          if ( is_array( $post_type ) ) {
1089              if ( count( $post_type ) > 1 ) {
1090                  return;
1091              }
1092              $post_type = reset( $post_type );
1093          }
1094  
1095          // Do not attempt redirect for hierarchical post types.
1096          if ( is_post_type_hierarchical( $post_type ) ) {
1097              return;
1098          }
1099  
1100          $id = _find_post_by_old_slug( $post_type );
1101  
1102          if ( ! $id ) {
1103              $id = _find_post_by_old_date( $post_type );
1104          }
1105  
1106          /**
1107           * Filters the old slug redirect post ID.
1108           *
1109           * @since 4.9.3
1110           *
1111           * @param int $id The redirect post ID.
1112           */
1113          $id = apply_filters( 'old_slug_redirect_post_id', $id );
1114  
1115          if ( ! $id ) {
1116              return;
1117          }
1118  
1119          $link = get_permalink( $id );
1120  
1121          if ( get_query_var( 'paged' ) > 1 ) {
1122              $link = user_trailingslashit( trailingslashit( $link ) . 'page/' . get_query_var( 'paged' ) );
1123          } elseif ( is_embed() ) {
1124              $link = user_trailingslashit( trailingslashit( $link ) . 'embed' );
1125          }
1126  
1127          /**
1128           * Filters the old slug redirect URL.
1129           *
1130           * @since 4.4.0
1131           *
1132           * @param string $link The redirect URL.
1133           */
1134          $link = apply_filters( 'old_slug_redirect_url', $link );
1135  
1136          if ( ! $link ) {
1137              return;
1138          }
1139  
1140          wp_redirect( $link, 301 ); // Permanent redirect.
1141          exit;
1142      }
1143  }
1144  
1145  /**
1146   * Find the post ID for redirecting an old slug.
1147   *
1148   * @since 4.9.3
1149   * @access private
1150   *
1151   * @see wp_old_slug_redirect()
1152   * @global wpdb $wpdb WordPress database abstraction object.
1153   *
1154   * @param string $post_type The current post type based on the query vars.
1155   * @return int The Post ID.
1156   */
1157  function _find_post_by_old_slug( $post_type ) {
1158      global $wpdb;
1159  
1160      $query = $wpdb->prepare( "SELECT post_id FROM $wpdb->postmeta, $wpdb->posts WHERE ID = post_id AND post_type = %s AND meta_key = '_wp_old_slug' AND meta_value = %s", $post_type, get_query_var( 'name' ) );
1161  
1162      /*
1163       * If year, monthnum, or day have been specified, make our query more precise
1164       * just in case there are multiple identical _wp_old_slug values.
1165       */
1166      if ( get_query_var( 'year' ) ) {
1167          $query .= $wpdb->prepare( ' AND YEAR(post_date) = %d', get_query_var( 'year' ) );
1168      }
1169      if ( get_query_var( 'monthnum' ) ) {
1170          $query .= $wpdb->prepare( ' AND MONTH(post_date) = %d', get_query_var( 'monthnum' ) );
1171      }
1172      if ( get_query_var( 'day' ) ) {
1173          $query .= $wpdb->prepare( ' AND DAYOFMONTH(post_date) = %d', get_query_var( 'day' ) );
1174      }
1175  
1176      $key          = md5( $query );
1177      $last_changed = wp_cache_get_last_changed( 'posts' );
1178      $cache_key    = "find_post_by_old_slug:$key";
1179      $cache        = wp_cache_get_salted( $cache_key, 'post-queries', $last_changed );
1180      if ( false !== $cache ) {
1181          $id = $cache;
1182      } else {
1183          $id = (int) $wpdb->get_var( $query );
1184          wp_cache_set_salted( $cache_key, $id, 'post-queries', $last_changed );
1185      }
1186  
1187      return $id;
1188  }
1189  
1190  /**
1191   * Find the post ID for redirecting an old date.
1192   *
1193   * @since 4.9.3
1194   * @access private
1195   *
1196   * @see wp_old_slug_redirect()
1197   * @global wpdb $wpdb WordPress database abstraction object.
1198   *
1199   * @param string $post_type The current post type based on the query vars.
1200   * @return int The Post ID.
1201   */
1202  function _find_post_by_old_date( $post_type ) {
1203      global $wpdb;
1204  
1205      $date_query = '';
1206      if ( get_query_var( 'year' ) ) {
1207          $date_query .= $wpdb->prepare( ' AND YEAR(pm_date.meta_value) = %d', get_query_var( 'year' ) );
1208      }
1209      if ( get_query_var( 'monthnum' ) ) {
1210          $date_query .= $wpdb->prepare( ' AND MONTH(pm_date.meta_value) = %d', get_query_var( 'monthnum' ) );
1211      }
1212      if ( get_query_var( 'day' ) ) {
1213          $date_query .= $wpdb->prepare( ' AND DAYOFMONTH(pm_date.meta_value) = %d', get_query_var( 'day' ) );
1214      }
1215  
1216      $id = 0;
1217      if ( $date_query ) {
1218          $query        = $wpdb->prepare( "SELECT post_id FROM $wpdb->postmeta AS pm_date, $wpdb->posts WHERE ID = post_id AND post_type = %s AND meta_key = '_wp_old_date' AND post_name = %s" . $date_query, $post_type, get_query_var( 'name' ) );
1219          $key          = md5( $query );
1220          $last_changed = wp_cache_get_last_changed( 'posts' );
1221          $cache_key    = "find_post_by_old_date:$key";
1222          $cache        = wp_cache_get_salted( $cache_key, 'post-queries', $last_changed );
1223          if ( false !== $cache ) {
1224              $id = $cache;
1225          } else {
1226              $id = (int) $wpdb->get_var( $query );
1227              if ( ! $id ) {
1228                  // Check to see if an old slug matches the old date.
1229                  $id = (int) $wpdb->get_var( $wpdb->prepare( "SELECT ID FROM $wpdb->posts, $wpdb->postmeta AS pm_slug, $wpdb->postmeta AS pm_date WHERE ID = pm_slug.post_id AND ID = pm_date.post_id AND post_type = %s AND pm_slug.meta_key = '_wp_old_slug' AND pm_slug.meta_value = %s AND pm_date.meta_key = '_wp_old_date'" . $date_query, $post_type, get_query_var( 'name' ) ) );
1230              }
1231              wp_cache_set_salted( $cache_key, $id, 'post-queries', $last_changed );
1232          }
1233      }
1234  
1235      return $id;
1236  }
1237  
1238  /**
1239   * Set up global post data.
1240   *
1241   * @since 1.5.0
1242   * @since 4.4.0 Added the ability to pass a post ID to `$post`.
1243   *
1244   * @global WP_Query $wp_query WordPress Query object.
1245   *
1246   * @param WP_Post|object|int $post WP_Post instance or Post ID/object.
1247   * @return bool True when finished.
1248   */
1249  function setup_postdata( $post ) {
1250      global $wp_query;
1251  
1252      if ( ! empty( $wp_query ) && $wp_query instanceof WP_Query ) {
1253          return $wp_query->setup_postdata( $post );
1254      }
1255  
1256      return false;
1257  }
1258  
1259  /**
1260   * Generates post data.
1261   *
1262   * @since 5.2.0
1263   *
1264   * @global WP_Query $wp_query WordPress Query object.
1265   *
1266   * @param WP_Post|object|int $post WP_Post instance or Post ID/object.
1267   * @return array|false Elements of post, or false on failure.
1268   */
1269  function generate_postdata( $post ) {
1270      global $wp_query;
1271  
1272      if ( ! empty( $wp_query ) && $wp_query instanceof WP_Query ) {
1273          return $wp_query->generate_postdata( $post );
1274      }
1275  
1276      return false;
1277  }