CoreFiles by mySites.guru
query.php1,973 lines, 62,032 bytes, from wordpress-7.2-RC1.zip
Raw History Compare with 7.1.1-RC1
md5
43fc37bd2a6593dc4dbe577da35d598a
sha1
cf18ced5fc31c7e77266baa7a4ce5c665be31b43
sha256
e0a5e826b4db06af3cc52f064c9cf84a6d8eee54313bbf73f7934d73baf4d9d0
12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576777879808182838485868788899091929394959697989910010110210310410510610710810911011111211311411511611711811912012112212312412512612712812913013113213313413513613713813914014114214314414514614714814915015115215315415515615715815916016116216316416516616716816917017117217317417517617717817918018118218318418518618718818919019119219319419519619719819920020120220320420520620720820921021121221321421521621721821922022122222322422522622722822923023123223323423523623723823924024124224324424524624724824925025125225325425525625725825926026126226326426526626726826927027127227327427527627727827928028128228328428528628728828929029129229329429529629729829930030130230330430530630730830931031131231331431531631731831932032132232332432532632732832933033133233333433533633733833934034134234334434534634734834935035135235335435535635735835936036136236336436536636736836937037137237337437537637737837938038138238338438538638738838939039139239339439539639739839940040140240340440540640740840941041141241341441541641741841942042142242342442542642742842943043143243343443543643743843944044144244344444544644744844945045145245345445545645745845946046146246346446546646746846947047147247347447547647747847948048148248348448548648748848949049149249349449549649749849950050150250350450550650750850951051151251351451551651751851952052152252352452552652752852953053153253353453553653753853954054154254354454554654754854955055155255355455555655755855956056156256356456556656756856957057157257357457557657757857958058158258358458558658758858959059159259359459559659759859960060160260360460560660760860961061161261361461561661761861962062162262362462562662762862963063163263363463563663763863964064164264364464564664764864965065165265365465565665765865966066166266366466566666766866967067167267367467567667767867968068168268368468568668768868969069169269369469569669769869970070170270370470570670770870971071171271371471571671771871972072172272372472572672772872973073173273373473573673773873974074174274374474574674774874975075175275375475575675775875976076176276376476576676776876977077177277377477577677777877978078178278378478578678778878979079179279379479579679779879980080180280380480580680780880981081181281381481581681781881982082182282382482582682782882983083183283383483583683783883984084184284384484584684784884985085185285385485585685785885986086186286386486586686786886987087187287387487587687787887988088188288388488588688788888989089189289389489589689789889990090190290390490590690790890991091191291391491591691791891992092192292392492592692792892993093193293393493593693793893994094194294394494594694794894995095195295395495595695795895996096196296396496596696796896997097197297397497597697797897998098198298398498598698798898999099199299399499599699799899910001001100210031004100510061007100810091010101110121013101410151016101710181019102010211022102310241025102610271028102910301031103210331034103510361037103810391040104110421043104410451046104710481049105010511052105310541055105610571058105910601061106210631064106510661067106810691070107110721073107410751076107710781079108010811082108310841085108610871088108910901091109210931094109510961097109810991100110111021103110411051106110711081109111011111112111311141115111611171118111911201121112211231124112511261127112811291130113111321133113411351136113711381139114011411142114311441145114611471148114911501151115211531154115511561157115811591160116111621163116411651166116711681169117011711172117311741175117611771178117911801181118211831184118511861187118811891190119111921193119411951196119711981199120012011202120312041205120612071208120912101211121212131214121512161217121812191220122112221223122412251226122712281229123012311232123312341235123612371238123912401241124212431244124512461247124812491250125112521253125412551256125712581259126012611262126312641265126612671268126912701271127212731274127512761277127812791280128112821283128412851286128712881289129012911292129312941295129612971298129913001301130213031304130513061307130813091310131113121313131413151316131713181319132013211322132313241325132613271328132913301331133213331334133513361337133813391340134113421343134413451346134713481349135013511352135313541355135613571358135913601361136213631364136513661367136813691370137113721373137413751376137713781379138013811382138313841385138613871388138913901391139213931394139513961397139813991400140114021403140414051406140714081409141014111412141314141415141614171418141914201421142214231424142514261427142814291430143114321433143414351436143714381439144014411442144314441445144614471448144914501451145214531454145514561457145814591460146114621463146414651466146714681469147014711472147314741475147614771478147914801481148214831484148514861487148814891490149114921493149414951496149714981499150015011502150315041505150615071508150915101511151215131514151515161517151815191520152115221523152415251526152715281529153015311532153315341535153615371538153915401541154215431544154515461547154815491550155115521553155415551556155715581559156015611562156315641565156615671568156915701571157215731574157515761577157815791580158115821583158415851586158715881589159015911592159315941595159615971598159916001601160216031604160516061607160816091610161116121613161416151616161716181619162016211622162316241625162616271628162916301631163216331634163516361637163816391640164116421643164416451646164716481649165016511652165316541655165616571658165916601661166216631664166516661667166816691670167116721673167416751676167716781679168016811682168316841685168616871688168916901691169216931694169516961697169816991700170117021703170417051706170717081709171017111712171317141715171617171718171917201721172217231724172517261727172817291730173117321733173417351736173717381739174017411742174317441745174617471748174917501751175217531754175517561757175817591760176117621763176417651766176717681769177017711772177317741775177617771778177917801781178217831784178517861787178817891790179117921793179417951796179717981799180018011802180318041805180618071808180918101811181218131814181518161817181818191820182118221823182418251826182718281829183018311832183318341835183618371838183918401841184218431844184518461847184818491850185118521853185418551856185718581859186018611862186318641865186618671868186918701871187218731874187518761877187818791880188118821883188418851886188718881889189018911892189318941895189618971898189919001901190219031904190519061907190819091910191119121913191419151916191719181919192019211922192319241925192619271928192919301931193219331934193519361937193819391940194119421943194419451946194719481949195019511952195319541955195619571958195919601961196219631964196519661967196819691970197119721973
<?php
/**
 * WordPress Query API
 *
 * The query API attempts to get which part of WordPress the user is on. It
 * also provides functionality for getting URL query information.
 *
 * @link https://developer.wordpress.org/themes/basics/the-loop/ More information on The Loop.
 *
 * @package WordPress
 * @subpackage Query
 */

/**
 * Retrieves the value of a query variable in the WP_Query class.
 *
 * @since 1.5.0
 * @since 3.9.0 The `$default_value` argument was introduced.
 *
 * @global WP_Query $wp_query WordPress Query object.
 *
 * @param string $query_var     The variable key to retrieve.
 * @param mixed  $default_value Optional. Value to return if the query variable is not set.
 *                              Default empty string.
 * @return mixed Contents of the query variable.
 */
function get_query_var( $query_var, $default_value = '' ) {
	global $wp_query;
	return $wp_query->get( $query_var, $default_value );
}

/**
 * Retrieves the currently queried object.
 *
 * Wrapper for WP_Query::get_queried_object().
 *
 * @since 3.1.0
 *
 * @global WP_Query $wp_query WordPress Query object.
 *
 * @return WP_Term|WP_Post_Type|WP_Post|WP_User|null The queried object.
 */
function get_queried_object() {
	global $wp_query;
	return $wp_query->get_queried_object();
}

/**
 * Retrieves the ID of the currently queried object.
 *
 * Wrapper for WP_Query::get_queried_object_id().
 *
 * @since 3.1.0
 *
 * @global WP_Query $wp_query WordPress Query object.
 *
 * @return int ID of the queried object.
 */
function get_queried_object_id() {
	global $wp_query;
	return $wp_query->get_queried_object_id();
}

/**
 * Sets the value of a query variable in the WP_Query class.
 *
 * @since 2.2.0
 *
 * @global WP_Query $wp_query WordPress Query object.
 *
 * @param string $query_var Query variable key.
 * @param mixed  $value     Query variable value.
 */
function set_query_var( $query_var, $value ) {
	global $wp_query;
	$wp_query->set( $query_var, $value );
}

/**
 * Sets up The Loop with query parameters.
 *
 * 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.
 *
 * @since 1.5.0
 *
 * @global WP_Query $wp_query WordPress Query object.
 *
 * @param array|string $query Array or string of WP_Query arguments.
 * @return WP_Post[]|int[] Array of post objects or post IDs.
 */
function query_posts( $query ) {
	$GLOBALS['wp_query'] = new WP_Query();
	return $GLOBALS['wp_query']->query( $query );
}

/**
 * Destroys the previous query and sets up a new query.
 *
 * This should be used after query_posts() and before another query_posts().
 * This will remove obscure bugs that occur when the previous WP_Query object
 * is not destroyed properly before another is set up.
 *
 * @since 2.3.0
 *
 * @global WP_Query $wp_query     WordPress Query object.
 * @global WP_Query $wp_the_query Copy of the global WP_Query instance created during wp_reset_query().
 */
function wp_reset_query() {
	$GLOBALS['wp_query'] = $GLOBALS['wp_the_query'];
	wp_reset_postdata();
}

/**
 * After looping through a separate query, this function restores
 * the $post global to the current post in the main query.
 *
 * @since 3.0.0
 *
 * @global WP_Query $wp_query WordPress Query object.
 */
function wp_reset_postdata() {
	global $wp_query;

	if ( isset( $wp_query ) ) {
		$wp_query->reset_postdata();
	}
}

/*
 * Query type checks.
 */

/**
 * Determines whether the query is for an existing archive page.
 *
 * Archive pages include category, tag, author, date, custom post type,
 * and custom taxonomy based archives.
 *
 * For more information on this and similar theme functions, check out
 * the {@link https://developer.wordpress.org/themes/basics/conditional-tags/
 * Conditional Tags} article in the Theme Developer Handbook.
 *
 * @since 1.5.0
 *
 * @see is_category()
 * @see is_tag()
 * @see is_author()
 * @see is_date()
 * @see is_post_type_archive()
 * @see is_tax()
 * @global WP_Query $wp_query WordPress Query object.
 *
 * @return bool Whether the query is for an existing archive page.
 */
function is_archive() {
	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.' ), '3.1.0' );
		return false;
	}

	return $wp_query->is_archive();
}

/**
 * Determines whether the query is for an existing post type archive page.
 *
 * For more information on this and similar theme functions, check out
 * the {@link https://developer.wordpress.org/themes/basics/conditional-tags/
 * Conditional Tags} article in the Theme Developer Handbook.
 *
 * @since 3.1.0
 *
 * @global WP_Query $wp_query WordPress Query object.
 *
 * @param string|string[] $post_types Optional. Post type or array of posts types
 *                                    to check against. Default empty.
 * @return bool Whether the query is for an existing post type archive page.
 */
function is_post_type_archive( $post_types = '' ) {
	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.' ), '3.1.0' );
		return false;
	}

	return $wp_query->is_post_type_archive( $post_types );
}

/**
 * Determines whether the query is for an existing attachment page.
 *
 * For more information on this and similar theme functions, check out
 * the {@link https://developer.wordpress.org/themes/basics/conditional-tags/
 * Conditional Tags} article in the Theme Developer Handbook.
 *
 * @since 2.0.0
 *
 * @global WP_Query $wp_query WordPress Query object.
 *
 * @param int|string|int[]|string[] $attachment Optional. Attachment ID, title, slug, or array of such
 *                                              to check against. Default empty.
 * @return bool Whether the query is for an existing attachment page.
 */
function is_attachment( $attachment = '' ) {
	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.' ), '3.1.0' );
		return false;
	}

	return $wp_query->is_attachment( $attachment );
}

/**
 * Determines whether the query is for an existing author archive page.
 *
 * If the $author parameter is specified, this function will additionally
 * check if the query is for one of the authors specified.
 *
 * For more information on this and similar theme functions, check out
 * the {@link https://developer.wordpress.org/themes/basics/conditional-tags/
 * Conditional Tags} article in the Theme Developer Handbook.
 *
 * @since 1.5.0
 *
 * @global WP_Query $wp_query WordPress Query object.
 *
 * @param int|string|int[]|string[] $author Optional. User ID, nickname, nicename, or array of such
 *                                          to check against. Default empty.
 * @return bool Whether the query is for an existing author archive page.
 */
function is_author( $author = '' ) {
	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.' ), '3.1.0' );
		return false;
	}

	return $wp_query->is_author( $author );
}

/**
 * Determines whether the query is for an existing category archive page.
 *
 * If the $category parameter is specified, this function will additionally
 * check if the query is for one of the categories specified.
 *
 * For more information on this and similar theme functions, check out
 * the {@link https://developer.wordpress.org/themes/basics/conditional-tags/
 * Conditional Tags} article in the Theme Developer Handbook.
 *
 * @since 1.5.0
 *
 * @global WP_Query $wp_query WordPress Query object.
 *
 * @param int|string|int[]|string[] $category Optional. Category ID, name, slug, or array of such
 *                                            to check against. Default empty.
 * @return bool Whether the query is for an existing category archive page.
 */
function is_category( $category = '' ) {
	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.' ), '3.1.0' );
		return false;
	}

	return $wp_query->is_category( $category );
}

/**
 * Determines whether the query is for an existing tag archive page.
 *
 * If the $tag parameter is specified, this function will additionally
 * check if the query is for one of the tags specified.
 *
 * For more information on this and similar theme functions, check out
 * the {@link https://developer.wordpress.org/themes/basics/conditional-tags/
 * Conditional Tags} article in the Theme Developer Handbook.
 *
 * @since 2.3.0
 *
 * @global WP_Query $wp_query WordPress Query object.
 *
 * @param int|string|int[]|string[] $tag Optional. Tag ID, name, slug, or array of such
 *                                       to check against. Default empty.
 * @return bool Whether the query is for an existing tag archive page.
 */
function is_tag( $tag = '' ) {
	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.' ), '3.1.0' );
		return false;
	}

	return $wp_query->is_tag( $tag );
}

/**
 * Determines whether the query is for an existing custom taxonomy archive page.
 *
 * If the $taxonomy parameter is specified, this function will additionally
 * check if the query is for that specific $taxonomy.
 *
 * If the $term parameter is specified in addition to the $taxonomy parameter,
 * this function will additionally check if the query is for one of the terms
 * specified.
 *
 * For more information on this and similar theme functions, check out
 * the {@link https://developer.wordpress.org/themes/basics/conditional-tags/
 * Conditional Tags} article in the Theme Developer Handbook.
 *
 * @since 2.5.0
 *
 * @global WP_Query $wp_query WordPress Query object.
 *
 * @param string|string[]           $taxonomy Optional. Taxonomy slug or slugs to check against.
 *                                            Default empty.
 * @param int|string|int[]|string[] $term     Optional. Term ID, name, slug, or array of such
 *                                            to check against. Default empty.
 * @return bool Whether the query is for an existing custom taxonomy archive page.
 *              True for custom taxonomy archive pages, false for built-in taxonomies
 *              (category and tag archives).
 */
function is_tax( $taxonomy = '', $term = '' ) {
	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.' ), '3.1.0' );
		return false;
	}

	return $wp_query->is_tax( $taxonomy, $term );
}

/**
 * Determines whether the query is for an existing date archive.
 *
 * For more information on this and similar theme functions, check out
 * the {@link https://developer.wordpress.org/themes/basics/conditional-tags/
 * Conditional Tags} article in the Theme Developer Handbook.
 *
 * @since 1.5.0
 *
 * @global WP_Query $wp_query WordPress Query object.
 *
 * @return bool Whether the query is for an existing date archive.
 */
function is_date() {
	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.' ), '3.1.0' );
		return false;
	}

	return $wp_query->is_date();
}

/**
 * Determines whether the query is for an existing day archive.
 *
 * A conditional check to test whether the page is a date-based archive page displaying posts for the current day.
 *
 * For more information on this and similar theme functions, check out
 * the {@link https://developer.wordpress.org/themes/basics/conditional-tags/
 * Conditional Tags} article in the Theme Developer Handbook.
 *
 * @since 1.5.0
 *
 * @global WP_Query $wp_query WordPress Query object.
 *
 * @return bool Whether the query is for an existing day archive.
 */
function is_day() {
	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.' ), '3.1.0' );
		return false;
	}

	return $wp_query->is_day();
}

/**
 * Determines whether the query is for a feed.
 *
 * For more information on this and similar theme functions, check out
 * the {@link https://developer.wordpress.org/themes/basics/conditional-tags/
 * Conditional Tags} article in the Theme Developer Handbook.
 *
 * @since 1.5.0
 *
 * @global WP_Query $wp_query WordPress Query object.
 *
 * @param string|string[] $feeds Optional. Feed type or array of feed types
 *                                         to check against. Default empty.
 * @return bool Whether the query is for a feed.
 */
function is_feed( $feeds = '' ) {
	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.' ), '3.1.0' );
		return false;
	}

	return $wp_query->is_feed( $feeds );
}

/**
 * Is the query for a comments feed?
 *
 * @since 3.0.0
 *
 * @global WP_Query $wp_query WordPress Query object.
 *
 * @return bool Whether the query is for a comments feed.
 */
function is_comment_feed() {
	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.' ), '3.1.0' );
		return false;
	}

	return $wp_query->is_comment_feed();
}

/**
 * Determines whether the query is for the front page of the site.
 *
 * This is for what is displayed at your site's main URL.
 *
 * Depends on the site's "Front page displays" Reading Settings 'show_on_front' and 'page_on_front'.
 *
 * If you set a static page for the front page of your site, this function will return
 * true when viewing that page.
 *
 * Otherwise the same as {@see is_home()}.
 *
 * For more information on this and similar theme functions, check out
 * the {@link https://developer.wordpress.org/themes/basics/conditional-tags/
 * Conditional Tags} article in the Theme Developer Handbook.
 *
 * @since 2.5.0
 *
 * @global WP_Query $wp_query WordPress Query object.
 *
 * @return bool Whether the query is for the front page of the site.
 */
function is_front_page() {
	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.' ), '3.1.0' );
		return false;
	}

	return $wp_query->is_front_page();
}

/**
 * Determines whether the query is for the blog homepage.
 *
 * The blog homepage is the page that shows the time-based blog content of the site.
 *
 * is_home() is dependent on the site's "Front page displays" Reading Settings 'show_on_front'
 * and 'page_for_posts'.
 *
 * If a static page is set for the front page of the site, this function will return true only
 * on the page you set as the "Posts page".
 *
 * For more information on this and similar theme functions, check out
 * the {@link https://developer.wordpress.org/themes/basics/conditional-tags/
 * Conditional Tags} article in the Theme Developer Handbook.
 *
 * @since 1.5.0
 *
 * @see is_front_page()
 * @global WP_Query $wp_query WordPress Query object.
 *
 * @return bool Whether the query is for the blog homepage.
 */
function is_home() {
	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.' ), '3.1.0' );
		return false;
	}

	return $wp_query->is_home();
}

/**
 * Determines whether the query is for the Privacy Policy page.
 *
 * The Privacy Policy page is the page that shows the Privacy Policy content of the site.
 *
 * is_privacy_policy() is dependent on the site's "Change your Privacy Policy page" Privacy Settings 'wp_page_for_privacy_policy'.
 *
 * This function will return true only on the page you set as the "Privacy Policy page".
 *
 * For more information on this and similar theme functions, check out
 * the {@link https://developer.wordpress.org/themes/basics/conditional-tags/
 * Conditional Tags} article in the Theme Developer Handbook.
 *
 * @since 5.2.0
 *
 * @global WP_Query $wp_query WordPress Query object.
 *
 * @return bool Whether the query is for the Privacy Policy page.
 */
function is_privacy_policy() {
	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.' ), '3.1.0' );
		return false;
	}

	return $wp_query->is_privacy_policy();
}

/**
 * Determines whether the query is for an existing month archive.
 *
 * For more information on this and similar theme functions, check out
 * the {@link https://developer.wordpress.org/themes/basics/conditional-tags/
 * Conditional Tags} article in the Theme Developer Handbook.
 *
 * @since 1.5.0
 *
 * @global WP_Query $wp_query WordPress Query object.
 *
 * @return bool Whether the query is for an existing month archive.
 */
function is_month() {
	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.' ), '3.1.0' );
		return false;
	}

	return $wp_query->is_month();
}

/**
 * Determines whether the query is for an existing single page.
 *
 * If the $page parameter is specified, this function will additionally
 * check if the query is for one of the pages specified.
 *
 * For more information on this and similar theme functions, check out
 * the {@link https://developer.wordpress.org/themes/basics/conditional-tags/
 * Conditional Tags} article in the Theme Developer Handbook.
 *
 * @since 1.5.0
 *
 * @see is_single()
 * @see is_singular()
 * @global WP_Query $wp_query WordPress Query object.
 *
 * @param int|string|int[]|string[] $page Optional. Page ID, title, slug, or array of such
 *                                        to check against. Default empty.
 * @return bool Whether the query is for an existing single page.
 */
function is_page( $page = '' ) {
	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.' ), '3.1.0' );
		return false;
	}

	return $wp_query->is_page( $page );
}

/**
 * Determines whether the query is for a paged result and not for the first page.
 *
 * For more information on this and similar theme functions, check out
 * the {@link https://developer.wordpress.org/themes/basics/conditional-tags/
 * Conditional Tags} article in the Theme Developer Handbook.
 *
 * @since 1.5.0
 *
 * @global WP_Query $wp_query WordPress Query object.
 *
 * @return bool Whether the query is for a paged result.
 */
function is_paged() {
	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.' ), '3.1.0' );
		return false;
	}

	return $wp_query->is_paged();
}

/**
 * Determines whether the query is for a post or page preview.
 *
 * For more information on this and similar theme functions, check out
 * the {@link https://developer.wordpress.org/themes/basics/conditional-tags/
 * Conditional Tags} article in the Theme Developer Handbook.
 *
 * @since 2.0.0
 *
 * @global WP_Query $wp_query WordPress Query object.
 *
 * @return bool Whether the query is for a post or page preview.
 */
function is_preview() {
	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.' ), '3.1.0' );
		return false;
	}

	return $wp_query->is_preview();
}

/**
 * Is the query for the robots.txt file?
 *
 * @since 2.1.0
 *
 * @global WP_Query $wp_query WordPress Query object.
 *
 * @return bool Whether the query is for the robots.txt file.
 */
function is_robots() {
	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.' ), '3.1.0' );
		return false;
	}

	return $wp_query->is_robots();
}

/**
 * Is the query for the favicon.ico file?
 *
 * @since 5.4.0
 *
 * @global WP_Query $wp_query WordPress Query object.
 *
 * @return bool Whether the query is for the favicon.ico file.
 */
function is_favicon() {
	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.' ), '3.1.0' );
		return false;
	}

	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();
}

/**
 * Determines whether the query is for random content.
 *
 * True for a blog home or archive request that includes the `random` query variable,
 * for example `example.com/random/` or `example.com/random/category/news/`. Search,
 * feed, trackback, robots.txt, favicon and sitemap requests are never for random content.
 *
 * @since 7.2.0
 *
 * @see wp_is_random_content_query()
 * @global WP_Query $wp_query WordPress Query object.
 *
 * @return bool Whether the query is for random content.
 */
function is_random(): 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.2.0' );
		return false;
	}

	return $wp_query->is_random();
}

/**
 * Determines whether the query is for a search.
 *
 * For more information on this and similar theme functions, check out
 * the {@link https://developer.wordpress.org/themes/basics/conditional-tags/
 * Conditional Tags} article in the Theme Developer Handbook.
 *
 * @since 1.5.0
 *
 * @global WP_Query $wp_query WordPress Query object.
 *
 * @return bool Whether the query is for a search.
 */
function is_search() {
	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.' ), '3.1.0' );
		return false;
	}

	return $wp_query->is_search();
}

/**
 * Determines whether the query is for an existing single post.
 *
 * Works for any post type, except attachments and pages
 *
 * If the $post parameter is specified, this function will additionally
 * check if the query is for one of the Posts specified.
 *
 * For more information on this and similar theme functions, check out
 * the {@link https://developer.wordpress.org/themes/basics/conditional-tags/
 * Conditional Tags} article in the Theme Developer Handbook.
 *
 * @since 1.5.0
 *
 * @see is_page()
 * @see is_singular()
 * @global WP_Query $wp_query WordPress Query object.
 *
 * @param int|string|int[]|string[] $post Optional. Post ID, title, slug, or array of such
 *                                        to check against. Default empty.
 * @return bool Whether the query is for an existing single post.
 */
function is_single( $post = '' ) {
	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.' ), '3.1.0' );
		return false;
	}

	return $wp_query->is_single( $post );
}

/**
 * Determines whether the query is for an existing single post of any post type
 * (post, attachment, page, custom post types).
 *
 * If the $post_types parameter is specified, this function will additionally
 * check if the query is for one of the Posts Types specified.
 *
 * For more information on this and similar theme functions, check out
 * the {@link https://developer.wordpress.org/themes/basics/conditional-tags/
 * Conditional Tags} article in the Theme Developer Handbook.
 *
 * @since 1.5.0
 *
 * @see is_page()
 * @see is_single()
 * @global WP_Query $wp_query WordPress Query object.
 *
 * @param string|string[] $post_types Optional. Post type or array of post types
 *                                    to check against. Default empty.
 * @return bool Whether the query is for an existing single post
 *              or any of the given post types.
 */
function is_singular( $post_types = '' ) {
	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.' ), '3.1.0' );
		return false;
	}

	return $wp_query->is_singular( $post_types );
}

/**
 * Determines whether the query is for a specific time.
 *
 * For more information on this and similar theme functions, check out
 * the {@link https://developer.wordpress.org/themes/basics/conditional-tags/
 * Conditional Tags} article in the Theme Developer Handbook.
 *
 * @since 1.5.0
 *
 * @global WP_Query $wp_query WordPress Query object.
 *
 * @return bool Whether the query is for a specific time.
 */
function is_time() {
	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.' ), '3.1.0' );
		return false;
	}

	return $wp_query->is_time();
}

/**
 * Determines whether the query is for a trackback endpoint call.
 *
 * For more information on this and similar theme functions, check out
 * the {@link https://developer.wordpress.org/themes/basics/conditional-tags/
 * Conditional Tags} article in the Theme Developer Handbook.
 *
 * @since 1.5.0
 *
 * @global WP_Query $wp_query WordPress Query object.
 *
 * @return bool Whether the query is for a trackback endpoint call.
 */
function is_trackback() {
	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.' ), '3.1.0' );
		return false;
	}

	return $wp_query->is_trackback();
}

/**
 * Determines whether the query is for an existing year archive.
 *
 * For more information on this and similar theme functions, check out
 * the {@link https://developer.wordpress.org/themes/basics/conditional-tags/
 * Conditional Tags} article in the Theme Developer Handbook.
 *
 * @since 1.5.0
 *
 * @global WP_Query $wp_query WordPress Query object.
 *
 * @return bool Whether the query is for an existing year archive.
 */
function is_year() {
	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.' ), '3.1.0' );
		return false;
	}

	return $wp_query->is_year();
}

/**
 * Determines whether the query has resulted in a 404 (returns no results).
 *
 * For more information on this and similar theme functions, check out
 * the {@link https://developer.wordpress.org/themes/basics/conditional-tags/
 * Conditional Tags} article in the Theme Developer Handbook.
 *
 * @since 1.5.0
 *
 * @global WP_Query $wp_query WordPress Query object.
 *
 * @return bool Whether the query is a 404 error.
 */
function is_404() {
	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.' ), '3.1.0' );
		return false;
	}

	return $wp_query->is_404();
}

/**
 * Is the query for an embedded post?
 *
 * @since 4.4.0
 *
 * @global WP_Query $wp_query WordPress Query object.
 *
 * @return bool Whether the query is for an embedded post.
 */
function is_embed() {
	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.' ), '3.1.0' );
		return false;
	}

	return $wp_query->is_embed();
}

/**
 * Determines whether the query is the main query.
 *
 * For more information on this and similar theme functions, check out
 * the {@link https://developer.wordpress.org/themes/basics/conditional-tags/
 * Conditional Tags} article in the Theme Developer Handbook.
 *
 * @since 3.3.0
 *
 * @global WP_Query $wp_query WordPress Query object.
 *
 * @return bool Whether the query is the main query.
 */
function is_main_query() {
	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.' ), '6.1.0' );
		return false;
	}

	if ( 'pre_get_posts' === current_filter() ) {
		_doing_it_wrong(
			__FUNCTION__,
			sprintf(
				/* translators: 1: pre_get_posts, 2: WP_Query->is_main_query(), 3: is_main_query(), 4: Documentation URL. */
				__( 'In %1$s, use the %2$s method, not the %3$s function. See %4$s.' ),
				'<code>pre_get_posts</code>',
				'<code>WP_Query->is_main_query()</code>',
				'<code>is_main_query()</code>',
				__( 'https://developer.wordpress.org/reference/functions/is_main_query/' )
			),
			'3.7.0'
		);
	}

	return $wp_query->is_main_query();
}

/*
 * The Loop. Post loop control.
 */

/**
 * Determines whether current WordPress query has posts to loop over.
 *
 * @since 1.5.0
 *
 * @global WP_Query $wp_query WordPress Query object.
 *
 * @phpstan-impure
 *
 * @return bool True if posts are available, false if end of the loop.
 */
function have_posts() {
	global $wp_query;

	if ( ! isset( $wp_query ) ) {
		return false;
	}

	return $wp_query->have_posts();
}

/**
 * Determines whether the caller is in the Loop.
 *
 * For more information on this and similar theme functions, check out
 * the {@link https://developer.wordpress.org/themes/basics/conditional-tags/
 * Conditional Tags} article in the Theme Developer Handbook.
 *
 * @since 2.0.0
 *
 * @global WP_Query $wp_query WordPress Query object.
 *
 * @return bool True if caller is within loop, false if loop hasn't started or ended.
 */
function in_the_loop() {
	global $wp_query;

	if ( ! isset( $wp_query ) ) {
		return false;
	}

	return $wp_query->in_the_loop;
}

/**
 * Rewind the loop posts.
 *
 * @since 1.5.0
 *
 * @global WP_Query $wp_query WordPress Query object.
 */
function rewind_posts() {
	global $wp_query;

	if ( ! isset( $wp_query ) ) {
		return;
	}

	$wp_query->rewind_posts();
}

/**
 * Iterate the post index in the loop.
 *
 * @since 1.5.0
 *
 * @global WP_Query $wp_query WordPress Query object.
 */
function the_post() {
	global $wp_query;

	if ( ! isset( $wp_query ) ) {
		return;
	}

	$wp_query->the_post();
}

/*
 * Comments loop.
 */

/**
 * Determines whether current WordPress query has comments to loop over.
 *
 * @since 2.2.0
 *
 * @global WP_Query $wp_query WordPress Query object.
 *
 * @phpstan-impure
 *
 * @return bool True if comments are available, false if no more comments.
 */
function have_comments() {
	global $wp_query;

	if ( ! isset( $wp_query ) ) {
		return false;
	}

	return $wp_query->have_comments();
}

/**
 * Iterate comment index in the comment loop.
 *
 * @since 2.2.0
 *
 * @global WP_Query $wp_query WordPress Query object.
 */
function the_comment() {
	global $wp_query;

	if ( ! isset( $wp_query ) ) {
		return;
	}

	$wp_query->the_comment();
}

/**
 * Redirect old slugs to the correct permalink.
 *
 * Attempts to find the current slug from the past slugs.
 *
 * @since 2.1.0
 */
function wp_old_slug_redirect() {
	if ( is_404() && '' !== get_query_var( 'name' ) ) {
		// Guess the current post type based on the query vars.
		if ( get_query_var( 'post_type' ) ) {
			$post_type = get_query_var( 'post_type' );
		} elseif ( get_query_var( 'attachment' ) ) {
			$post_type = 'attachment';
		} elseif ( get_query_var( 'pagename' ) ) {
			$post_type = 'page';
		} else {
			$post_type = 'post';
		}

		if ( is_array( $post_type ) ) {
			if ( count( $post_type ) > 1 ) {
				return;
			}
			$post_type = reset( $post_type );
		}

		// Do not attempt redirect for hierarchical post types.
		if ( is_post_type_hierarchical( $post_type ) ) {
			return;
		}

		$id = _find_post_by_old_slug( $post_type );

		if ( ! $id ) {
			$id = _find_post_by_old_date( $post_type );
		}

		/**
		 * Filters the old slug redirect post ID.
		 *
		 * @since 4.9.3
		 *
		 * @param int $id The redirect post ID.
		 */
		$id = apply_filters( 'old_slug_redirect_post_id', $id );

		if ( ! $id ) {
			return;
		}

		$link = get_permalink( $id );

		if ( get_query_var( 'paged' ) > 1 ) {
			$link = user_trailingslashit( trailingslashit( $link ) . 'page/' . get_query_var( 'paged' ) );
		} elseif ( is_embed() ) {
			$link = user_trailingslashit( trailingslashit( $link ) . 'embed' );
		}

		/**
		 * Filters the old slug redirect URL.
		 *
		 * @since 4.4.0
		 *
		 * @param string $link The redirect URL.
		 */
		$link = apply_filters( 'old_slug_redirect_url', $link );

		if ( ! $link ) {
			return;
		}

		wp_redirect( $link, 301 ); // Permanent redirect.
		exit;
	}
}

/**
 * Find the post ID for redirecting an old slug.
 *
 * @since 4.9.3
 * @access private
 *
 * @see wp_old_slug_redirect()
 * @global wpdb $wpdb WordPress database abstraction object.
 *
 * @param string $post_type The current post type based on the query vars.
 * @return int The Post ID.
 */
function _find_post_by_old_slug( $post_type ) {
	global $wpdb;

	$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' ) );

	/*
	 * If year, monthnum, or day have been specified, make our query more precise
	 * just in case there are multiple identical _wp_old_slug values.
	 */
	if ( get_query_var( 'year' ) ) {
		$query .= $wpdb->prepare( ' AND YEAR(post_date) = %d', get_query_var( 'year' ) );
	}
	if ( get_query_var( 'monthnum' ) ) {
		$query .= $wpdb->prepare( ' AND MONTH(post_date) = %d', get_query_var( 'monthnum' ) );
	}
	if ( get_query_var( 'day' ) ) {
		$query .= $wpdb->prepare( ' AND DAYOFMONTH(post_date) = %d', get_query_var( 'day' ) );
	}

	$key          = md5( $query );
	$last_changed = wp_cache_get_last_changed( 'posts' );
	$cache_key    = "find_post_by_old_slug:$key";
	$cache        = wp_cache_get_salted( $cache_key, 'post-queries', $last_changed );
	if ( false !== $cache ) {
		$id = $cache;
	} else {
		$id = (int) $wpdb->get_var( $query );
		wp_cache_set_salted( $cache_key, $id, 'post-queries', $last_changed );
	}

	return $id;
}

/**
 * Find the post ID for redirecting an old date.
 *
 * @since 4.9.3
 * @access private
 *
 * @see wp_old_slug_redirect()
 * @global wpdb $wpdb WordPress database abstraction object.
 *
 * @param string $post_type The current post type based on the query vars.
 * @return int The Post ID.
 */
function _find_post_by_old_date( $post_type ) {
	global $wpdb;

	$date_query = '';
	if ( get_query_var( 'year' ) ) {
		$date_query .= $wpdb->prepare( ' AND YEAR(pm_date.meta_value) = %d', get_query_var( 'year' ) );
	}
	if ( get_query_var( 'monthnum' ) ) {
		$date_query .= $wpdb->prepare( ' AND MONTH(pm_date.meta_value) = %d', get_query_var( 'monthnum' ) );
	}
	if ( get_query_var( 'day' ) ) {
		$date_query .= $wpdb->prepare( ' AND DAYOFMONTH(pm_date.meta_value) = %d', get_query_var( 'day' ) );
	}

	$id = 0;
	if ( $date_query ) {
		$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' ) );
		$key          = md5( $query );
		$last_changed = wp_cache_get_last_changed( 'posts' );
		$cache_key    = "find_post_by_old_date:$key";
		$cache        = wp_cache_get_salted( $cache_key, 'post-queries', $last_changed );
		if ( false !== $cache ) {
			$id = $cache;
		} else {
			$id = (int) $wpdb->get_var( $query );
			if ( ! $id ) {
				// Check to see if an old slug matches the old date.
				$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' ) ) );
			}
			wp_cache_set_salted( $cache_key, $id, 'post-queries', $last_changed );
		}
	}

	return $id;
}

/**
 * Determines whether random content redirects are enabled.
 *
 * @since 7.2.0
 *
 * @return bool True if random content redirects are enabled, false otherwise.
 */
function wp_is_random_content_redirect_enabled(): bool {
	/**
	 * Filters whether random content redirects are enabled.
	 *
	 * Random content redirects add rewrite rules for URLs such as `/random/`, so the
	 * rewrite rules need to be flushed after changing the value returned by this filter.
	 *
	 * @since 7.2.0
	 *
	 * @param bool $enabled Whether random content redirects are enabled. Default true.
	 */
	return (bool) apply_filters( 'wp_enable_random_content_redirect', true );
}

/**
 * Determines whether a query is a request for random content.
 *
 * A random content request is a front end, main query for the blog home or an archive
 * that includes the `random` query variable and at least one `randomable` post type.
 * For example `example.com/random/` or `example.com/random/category/news/`.
 *
 * Singular (including embeds), search, feed, trackback, robots.txt, favicon and sitemap
 * requests are never random content requests, nor are requests using an HTTP method
 * other than GET or HEAD. Search
 * requests are excluded as selecting a random post from search results would run an
 * uncacheable search query that orders every matching post randomly. Search requests
 * that include the `random` query variable are redirected to the search results
 * by {@see WP::handle_random()}.
 *
 * @since 7.2.0
 *
 * @param WP_Query $query The query to check.
 * @return bool True if the query is a request for random content, false otherwise.
 */
function wp_is_random_content_query( WP_Query $query ): bool {
	if (
		! $query->is_random()
		|| ! $query->is_main_query()
		|| is_admin()
		|| ! wp_is_random_content_redirect_enabled()
	) {
		return false;
	}

	$request_method = isset( $_SERVER['REQUEST_METHOD'] ) && is_string( $_SERVER['REQUEST_METHOD'] ) ? strtoupper( $_SERVER['REQUEST_METHOD'] ) : '';
	if ( 'GET' !== $request_method && 'HEAD' !== $request_method ) {
		return false;
	}

	return array() !== wp_get_random_content_post_types( $query );
}

/**
 * Retrieves the post types eligible for selection by a random content request.
 *
 * These are the post types the query would otherwise return, limited to those
 * registered as `randomable`.
 *
 * @since 7.2.0
 *
 * @see register_post_type()
 *
 * @param WP_Query $query The query to retrieve the post types for.
 * @return string[] Post type names eligible for random selection.
 *
 * @phpstan-return list<string>
 */
function wp_get_random_content_post_types( WP_Query $query ): array {
	$post_types = $query->get( 'post_type' );

	if ( empty( $post_types ) && $query->is_tax() && $query->tax_query instanceof WP_Tax_Query ) {
		// Match WP_Query::get_posts(): searchable post types using any of the queried taxonomies.
		$taxonomies = array_keys( $query->tax_query->queried_terms );
		$post_types = array();

		foreach ( get_post_types( array( 'exclude_from_search' => false ) ) as $post_type ) {
			$object_taxonomies = 'attachment' === $post_type ? get_taxonomies_for_attachments() : get_object_taxonomies( $post_type );
			if ( array_intersect( $taxonomies, $object_taxonomies ) ) {
				$post_types[] = $post_type;
			}
		}
	} elseif ( empty( $post_types ) && ! $query->is_search() ) {
		$post_types = array( 'post' );
	}

	if ( empty( $post_types ) || 'any' === $post_types ) {
		$post_types = get_post_types( array( 'exclude_from_search' => false ) );
	}

	$random_post_types = array();

	foreach ( (array) $post_types as $post_type ) {
		// Plugins may set invalid values on the `post_type` query variable.
		if ( ! is_string( $post_type ) ) {
			continue;
		}

		$post_type_object = get_post_type_object( $post_type );

		if ( $post_type_object && $post_type_object->randomable ) {
			$random_post_types[] = $post_type_object->name;
		}
	}

	return $random_post_types;
}

/**
 * Limits the main query to posts eligible for random content requests.
 *
 * The main query is used to select the random post so the request runs the same
 * query, and the same filters, as the archive it is randomizing. As such, callbacks
 * on the {@see 'pre_get_posts'} action may modify the posts eligible for selection,
 * for example to limit the post types or exclude a category:
 *
 *     add_action(
 *         'pre_get_posts',
 *         static function ( WP_Query $query ) {
 *             if ( wp_is_random_content_query( $query ) ) {
 *                 $query->set( 'category__not_in', array( 1 ) );
 *             }
 *         }
 *     );
 *
 * Only randomable post types and published posts without a password are eligible.
 * The number and order of posts are enforced by {@see wp_random_content_post_limits()} and
 * {@see wp_random_content_posts_orderby()}, so callbacks modifying them on archives do not
 * affect the selection.
 *
 * The random post IDs the post is selected from are stored in the `random_sample_ids`
 * query variable, see {@see wp_get_random_content_sample_ids()}.
 *
 * Added to the {@see 'pre_get_posts'} action by {@see WP::handle_random()} while the
 * random content query runs, so it runs after other callbacks.
 *
 * @since 7.2.0
 *
 * @param WP_Query $query The WP_Query instance (passed by reference).
 */
function wp_random_content_pre_get_posts( $query ): void {
	if ( ! wp_is_random_content_query( $query ) ) {
		return;
	}

	$query->set( 'post_type', wp_get_random_content_post_types( $query ) );
	$query->set( 'post_status', 'publish' );
	$query->set( 'has_password', false );
	$query->set( 'random_sample_ids', wp_get_random_content_sample_ids() );
	$query->set( 'ignore_sticky_posts', true );
	$query->set( 'no_found_rows', true );
	$query->set( 'update_post_meta_cache', false );
	$query->set( 'update_post_term_cache', false );
	// The order and number of posts are enforced by filters, which a suppressed query skips.
	$query->set( 'suppress_filters', false );
}

/**
 * Retrieves random post IDs for the random content query to select a post from.
 *
 * Sorting posts randomly requires the database to read every eligible post. Instead,
 * the random content query looks up 50 random post IDs, each by the primary key, and
 * selects one of those that is an eligible post. The cost of the lookup does not
 * depend on the number of posts, and as every post ID is equally likely to be looked
 * up, every eligible post is equally likely to be selected. This is the case whether
 * or not there are gaps between the IDs of posts.
 *
 * The IDs are between 1 and the highest post ID, which is stored in the object cache
 * for 10 minutes. If there are no more than 50 post IDs, all of them are returned.
 *
 * @since 7.2.0
 *
 * @global wpdb $wpdb WordPress database abstraction object.
 *
 * @return int[] Up to 50 distinct post IDs. Posts with the IDs may not exist.
 *
 * @phpstan-return non-empty-list<int>
 */
function wp_get_random_content_sample_ids(): array {
	global $wpdb;

	$max_id = wp_cache_get( 'max_post_id', 'random-content' );

	if ( ! is_int( $max_id ) ) {
		$max_id = (int) $wpdb->get_var( "SELECT MAX(ID) FROM {$wpdb->posts}" );
		wp_cache_set( 'max_post_id', $max_id, 'random-content', 10 * MINUTE_IN_SECONDS );
	}

	if ( $max_id <= 50 ) {
		return range( 1, max( 1, $max_id ) );
	}

	$post_ids = array();

	while ( count( $post_ids ) < 50 ) {
		$post_ids[ wp_rand( 1, $max_id ) ] = true;
	}

	return array_keys( $post_ids );
}

/**
 * Retrieves the SQL clause limiting the random content query to random post IDs.
 *
 * @since 7.2.0
 * @access private
 *
 * @global wpdb $wpdb WordPress database abstraction object.
 *
 * @param int[] $post_ids Post IDs.
 * @return string SQL clause.
 */
function _wp_random_content_sample_clause( array $post_ids ): string {
	global $wpdb;

	return "{$wpdb->posts}.ID IN (" . implode( ',', array_map( 'intval', $post_ids ) ) . ')';
}

/**
 * Limits the random content query to the random post IDs.
 *
 * Added to the {@see 'posts_where'} filter by {@see WP::handle_random()} while the random
 * content query runs.
 *
 * @since 7.2.0
 *
 * @see wp_get_random_content_sample_ids()
 *
 * @param string   $where The WHERE clause of the query.
 * @param WP_Query $query The WP_Query instance.
 * @return string The WHERE clause of the query.
 */
function wp_random_content_posts_where( $where, WP_Query $query ): string {
	$sample_ids = $query->get( 'random_sample_ids' );

	if ( wp_is_random_content_query( $query ) && is_array( $sample_ids ) && $sample_ids ) {
		$where .= ' AND ' . _wp_random_content_sample_clause( $sample_ids );
	}

	return (string) $where;
}

/**
 * Removes the order of the random content query.
 *
 * The random content query is limited to random post IDs, one of which is selected
 * once the query has run, see {@see wp_random_content_posts_pre_query()}. Ordering the
 * posts would require the database to sort them.
 *
 * Added to the {@see 'posts_orderby'} filter by {@see WP::handle_random()} while the random
 * content query runs. Enforcing the order in SQL prevents {@see 'pre_get_posts'}
 * callbacks setting the order of posts on archives from affecting the selection.
 *
 * @since 7.2.0
 *
 * @param string   $orderby The ORDER BY clause of the query.
 * @param WP_Query $query   The WP_Query instance.
 * @return string The ORDER BY clause of the query.
 */
function wp_random_content_posts_orderby( $orderby, WP_Query $query ): string {
	if ( wp_is_random_content_query( $query ) ) {
		return '';
	}

	return (string) $orderby;
}

/**
 * Removes the limit of the random content query.
 *
 * The random content query is limited to random post IDs, one of which is selected
 * once the query has run, see {@see wp_random_content_posts_pre_query()}.
 *
 * Added to the {@see 'post_limits'} filter by {@see WP::handle_random()} while the random
 * content query runs. Enforcing the limit in SQL prevents {@see 'pre_get_posts'}
 * callbacks setting the number of posts, offset or page on archives from affecting
 * the selection.
 *
 * @since 7.2.0
 *
 * @param string   $limits The LIMIT clause of the query.
 * @param WP_Query $query  The WP_Query instance.
 * @return string The LIMIT clause of the query.
 */
function wp_random_content_post_limits( $limits, WP_Query $query ): string {
	if ( wp_is_random_content_query( $query ) ) {
		return '';
	}

	return (string) $limits;
}

/**
 * Limits the random content query to selecting post IDs.
 *
 * Added to the {@see 'posts_fields'} filter by {@see WP::handle_random()} while the random
 * content query runs.
 *
 * @since 7.2.0
 *
 * @global wpdb $wpdb WordPress database abstraction object.
 *
 * @param string   $fields The SELECT clause of the query.
 * @param WP_Query $query  The WP_Query instance.
 * @return string The SELECT clause of the query.
 */
function wp_random_content_posts_fields( $fields, WP_Query $query ): string {
	global $wpdb;

	if ( wp_is_random_content_query( $query ) ) {
		return "{$wpdb->posts}.ID";
	}

	return (string) $fields;
}

/**
 * Selects the random post from the eligible posts among random post IDs.
 *
 * The random content query is limited to 50 random post IDs, see
 * {@see wp_get_random_content_sample_ids()}, and one of the posts it selects is chosen
 * at random. If none of the IDs are eligible posts, the query is run again with other
 * random post IDs, up to three times in total. On sites where most post IDs are
 * eligible posts, a post is nearly always selected by the first query.
 *
 * If no post is selected, eligible posts are too sparse among the post IDs to be found
 * this way, for example a small category on a site with many posts. A pool of up to
 * 1,000 randomly ordered eligible posts is then selected, which is the whole archive
 * if it has no more posts than that, and their IDs are stored in the object cache for
 * 10 minutes. While the pool is cached, the post is selected from it without querying
 * the database for the eligible posts. Selecting the pool requires the database to
 * read every eligible post, so sites with a persistent object cache do so at most once
 * every 10 minutes for each such archive.
 *
 * The pool is selected without excluding password protected posts, which are skipped
 * when the post is selected from it, so the database can read the eligible posts from
 * an index rather than reading each post in full.
 *
 * Only one request selects the pool at a time. Once the pool is 10 minutes old, the
 * first request to need it selects the next pool and, until it has, other requests
 * select from the previous pool, which is kept for an hour. If there is no previous
 * pool, as the archive has not been requested recently, concurrent requests each
 * select a pool.
 *
 * The pool is keyed by the SQL of the random content query, excluding the random post
 * IDs, so each archive, and each variation of an archive produced by
 * {@see 'pre_get_posts'} callbacks or query filters, has its own pool.
 *
 * As the pool may be up to 10 minutes old, posts that have since been unpublished,
 * deleted, password protected or changed to another post type are skipped. If none of
 * its posts are eligible, a post is selected as if there was no pool. Other changes,
 * such as a post being published or removed from a term, are reflected once the pool
 * expires. This includes the empty pool of an archive without eligible posts, which
 * is cached so the archive is not queried for every request.
 *
 * Added to the {@see 'posts_pre_query'} filter by {@see WP::handle_random()} while the
 * random content query runs. The database is only read from, never written to.
 *
 * @since 7.2.0
 *
 * @global wpdb $wpdb WordPress database abstraction object.
 *
 * @param WP_Post[]|int[]|null $posts Posts short-circuiting the query, or null to run the query.
 * @param WP_Query             $query The WP_Query instance.
 * @return WP_Post[]|int[]|null The selected post, an empty array if no post is eligible,
 *                              or the unmodified value if the query is not for random content.
 */
function wp_random_content_posts_pre_query( $posts, WP_Query $query ) {
	global $wpdb;

	if ( null !== $posts || ! wp_is_random_content_query( $query ) || ! is_string( $query->request ) ) {
		return $posts;
	}

	// The placeholder escape string is unique to each request, see wpdb::placeholder_escape().
	$request       = $wpdb->remove_placeholder_escape( $query->request );
	$sample_ids    = $query->get( 'random_sample_ids' );
	$sample_clause = is_array( $sample_ids ) && $sample_ids ? _wp_random_content_sample_clause( $sample_ids ) : '';

	/*
	 * The random post IDs can only be replaced, to look up other IDs or to select the
	 * pool, if another callback has not modified their clause.
	 */
	$can_resample = '' !== $sample_clause && 1 === substr_count( $request, $sample_clause );
	$cache_key    = $can_resample ? 'pool:' . md5( str_replace( $sample_clause, '', $request ) ) : '';
	$post_types   = (array) $query->get( 'post_type' );

	/**
	 * Selects a random eligible post from post IDs.
	 *
	 * @param array<int|string> $post_ids Post IDs.
	 * @return WP_Post|null The selected post, or null if none of the posts are eligible.
	 */
	$select_post = static function ( array $post_ids ) use ( $post_types ): ?WP_Post {
		shuffle( $post_ids );

		foreach ( $post_ids as $post_id ) {
			$post = get_post( (int) $post_id );

			if (
				$post instanceof WP_Post
				&& 'publish' === $post->post_status
				&& '' === $post->post_password
				&& in_array( $post->post_type, $post_types, true )
			) {
				return $post;
			}
		}

		return null;
	};

	// The pool selected by an earlier request, once it is more than 10 minutes old.
	$stale_pool = null;

	if ( $can_resample ) {
		$cached = wp_cache_get( $cache_key, 'random-content' );

		if ( is_array( $cached ) && isset( $cached['post_ids'], $cached['expires'] ) && is_array( $cached['post_ids'] ) ) {
			if ( $cached['expires'] > time() ) {
				// The archive had no eligible posts when the pool was selected.
				if ( array() === $cached['post_ids'] ) {
					return array();
				}

				$post = $select_post( $cached['post_ids'] );

				if ( null !== $post ) {
					return array( $post );
				}
			} else {
				$stale_pool = $cached['post_ids'];
			}
		}
	}

	// Look up random post IDs until one of them is an eligible post.
	for ( $attempt = 1; $attempt <= 3; $attempt++ ) {
		if ( $attempt > 1 ) {
			$request = str_replace(
				$sample_clause,
				_wp_random_content_sample_clause( wp_get_random_content_sample_ids() ),
				$wpdb->remove_placeholder_escape( $query->request )
			);
		}

		// phpcs:ignore WordPress.DB.PreparedSQL.NotPrepared -- The request is prepared by WP_Query::get_posts().
		$post = $select_post( $wpdb->get_col( $request ) );

		if ( null !== $post ) {
			return array( $post );
		}

		if ( ! $can_resample ) {
			return array();
		}
	}

	/*
	 * Eligible posts are sparse among the post IDs, so select a pool of them.
	 *
	 * Only one request selects the pool at a time. While it does, other requests select
	 * from the previous pool, if there is one, rather than each reading every eligible
	 * post. wp_cache_add() only stores the lock if another request does not hold it.
	 */
	$lock_key = $cache_key . ':lock';
	$has_lock = wp_cache_add( $lock_key, 1, 'random-content', MINUTE_IN_SECONDS );

	if ( ! $has_lock && null !== $stale_pool ) {
		$post = $select_post( $stale_pool );

		if ( null !== $post ) {
			return array( $post );
		}

		if ( array() === $stale_pool ) {
			return array();
		}
	}

	$request = str_replace( $sample_clause, '1=1', $wpdb->remove_placeholder_escape( $query->request ) );

	/*
	 * The post password is not indexed, so excluding password protected posts in SQL
	 * requires the database to read the full row of every eligible post. They are
	 * excluded when the post is selected from the pool instead, which allows the pool
	 * to be selected from an index.
	 */
	$password_clause = " AND {$wpdb->posts}.post_password = ''";

	if ( 1 === substr_count( $request, $password_clause ) ) {
		$request = str_replace( $password_clause, '', $request );
	}

	// phpcs:ignore WordPress.DB.PreparedSQL.NotPrepared -- The request is prepared by WP_Query::get_posts().
	$pool = array_map( 'intval', $wpdb->get_col( $request . ' ORDER BY RAND() LIMIT 1000' ) );
	$post = $select_post( $pool );

	/*
	 * A pool of fewer than 1,000 posts is the whole archive. If none of its posts are
	 * eligible, as they are all password protected, the archive has no eligible posts.
	 */
	if ( null === $post && count( $pool ) < 1000 ) {
		$pool = array();
	}

	/*
	 * The pool is used for 10 minutes. It is stored for an hour, so that requests can
	 * select from it while the next pool is being selected.
	 */
	wp_cache_set(
		$cache_key,
		array(
			'post_ids' => $pool,
			'expires'  => time() + 10 * MINUTE_IN_SECONDS,
		),
		'random-content',
		HOUR_IN_SECONDS
	);

	if ( $has_lock ) {
		wp_cache_delete( $lock_key, 'random-content' );
	}

	return null === $post ? array() : array( $post );
}

/**
 * Redirects random content requests to the randomly selected post.
 *
 * Added to the {@see 'template_redirect'} action at priority 100 by
 * {@see WP::handle_random()} once the main query has selected the random post, so the
 * redirect is sent after the request is set up and the {@see 'wp'} action has fired.
 * The headers preventing the redirect being cached or indexed are sent with it.
 *
 * The post is read from the main query rather than the current query, so the redirect
 * is still sent when an earlier callback replaces the current query, for example by
 * calling {@see query_posts()}.
 *
 * The request ends once a post is selected. The redirect is to the post's permalink
 * as returned by {@see get_permalink()}, including a permalink filtered to be on
 * another site.
 *
 * If no post is selected, for example on an empty archive, {@see WP::handle_random()}
 * handles the request as a 404.
 *
 * @since 7.2.0
 *
 * @global WP_Query $wp_the_query WordPress main Query object.
 */
function wp_random_content_redirect(): void {
	global $wp_the_query;

	if (
		! $wp_the_query instanceof WP_Query
		|| ! wp_is_random_content_query( $wp_the_query )
		|| ! $wp_the_query->post instanceof WP_Post
	) {
		return;
	}

	nocache_headers();

	if ( ! headers_sent() ) {
		header( 'X-Robots-Tag: noindex, follow' );
	}

	$location = get_permalink( $wp_the_query->post );

	wp_redirect( $location, 302 );
	exit;
}

/**
 * Flushes the rewrite rules when a page or post at the random content base changes.
 *
 * A published page at the random base, for example `example.com/random/`, takes
 * precedence over random content redirects. So does a published post when the
 * permalink structure places posts at the same URL, for example `/%postname%/`,
 * see {@see WP_Rewrite::post_permalinks_share_random_base()}. As the rewrite rules account
 * for the page or post, they need to be regenerated when it is published,
 * unpublished, renamed, moved or deleted.
 *
 * Runs on the {@see 'wp_after_insert_post'} and {@see 'after_delete_post'} actions.
 * Third-party code may fire these actions with unexpected values, so the parameters are
 * not type declared. When `$post` is omitted it is looked up from `$post_id`. Passing
 * anything other than a `WP_Post` as `$post`, or a post that cannot be looked up, is
 * incorrect usage and nothing is flushed. `$post_before` is only considered on
 * `wp_after_insert_post`, where passing anything other than a `WP_Post` or null is
 * incorrect usage and the value is ignored.
 *
 * @since 7.2.0
 *
 * @see WP_Rewrite::random_rewrite_rules()
 * @global WP_Rewrite $wp_rewrite WordPress rewrite component.
 *
 * @param int          $post_id     Post ID.
 * @param WP_Post|null $post        Optional. Post object. Looked up from `$post_id` when null. Default null.
 * @param bool         $update      Optional. Whether this is an existing post being updated. Default false.
 * @param WP_Post|null $post_before Optional. Post object before the update, null for new posts. Default null.
 */
function wp_random_content_flush_rewrite_rules_for_post( $post_id, $post = null, $update = false, $post_before = null ): void {
	global $wp_rewrite;

	// Only look up a real ID: get_post() falls back to the global post for an empty value.
	if ( null === $post && (int) $post_id > 0 ) {
		$post = get_post( (int) $post_id );
	}

	if ( ! $post instanceof WP_Post ) {
		_doing_it_wrong(
			__FUNCTION__,
			sprintf(
				/* translators: 1: $post, 2: WP_Post */
				__( 'The %1$s argument must be a %2$s object.' ),
				'<code>$post</code>',
				'<code>WP_Post</code>'
			),
			'7.2.0'
		);
		return;
	}

	$posts = array( $post );

	// Only wp_after_insert_post passes the previous post object, which matters when it was renamed or moved.
	if ( 'wp_after_insert_post' === current_action() ) {
		if ( $post_before instanceof WP_Post ) {
			$posts[] = $post_before;
		} elseif ( null !== $post_before ) {
			_doing_it_wrong(
				__FUNCTION__,
				sprintf(
					/* translators: 1: $post_before, 2: WP_Post */
					__( 'The %1$s argument must be a %2$s object or null.' ),
					'<code>$post_before</code>',
					'<code>WP_Post</code>'
				),
				'7.2.0'
			);
		}
	}

	if ( ! $wp_rewrite->using_permalinks() || ! wp_is_random_content_redirect_enabled() ) {
		return;
	}

	foreach ( $posts as $page ) {
		if (
			$wp_rewrite->get_random_base() === $page->post_name
			&& (
				( 'page' === $page->post_type && 0 === (int) $page->post_parent )
				|| ( 'post' === $page->post_type && $wp_rewrite->post_permalinks_share_random_base() )
			)
		) {
			flush_rewrite_rules( false );
			return;
		}
	}
}

/**
 * Set up global post data.
 *
 * @since 1.5.0
 * @since 4.4.0 Added the ability to pass a post ID to `$post`.
 *
 * @global WP_Query $wp_query WordPress Query object.
 *
 * @param WP_Post|object|int $post WP_Post instance or Post ID/object.
 * @return bool True when finished.
 */
function setup_postdata( $post ) {
	global $wp_query;

	if ( ! empty( $wp_query ) && $wp_query instanceof WP_Query ) {
		return $wp_query->setup_postdata( $post );
	}

	return false;
}

/**
 * Generates post data.
 *
 * @since 5.2.0
 *
 * @global WP_Query $wp_query WordPress Query object.
 *
 * @param WP_Post|object|int $post WP_Post instance or Post ID/object.
 * @return array|false Elements of post, or false on failure.
 */
function generate_postdata( $post ) {
	global $wp_query;

	if ( ! empty( $wp_query ) && $wp_query instanceof WP_Query ) {
		return $wp_query->generate_postdata( $post );
	}

	return false;
}

No other release has this exact content. See every version of this file.