enmi-conf.org: comparison wp/wp-includes/link-template.php

equal deleted inserted replaced

-:7b1b88e27a20
+:48c4eec2b7e6
 *
 * @since 2.2.0
 *
 * @global WP_Rewrite $wp_rewrite WordPress rewrite component.
 *
-* @param string $string      URL with or without a trailing slash.
+* @param string $url         URL with or without a trailing slash.
 * @param string $type_of_url Optional. The type of URL being considered (e.g. single, category, etc)
 *                            for use in the filter. Default empty string.
 * @return string The URL with the trailing slash appended or stripped.
 */
-function user_trailingslashit( $string, $type_of_url = '' ) {
+function user_trailingslashit( $url, $type_of_url = '' ) {
 	global $wp_rewrite;
 	if ( $wp_rewrite->use_trailing_slashes ) {
-		$string = trailingslashit( $string );
+		$url = trailingslashit( $url );
 	} else {
-		$string = untrailingslashit( $string );
+		$url = untrailingslashit( $url );
 	}
 	/**
 	 * Filters the trailing-slashed string, depending on whether the site is set to use trailing slashes.
 	 *
 	 * @since 2.2.0
 	 *
-	 * @param string $string      URL with or without a trailing slash.
+	 * @param string $url         URL with or without a trailing slash.
 	 * @param string $type_of_url The type of URL being considered. Accepts 'single', 'single_trackback',
 	 *                            'single_feed', 'single_paged', 'commentpaged', 'paged', 'home', 'feed',
 	 *                            'category', 'page', 'year', 'month', 'day', 'post_type_archive'.
 	 */
-	return apply_filters( 'user_trailingslashit', $string, $type_of_url );
+	return apply_filters( 'user_trailingslashit', $url, $type_of_url );
 }
 /**
 * Displays the permalink anchor for the current post.
 *
 *
 * @see get_permalink()
 *
 * @param int|WP_Post $post      Optional. Post ID or post object. Default is the global `$post`.
 * @param bool        $leavename Optional. Whether to keep post name or page name. Default false.
-* @return string|false The permalink URL or false if post does not exist.
+* @return string|false The permalink URL. False if the post does not exist.
 */
 function get_the_permalink( $post = 0, $leavename = false ) {
 	return get_permalink( $post, $leavename );
 }
 *
 * @since 1.0.0
 *
 * @param int|WP_Post $post      Optional. Post ID or post object. Default is the global `$post`.
 * @param bool        $leavename Optional. Whether to keep post name or page name. Default false.
-* @return string|false The permalink URL or false if post does not exist.
+* @return string|false The permalink URL. False if the post does not exist.
 */
 function get_permalink( $post = 0, $leavename = false ) {
 	$rewritecode = array(
 		'%year%',
 		'%monthnum%',
 		$permalink &&
 		! wp_force_plain_post_permalink( $post )
 	) {
 		$category = '';
-		if ( strpos( $permalink, '%category%' ) !== false ) {
+		if ( str_contains( $permalink, '%category%' ) ) {
 			$cats = get_the_category( $post->ID );
 			if ( $cats ) {
 				$cats = wp_list_sort(
 					$cats,
 					array(
 				$category        = $category_object->slug;
 				if ( $category_object->parent ) {
 					$category = get_category_parents( $category_object->parent, false, '/', true ) . $category;
 				}
 			}
-			// Show default category in permalinks,
+			/*
-			// without having to assign it explicitly.
+			 * Show default category in permalinks,
+			 * without having to assign it explicitly.
+			 */
 			if ( empty( $category ) ) {
 				$default_category = get_term( get_option( 'default_category' ), 'category' );
 				if ( $default_category && ! is_wp_error( $default_category ) ) {
 					$category = $default_category->slug;
 				}
 			}
 		}
 		$author = '';
-		if ( strpos( $permalink, '%author%' ) !== false ) {
+		if ( str_contains( $permalink, '%author%' ) ) {
 			$authordata = get_userdata( $post->post_author );
 			$author     = $authordata->user_nicename;
 		}
-		// This is not an API call because the permalink is based on the stored post_date value,
+		/*
-		// which should be parsed as local time regardless of the default PHP timezone.
+		 * This is not an API call because the permalink is based on the stored post_date value,
+		 * which should be parsed as local time regardless of the default PHP timezone.
+		 */
 		$date = explode( ' ', str_replace( array( '-', ':' ), ' ', $post->post_date ) );
 		$rewritereplace = array(
 			$date[0],
 			$date[1],
 /**
 * Retrieves the permalink for a post of a custom post type.
 *
 * @since 3.0.0
+* @since 6.1.0 Returns false if the post does not exist.
 *
 * @global WP_Rewrite $wp_rewrite WordPress rewrite component.
 *
-* @param int|WP_Post $id        Optional. Post ID or post object. Default is the global `$post`.
+* @param int|WP_Post $post      Optional. Post ID or post object. Default is the global `$post`.
 * @param bool        $leavename Optional. Whether to keep post name. Default false.
 * @param bool        $sample    Optional. Is it a sample permalink. Default false.
-* @return string|WP_Error The post permalink.
+* @return string|false The post permalink URL. False if the post does not exist.
 */
-function get_post_permalink( $id = 0, $leavename = false, $sample = false ) {
+function get_post_permalink( $post = 0, $leavename = false, $sample = false ) {
 	global $wp_rewrite;
-	$post = get_post( $id );
+	$post = get_post( $post );
-	if ( is_wp_error( $post ) ) {
+	if ( ! $post ) {
-		return $post;
+		return false;
 	}
 	$post_link = $wp_rewrite->get_extra_permastruct( $post->post_type );
 	$slug = $post->post_name;
 * @return string The page permalink.
 */
 function get_page_link( $post = false, $leavename = false, $sample = false ) {
 	$post = get_post( $post );
-	if ( 'page' === get_option( 'show_on_front' ) && get_option( 'page_on_front' ) == $post->ID ) {
+	if ( 'page' === get_option( 'show_on_front' ) && (int) get_option( 'page_on_front' ) === $post->ID ) {
 		$link = home_url( '/' );
 	} else {
 		$link = _get_page_link( $post, $leavename, $sample );
 	}
 *
 * @since 2.0.0
 *
 * @global WP_Rewrite $wp_rewrite WordPress rewrite component.
 *
-* @param int|object $post      Optional. Post ID or object. Default uses the global `$post`.
+* @param int|WP_Post $post      Optional. Post ID or object. Default uses the global `$post`.
-* @param bool       $leavename Optional. Whether to keep the page name. Default false.
+* @param bool        $leavename Optional. Whether to keep the page name. Default false.
 * @return string The attachment permalink.
 */
 function get_attachment_link( $post = null, $leavename = false ) {
 	global $wp_rewrite;
 			$parentlink = _get_page_link( $post->post_parent ); // Ignores page_on_front.
 		} else {
 			$parentlink = get_permalink( $post->post_parent );
 		}
-		if ( is_numeric( $post->post_name ) || false !== strpos( get_option( 'permalink_structure' ), '%category%' ) ) {
+		if ( is_numeric( $post->post_name ) || str_contains( get_option( 'permalink_structure' ), '%category%' ) ) {
 			$name = 'attachment/' . $post->post_name; // <permalink>/<int>/ is paged so we use the explicit attachment marker.
 		} else {
 			$name = $post->post_name;
 		}
-		if ( strpos( $parentlink, '?' ) === false ) {
+		if ( ! str_contains( $parentlink, '?' ) ) {
 			$link = user_trailingslashit( trailingslashit( $parentlink ) . '%postname%' );
 		}
 		if ( ! $leavename ) {
 			$link = str_replace( '%postname%', $name, $link );
 	global $wp_rewrite;
 	$permalink = $wp_rewrite->get_feed_permastruct();
 	if ( $permalink ) {
-		if ( false !== strpos( $feed, 'comments_' ) ) {
+		if ( str_contains( $feed, 'comments_' ) ) {
 			$feed      = str_replace( 'comments_', '', $feed );
 			$permalink = $wp_rewrite->get_comment_feed_permastruct();
 		}
-		if ( get_default_feed() == $feed ) {
+		if ( get_default_feed() === $feed ) {
 			$feed = '';
 		}
 		$permalink = str_replace( '%feed%', $feed, $permalink );
 		$permalink = preg_replace( '#/+#', '/', "/$permalink" );
 	} else {
 		if ( empty( $feed ) ) {
 			$feed = get_default_feed();
 		}
-		if ( false !== strpos( $feed, 'comments_' ) ) {
+		if ( str_contains( $feed, 'comments_' ) ) {
 			$feed = str_replace( 'comments_', 'comments-', $feed );
 		}
 		$output = home_url( "?feed={$feed}" );
 	}
 	}
 	$unattached = 'attachment' === $post->post_type && 0 === (int) $post->post_parent;
 	if ( get_option( 'permalink_structure' ) ) {
-		if ( 'page' === get_option( 'show_on_front' ) && get_option( 'page_on_front' ) == $post_id ) {
+		if ( 'page' === get_option( 'show_on_front' ) && (int) get_option( 'page_on_front' ) === $post_id ) {
 			$url = _get_page_link( $post_id );
 		} else {
 			$url = get_permalink( $post_id );
 		}
 				$url .= "$feed/";
 			}
 			$url = add_query_arg( 'attachment_id', $post_id, $url );
 		} else {
 			$url = trailingslashit( $url ) . 'feed';
-			if ( get_default_feed() != $feed ) {
+			if ( get_default_feed() !== $feed ) {
 				$url .= "/$feed";
 			}
 			$url = user_trailingslashit( $url, 'single_feed' );
 		}
 	} else {
 	if ( ! $permalink_structure ) {
 		$link = home_url( "?feed=$feed&amp;author=" . $author_id );
 	} else {
 		$link = get_author_posts_url( $author_id );
-		if ( get_default_feed() == $feed ) {
+		if ( get_default_feed() === $feed ) {
 			$feed_link = 'feed';
 		} else {
 			$feed_link = "feed/$feed";
 		}
 			$t    = get_taxonomy( $taxonomy );
 			$link = home_url( "?feed=$feed&amp;$t->query_var=$term->slug" );
 		}
 	} else {
 		$link = get_term_link( $term, $term->taxonomy );
-		if ( get_default_feed() == $feed ) {
+		if ( get_default_feed() === $feed ) {
 			$feed_link = 'feed';
 		} else {
 			$feed_link = "feed/$feed";
 		}
 /**
 * Displays or retrieves the edit term link with formatting.
 *
 * @since 3.1.0
 *
-* @param string           $link   Optional. Anchor text. If empty, default is 'Edit This'. Default empty.
+* @param string           $link    Optional. Anchor text. If empty, default is 'Edit This'. Default empty.
-* @param string           $before Optional. Display before edit link. Default empty.
+* @param string           $before  Optional. Display before edit link. Default empty.
-* @param string           $after  Optional. Display after edit link. Default empty.
+* @param string           $after   Optional. Display after edit link. Default empty.
-* @param int|WP_Term|null $term   Optional. Term ID or object. If null, the queried object will be inspected. Default null.
+* @param int|WP_Term|null $term    Optional. Term ID or object. If null, the queried object will be inspected. Default null.
-* @param bool             $echo   Optional. Whether or not to echo the return. Default true.
+* @param bool             $display Optional. Whether or not to echo the return. Default true.
 * @return string|void HTML content.
 */
-function edit_term_link( $link = '', $before = '', $after = '', $term = null, $echo = true ) {
+function edit_term_link( $link = '', $before = '', $after = '', $term = null, $display = true ) {
 	if ( is_null( $term ) ) {
 		$term = get_queried_object();
 	} else {
 		$term = get_term( $term );
 	}
 	 * @param string $link    The anchor tag for the edit link.
 	 * @param int    $term_id Term ID.
 	 */
 	$link = $before . apply_filters( 'edit_term_link', $link, $term->term_id ) . $after;
-	if ( $echo ) {
+	if ( $display ) {
 		echo $link;
 	} else {
 		return $link;
 	}
 }
 */
 function get_post_type_archive_link( $post_type ) {
 	global $wp_rewrite;
 	$post_type_obj = get_post_type_object( $post_type );
 	if ( ! $post_type_obj ) {
 		return false;
 	}
 	if ( 'post' === $post_type ) {
 	$post_type_obj = get_post_type_object( $post_type );
 	if ( get_option( 'permalink_structure' ) && is_array( $post_type_obj->rewrite ) && $post_type_obj->rewrite['feeds'] ) {
 		$link  = trailingslashit( $link );
 		$link .= 'feed/';
-		if ( $feed != $default_feed ) {
+		if ( $feed !== $default_feed ) {
 			$link .= "$feed/";
 		}
 	} else {
 		$link = add_query_arg( 'feed', $feed, $link );
 	}
 *                                  post permalink. Default empty.
 * @return string|null URL used for the post preview, or null if the post does not exist.
 */
 function get_preview_post_link( $post = null, $query_args = array(), $preview_link = '' ) {
 	$post = get_post( $post );
 	if ( ! $post ) {
 		return;
 	}
 	$post_type_object = get_post_type_object( $post->post_type );
 /**
 * Retrieves the edit post link for post.
 *
 * Can be used within the WordPress loop or outside of it. Can be used with
-* pages, posts, attachments, and revisions.
+* pages, posts, attachments, revisions, global styles, templates, and template parts.
 *
 * @since 2.3.0
-*
+* @since 6.3.0 Adds custom link for wp_navigation post types.
-* @param int|WP_Post $id      Optional. Post ID or post object. Default is the global `$post`.
+*              Adds custom links for wp_template_part and wp_template post types.
+*
+* @param int|WP_Post $post    Optional. Post ID or post object. Default is the global `$post`.
 * @param string      $context Optional. How to output the '&' character. Default '&amp;'.
 * @return string|null The edit post link for the given post. Null if the post type does not exist
 *                     or does not allow an editing UI.
 */
-function get_edit_post_link( $id = 0, $context = 'display' ) {
+function get_edit_post_link( $post = 0, $context = 'display' ) {
-	$post = get_post( $id );
+	$post = get_post( $post );
 	if ( ! $post ) {
 		return;
 	}
 	if ( 'revision' === $post->post_type ) {
 	} else {
 		$action = '&action=edit';
 	}
 	$post_type_object = get_post_type_object( $post->post_type );
 	if ( ! $post_type_object ) {
 		return;
 	}
 	if ( ! current_user_can( 'edit_post', $post->ID ) ) {
 		return;
 	}
-	if ( $post_type_object->_edit_link ) {
+	$link = '';
+	if ( 'wp_template' === $post->post_type || 'wp_template_part' === $post->post_type ) {
+		$slug = urlencode( get_stylesheet() . '//' . $post->post_name );
+		$link = admin_url( sprintf( $post_type_object->_edit_link, $post->post_type, $slug ) );
+	} elseif ( 'wp_navigation' === $post->post_type ) {
+		$link = admin_url( sprintf( $post_type_object->_edit_link, (string) $post->ID ) );
+	} elseif ( $post_type_object->_edit_link ) {
 		$link = admin_url( sprintf( $post_type_object->_edit_link . $action, $post->ID ) );
-	} else {
-		$link = '';
 	}
 	/**
 	 * Filters the post edit link.
 	 *
 /**
 * Displays the edit post link for post.
 *
 * @since 1.0.0
-* @since 4.4.0 The `$class` argument was added.
+* @since 4.4.0 The `$css_class` argument was added.
 *
-* @param string      $text   Optional. Anchor text. If null, default is 'Edit This'. Default null.
+* @param string      $text      Optional. Anchor text. If null, default is 'Edit This'. Default null.
-* @param string      $before Optional. Display before edit link. Default empty.
+* @param string      $before    Optional. Display before edit link. Default empty.
-* @param string      $after  Optional. Display after edit link. Default empty.
+* @param string      $after     Optional. Display after edit link. Default empty.
-* @param int|WP_Post $id     Optional. Post ID or post object. Default is the global `$post`.
+* @param int|WP_Post $post      Optional. Post ID or post object. Default is the global `$post`.
-* @param string      $class  Optional. Add custom class to link. Default 'post-edit-link'.
+* @param string      $css_class Optional. Add custom class to link. Default 'post-edit-link'.
 */
-function edit_post_link( $text = null, $before = '', $after = '', $id = 0, $class = 'post-edit-link' ) {
+function edit_post_link( $text = null, $before = '', $after = '', $post = 0, $css_class = 'post-edit-link' ) {
-	$post = get_post( $id );
+	$post = get_post( $post );
 	if ( ! $post ) {
 		return;
 	}
 	$url = get_edit_post_link( $post->ID );
 	if ( ! $url ) {
 		return;
 	}
 	if ( null === $text ) {
 		$text = __( 'Edit This' );
 	}
-	$link = '<a class="' . esc_attr( $class ) . '" href="' . esc_url( $url ) . '">' . $text . '</a>';
+	$link = '<a class="' . esc_attr( $css_class ) . '" href="' . esc_url( $url ) . '">' . $text . '</a>';
 	/**
 	 * Filters the post edit link anchor tag.
 	 *
 	 * @since 2.3.0
 *
 * Can be used within the WordPress loop or outside of it, with any post type.
 *
 * @since 2.9.0
 *
-* @param int|WP_Post $id           Optional. Post ID or post object. Default is the global `$post`.
+* @param int|WP_Post $post         Optional. Post ID or post object. Default is the global `$post`.
 * @param string      $deprecated   Not used.
 * @param bool        $force_delete Optional. Whether to bypass Trash and force deletion. Default false.
 * @return string|void The delete post link URL for the given post.
 */
-function get_delete_post_link( $id = 0, $deprecated = '', $force_delete = false ) {
+function get_delete_post_link( $post = 0, $deprecated = '', $force_delete = false ) {
 	if ( ! empty( $deprecated ) ) {
 		_deprecated_argument( __FUNCTION__, '3.0.0' );
 	}
-	$post = get_post( $id );
+	$post = get_post( $post );
 	if ( ! $post ) {
 		return;
 	}
 	$post_type_object = get_post_type_object( $post->post_type );
 	if ( ! $post_type_object ) {
 		return;
 	}
 	if ( ! current_user_can( 'delete_post', $post->ID ) ) {
 	if ( ! $user ) {
 		return '';
 	}
-	if ( get_current_user_id() == $user->ID ) {
+	if ( get_current_user_id() === $user->ID ) {
 		$link = get_edit_profile_url( $user->ID );
 	} else {
 		$link = add_query_arg( 'user_id', $user->ID, self_admin_url( 'user-edit.php' ) );
 	}
 /**
 * Retrieves the previous post that is adjacent to the current post.
 *
 * @since 1.5.0
 *
-* @param bool         $in_same_term   Optional. Whether post should be in a same taxonomy term. Default false.
+* @param bool         $in_same_term   Optional. Whether post should be in the same taxonomy term.
-* @param int[]|string $excluded_terms Optional. Array or comma-separated list of excluded term IDs. Default empty.
+*                                     Default false.
-* @param string       $taxonomy       Optional. Taxonomy, if $in_same_term is true. Default 'category'.
+* @param int[]|string $excluded_terms Optional. Array or comma-separated list of excluded term IDs.
-* @return WP_Post|null|string Post object if successful. Null if global $post is not set. Empty string if no
+*                                     Default empty.
-*                             corresponding post exists.
+* @param string       $taxonomy       Optional. Taxonomy, if `$in_same_term` is true. Default 'category'.
+* @return WP_Post|null|string Post object if successful. Null if global `$post` is not set.
+*                             Empty string if no corresponding post exists.
 */
 function get_previous_post( $in_same_term = false, $excluded_terms = '', $taxonomy = 'category' ) {
 	return get_adjacent_post( $in_same_term, $excluded_terms, true, $taxonomy );
 }
 /**
 * Retrieves the next post that is adjacent to the current post.
 *
 * @since 1.5.0
 *
-* @param bool         $in_same_term   Optional. Whether post should be in a same taxonomy term. Default false.
+* @param bool         $in_same_term   Optional. Whether post should be in the same taxonomy term.
-* @param int[]|string $excluded_terms Optional. Array or comma-separated list of excluded term IDs. Default empty.
+*                                     Default false.
-* @param string       $taxonomy       Optional. Taxonomy, if $in_same_term is true. Default 'category'.
+* @param int[]|string $excluded_terms Optional. Array or comma-separated list of excluded term IDs.
-* @return WP_Post|null|string Post object if successful. Null if global $post is not set. Empty string if no
+*                                     Default empty.
-*                             corresponding post exists.
+* @param string       $taxonomy       Optional. Taxonomy, if `$in_same_term` is true. Default 'category'.
+* @return WP_Post|null|string Post object if successful. Null if global `$post` is not set.
+*                             Empty string if no corresponding post exists.
 */
 function get_next_post( $in_same_term = false, $excluded_terms = '', $taxonomy = 'category' ) {
 	return get_adjacent_post( $in_same_term, $excluded_terms, false, $taxonomy );
 }
 *
 * @since 2.5.0
 *
 * @global wpdb $wpdb WordPress database abstraction object.
 *
-* @param bool         $in_same_term   Optional. Whether post should be in a same taxonomy term. Default false.
+* @param bool         $in_same_term   Optional. Whether post should be in the same taxonomy term.
-* @param int[]|string $excluded_terms Optional. Array or comma-separated list of excluded term IDs. Default empty string.
+*                                     Default false.
-* @param bool         $previous       Optional. Whether to retrieve previous post. Default true
+* @param int[]|string $excluded_terms Optional. Array or comma-separated list of excluded term IDs.
-* @param string       $taxonomy       Optional. Taxonomy, if $in_same_term is true. Default 'category'.
+*                                     Default empty string.
-* @return WP_Post|null|string Post object if successful. Null if global $post is not set. Empty string if no
+* @param bool         $previous       Optional. Whether to retrieve previous post.
-*                             corresponding post exists.
+*                                     Default true.
+* @param string       $taxonomy       Optional. Taxonomy, if `$in_same_term` is true. Default 'category'.
+* @return WP_Post|null|string Post object if successful. Null if global `$post` is not set.
+*                             Empty string if no corresponding post exists.
 */
 function get_adjacent_post( $in_same_term = false, $excluded_terms = '', $previous = true, $taxonomy = 'category' ) {
 	global $wpdb;
 	$post = get_post();
 	if ( ! $post || ! taxonomy_exists( $taxonomy ) ) {
 		return null;
 	}
 	$current_post_date = $post->post_date;
 	$where    = '';
 	$adjacent = $previous ? 'previous' : 'next';
 	if ( ! empty( $excluded_terms ) && ! is_array( $excluded_terms ) ) {
 		// Back-compat, $excluded_terms used to be $excluded_categories with IDs separated by " and ".
-		if ( false !== strpos( $excluded_terms, ' and ' ) ) {
+		if ( str_contains( $excluded_terms, ' and ' ) ) {
 			_deprecated_argument(
 				__FUNCTION__,
 				'3.3.0',
 				sprintf(
 					/* translators: %s: The word 'and'. */
 	 *  - `get_next_post_excluded_terms`
 	 *  - `get_previous_post_excluded_terms`
 	 *
 	 * @since 4.4.0
 	 *
-	 * @param array|string $excluded_terms Array of excluded term IDs. Empty string if none were provided.
+	 * @param int[]|string $excluded_terms Array of excluded term IDs. Empty string if none were provided.
 	 */
 	$excluded_terms = apply_filters( "get_{$adjacent}_post_excluded_terms", $excluded_terms );
 	if ( $in_same_term || ! empty( $excluded_terms ) ) {
 		if ( $in_same_term ) {
 	 *  - `get_previous_post_join`
 	 *
 	 * @since 2.5.0
 	 * @since 4.4.0 Added the `$taxonomy` and `$post` parameters.
 	 *
-	 * @param string  $join           The JOIN clause in the SQL.
+	 * @param string       $join           The JOIN clause in the SQL.
-	 * @param bool    $in_same_term   Whether post should be in a same taxonomy term.
+	 * @param bool         $in_same_term   Whether post should be in the same taxonomy term.
-	 * @param array   $excluded_terms Array of excluded term IDs.
+	 * @param int[]|string $excluded_terms Array of excluded term IDs. Empty string if none were provided.
-	 * @param string  $taxonomy       Taxonomy. Used to identify the term used when `$in_same_term` is true.
+	 * @param string       $taxonomy       Taxonomy. Used to identify the term used when `$in_same_term` is true.
-	 * @param WP_Post $post           WP_Post object.
+	 * @param WP_Post      $post           WP_Post object.
 	 */
 	$join = apply_filters( "get_{$adjacent}_post_join", $join, $in_same_term, $excluded_terms, $taxonomy, $post );
 	/**
 	 * Filters the WHERE clause in the SQL for an adjacent post query.
 	 *  - `get_previous_post_where`
 	 *
 	 * @since 2.5.0
 	 * @since 4.4.0 Added the `$taxonomy` and `$post` parameters.
 	 *
-	 * @param string  $where          The `WHERE` clause in the SQL.
+	 * @param string       $where          The `WHERE` clause in the SQL.
-	 * @param bool    $in_same_term   Whether post should be in a same taxonomy term.
+	 * @param bool         $in_same_term   Whether post should be in the same taxonomy term.
-	 * @param array   $excluded_terms Array of excluded term IDs.
+	 * @param int[]|string $excluded_terms Array of excluded term IDs. Empty string if none were provided.
-	 * @param string  $taxonomy       Taxonomy. Used to identify the term used when `$in_same_term` is true.
+	 * @param string       $taxonomy       Taxonomy. Used to identify the term used when `$in_same_term` is true.
-	 * @param WP_Post $post           WP_Post object.
+	 * @param WP_Post      $post           WP_Post object.
 	 */
 	$where = apply_filters( "get_{$adjacent}_post_where", $wpdb->prepare( "WHERE p.post_date $op %s AND p.post_type = %s $where", $current_post_date, $post->post_type ), $in_same_term, $excluded_terms, $taxonomy, $post );
 	/**
 	 * Filters the ORDER BY clause in the SQL for an adjacent post query.
 	 * @param WP_Post $post    WP_Post object.
 	 * @param string  $order   Sort order. 'DESC' for previous post, 'ASC' for next.
 	 */
 	$sort = apply_filters( "get_{$adjacent}_post_sort", "ORDER BY p.post_date $order LIMIT 1", $post, $order );
-	$query     = "SELECT p.ID FROM $wpdb->posts AS p $join $where $sort";
+	$query        = "SELECT p.ID FROM $wpdb->posts AS p $join $where $sort";
-	$query_key = 'adjacent_post_' . md5( $query );
+	$key          = md5( $query );
-	$result    = wp_cache_get( $query_key, 'counts' );
+	$last_changed = wp_cache_get_last_changed( 'posts' );
+	if ( $in_same_term || ! empty( $excluded_terms ) ) {
+		$last_changed .= wp_cache_get_last_changed( 'terms' );
+	}
+	$cache_key = "adjacent_post:$key:$last_changed";
+	$result = wp_cache_get( $cache_key, 'post-queries' );
 	if ( false !== $result ) {
 		if ( $result ) {
 			$result = get_post( $result );
 		}
 		return $result;
 	$result = $wpdb->get_var( $query );
 	if ( null === $result ) {
 		$result = '';
 	}
-	wp_cache_set( $query_key, $result, 'counts' );
+	wp_cache_set( $cache_key, $result, 'post-queries' );
 	if ( $result ) {
 		$result = get_post( $result );
 	}
 * Can either be next or previous post relational link.
 *
 * @since 2.8.0
 *
 * @param string       $title          Optional. Link title format. Default '%title'.
-* @param bool         $in_same_term   Optional. Whether link should be in a same taxonomy term. Default false.
+* @param bool         $in_same_term   Optional. Whether link should be in the same taxonomy term.
-* @param int[]|string $excluded_terms Optional. Array or comma-separated list of excluded term IDs. Default empty.
+*                                     Default false.
-* @param bool         $previous       Optional. Whether to display link to previous or next post. Default true.
+* @param int[]|string $excluded_terms Optional. Array or comma-separated list of excluded term IDs.
-* @param string       $taxonomy       Optional. Taxonomy, if $in_same_term is true. Default 'category'.
+*                                     Default empty.
+* @param bool         $previous       Optional. Whether to display link to previous or next post.
+*                                     Default true.
+* @param string       $taxonomy       Optional. Taxonomy, if `$in_same_term` is true. Default 'category'.
 * @return string|void The adjacent post relational link URL.
 */
 function get_adjacent_post_rel_link( $title = '%title', $in_same_term = false, $excluded_terms = '', $previous = true, $taxonomy = 'category' ) {
 	$post = get_post();
 	if ( $previous && is_attachment() && $post ) {
 * Displays the relational links for the posts adjacent to the current post.
 *
 * @since 2.8.0
 *
 * @param string       $title          Optional. Link title format. Default '%title'.
-* @param bool         $in_same_term   Optional. Whether link should be in a same taxonomy term. Default false.
+* @param bool         $in_same_term   Optional. Whether link should be in the same taxonomy term.
-* @param int[]|string $excluded_terms Optional. Array or comma-separated list of excluded term IDs. Default empty.
+*                                     Default false.
-* @param string       $taxonomy       Optional. Taxonomy, if $in_same_term is true. Default 'category'.
+* @param int[]|string $excluded_terms Optional. Array or comma-separated list of excluded term IDs.
+*                                     Default empty.
+* @param string       $taxonomy       Optional. Taxonomy, if `$in_same_term` is true. Default 'category'.
 */
 function adjacent_posts_rel_link( $title = '%title', $in_same_term = false, $excluded_terms = '', $taxonomy = 'category' ) {
 	echo get_adjacent_post_rel_link( $title, $in_same_term, $excluded_terms, true, $taxonomy );
 	echo get_adjacent_post_rel_link( $title, $in_same_term, $excluded_terms, false, $taxonomy );
 }
 * @since 2.8.0
 *
 * @see get_adjacent_post_rel_link()
 *
 * @param string       $title          Optional. Link title format. Default '%title'.
-* @param bool         $in_same_term   Optional. Whether link should be in a same taxonomy term. Default false.
+* @param bool         $in_same_term   Optional. Whether link should be in the same taxonomy term.
-* @param int[]|string $excluded_terms Optional. Array or comma-separated list of excluded term IDs. Default empty.
-* @param string       $taxonomy       Optional. Taxonomy, if $in_same_term is true. Default 'category'.
-*/
-function next_post_rel_link( $title = '%title', $in_same_term = false, $excluded_terms = '', $taxonomy = 'category' ) {
-	echo get_adjacent_post_rel_link( $title, $in_same_term, $excluded_terms, false, $taxonomy );
-}
-/**
-* Displays the relational link for the previous post adjacent to the current post.
-*
-* @since 2.8.0
-*
-* @see get_adjacent_post_rel_link()
-*
-* @param string       $title          Optional. Link title format. Default '%title'.
-* @param bool         $in_same_term   Optional. Whether link should be in a same taxonomy term. Default false.
-* @param int[]|string $excluded_terms Optional. Array or comma-separated list of excluded term IDs. Default true.
-* @param string       $taxonomy       Optional. Taxonomy, if $in_same_term is true. Default 'category'.
-*/
-function prev_post_rel_link( $title = '%title', $in_same_term = false, $excluded_terms = '', $taxonomy = 'category' ) {
-	echo get_adjacent_post_rel_link( $title, $in_same_term, $excluded_terms, true, $taxonomy );
-}
-/**
-* Retrieves the boundary post.
-*
-* Boundary being either the first or last post by publish date within the constraints specified
-* by $in_same_term or $excluded_terms.
-*
-* @since 2.8.0
-*
-* @param bool         $in_same_term   Optional. Whether returned post should be in a same taxonomy term.
 *                                     Default false.
 * @param int[]|string $excluded_terms Optional. Array or comma-separated list of excluded term IDs.
 *                                     Default empty.
-* @param bool         $start          Optional. Whether to retrieve first or last post. Default true
+* @param string       $taxonomy       Optional. Taxonomy, if `$in_same_term` is true. Default 'category'.
-* @param string       $taxonomy       Optional. Taxonomy, if $in_same_term is true. Default 'category'.
+*/
-* @return null|array Array containing the boundary post object if successful, null otherwise.
+function next_post_rel_link( $title = '%title', $in_same_term = false, $excluded_terms = '', $taxonomy = 'category' ) {
+	echo get_adjacent_post_rel_link( $title, $in_same_term, $excluded_terms, false, $taxonomy );
+}
+/**
+* Displays the relational link for the previous post adjacent to the current post.
+*
+* @since 2.8.0
+*
+* @see get_adjacent_post_rel_link()
+*
+* @param string       $title          Optional. Link title format. Default '%title'.
+* @param bool         $in_same_term   Optional. Whether link should be in the same taxonomy term.
+*                                     Default false.
+* @param int[]|string $excluded_terms Optional. Array or comma-separated list of excluded term IDs.
+*                                     Default true.
+* @param string       $taxonomy       Optional. Taxonomy, if `$in_same_term` is true. Default 'category'.
+*/
+function prev_post_rel_link( $title = '%title', $in_same_term = false, $excluded_terms = '', $taxonomy = 'category' ) {
+	echo get_adjacent_post_rel_link( $title, $in_same_term, $excluded_terms, true, $taxonomy );
+}
+/**
+* Retrieves the boundary post.
+*
+* Boundary being either the first or last post by publish date within the constraints specified
+* by `$in_same_term` or `$excluded_terms`.
+*
+* @since 2.8.0
+*
+* @param bool         $in_same_term   Optional. Whether returned post should be in the same taxonomy term.
+*                                     Default false.
+* @param int[]|string $excluded_terms Optional. Array or comma-separated list of excluded term IDs.
+*                                     Default empty.
+* @param bool         $start          Optional. Whether to retrieve first or last post.
+*                                     Default true.
+* @param string       $taxonomy       Optional. Taxonomy, if `$in_same_term` is true. Default 'category'.
+* @return array|null Array containing the boundary post object if successful, null otherwise.
 */
 function get_boundary_post( $in_same_term = false, $excluded_terms = '', $start = true, $taxonomy = 'category' ) {
 	$post = get_post();
 	if ( ! $post || ! is_single() || is_attachment() || ! taxonomy_exists( $taxonomy ) ) {
 		return null;
 	}
 	$query_args = array(
 *
 * @since 3.7.0
 *
 * @param string       $format         Optional. Link anchor format. Default '&laquo; %link'.
 * @param string       $link           Optional. Link permalink format. Default '%title'.
-* @param bool         $in_same_term   Optional. Whether link should be in a same taxonomy term. Default false.
+* @param bool         $in_same_term   Optional. Whether link should be in the same taxonomy term.
-* @param int[]|string $excluded_terms Optional. Array or comma-separated list of excluded term IDs. Default empty.
+*                                     Default false.
-* @param string       $taxonomy       Optional. Taxonomy, if $in_same_term is true. Default 'category'.
+* @param int[]|string $excluded_terms Optional. Array or comma-separated list of excluded term IDs.
+*                                     Default empty.
+* @param string       $taxonomy       Optional. Taxonomy, if `$in_same_term` is true. Default 'category'.
 * @return string The link URL of the previous post in relation to the current post.
 */
 function get_previous_post_link( $format = '&laquo; %link', $link = '%title', $in_same_term = false, $excluded_terms = '', $taxonomy = 'category' ) {
 	return get_adjacent_post_link( $format, $link, $in_same_term, $excluded_terms, true, $taxonomy );
 }
 *
 * @see get_previous_post_link()
 *
 * @param string       $format         Optional. Link anchor format. Default '&laquo; %link'.
 * @param string       $link           Optional. Link permalink format. Default '%title'.
-* @param bool         $in_same_term   Optional. Whether link should be in a same taxonomy term. Default false.
+* @param bool         $in_same_term   Optional. Whether link should be in the same taxonomy term.
-* @param int[]|string $excluded_terms Optional. Array or comma-separated list of excluded term IDs. Default empty.
+*                                     Default false.
-* @param string       $taxonomy       Optional. Taxonomy, if $in_same_term is true. Default 'category'.
+* @param int[]|string $excluded_terms Optional. Array or comma-separated list of excluded term IDs.
+*                                     Default empty.
+* @param string       $taxonomy       Optional. Taxonomy, if `$in_same_term` is true. Default 'category'.
 */
 function previous_post_link( $format = '&laquo; %link', $link = '%title', $in_same_term = false, $excluded_terms = '', $taxonomy = 'category' ) {
 	echo get_previous_post_link( $format, $link, $in_same_term, $excluded_terms, $taxonomy );
 }
 *
 * @since 3.7.0
 *
 * @param string       $format         Optional. Link anchor format. Default '&laquo; %link'.
 * @param string       $link           Optional. Link permalink format. Default '%title'.
-* @param bool         $in_same_term   Optional. Whether link should be in a same taxonomy term. Default false.
+* @param bool         $in_same_term   Optional. Whether link should be in the same taxonomy term.
-* @param int[]|string $excluded_terms Optional. Array or comma-separated list of excluded term IDs. Default empty.
+*                                     Default false.
-* @param string       $taxonomy       Optional. Taxonomy, if $in_same_term is true. Default 'category'.
+* @param int[]|string $excluded_terms Optional. Array or comma-separated list of excluded term IDs.
+*                                     Default empty.
+* @param string       $taxonomy       Optional. Taxonomy, if `$in_same_term` is true. Default 'category'.
 * @return string The link URL of the next post in relation to the current post.
 */
 function get_next_post_link( $format = '%link &raquo;', $link = '%title', $in_same_term = false, $excluded_terms = '', $taxonomy = 'category' ) {
 	return get_adjacent_post_link( $format, $link, $in_same_term, $excluded_terms, false, $taxonomy );
 }
 * @since 1.5.0
 *
 * @see get_next_post_link()
 *
 * @param string       $format         Optional. Link anchor format. Default '&laquo; %link'.
-* @param string       $link           Optional. Link permalink format. Default '%title'
+* @param string       $link           Optional. Link permalink format. Default '%title'.
-* @param bool         $in_same_term   Optional. Whether link should be in a same taxonomy term. Default false.
+* @param bool         $in_same_term   Optional. Whether link should be in the same taxonomy term.
-* @param int[]|string $excluded_terms Optional. Array or comma-separated list of excluded term IDs. Default empty.
+*                                     Default false.
-* @param string       $taxonomy       Optional. Taxonomy, if $in_same_term is true. Default 'category'.
+* @param int[]|string $excluded_terms Optional. Array or comma-separated list of excluded term IDs.
+*                                     Default empty.
+* @param string       $taxonomy       Optional. Taxonomy, if `$in_same_term` is true. Default 'category'.
 */
 function next_post_link( $format = '%link &raquo;', $link = '%title', $in_same_term = false, $excluded_terms = '', $taxonomy = 'category' ) {
 	echo get_next_post_link( $format, $link, $in_same_term, $excluded_terms, $taxonomy );
 }
 *
 * @since 3.7.0
 *
 * @param string       $format         Link anchor format.
 * @param string       $link           Link permalink format.
-* @param bool         $in_same_term   Optional. Whether link should be in a same taxonomy term. Default false.
+* @param bool         $in_same_term   Optional. Whether link should be in the same taxonomy term.
-* @param int[]|string $excluded_terms Optional. Array or comma-separated list of excluded terms IDs. Default empty.
+*                                     Default false.
-* @param bool         $previous       Optional. Whether to display link to previous or next post. Default true.
+* @param int[]|string $excluded_terms Optional. Array or comma-separated list of excluded terms IDs.
-* @param string       $taxonomy       Optional. Taxonomy, if $in_same_term is true. Default 'category'.
+*                                     Default empty.
+* @param bool         $previous       Optional. Whether to display link to previous or next post.
+*                                     Default true.
+* @param string       $taxonomy       Optional. Taxonomy, if `$in_same_term` is true. Default 'category'.
 * @return string The link URL of the previous or next post in relation to the current post.
 */
 function get_adjacent_post_link( $format, $link, $in_same_term = false, $excluded_terms = '', $previous = true, $taxonomy = 'category' ) {
 	if ( $previous && is_attachment() ) {
 		$post = get_post( get_post()->post_parent );
 	 *  - `previous_post_link`
 	 *
 	 * @since 2.6.0
 	 * @since 4.2.0 Added the `$adjacent` parameter.
 	 *
-	 * @param string  $output   The adjacent post link.
+	 * @param string         $output   The adjacent post link.
-	 * @param string  $format   Link anchor format.
+	 * @param string         $format   Link anchor format.
-	 * @param string  $link     Link permalink format.
+	 * @param string         $link     Link permalink format.
-	 * @param WP_Post $post     The adjacent post.
+	 * @param WP_Post|string $post     The adjacent post. Empty string if no corresponding post exists.
-	 * @param string  $adjacent Whether the post is previous or next.
+	 * @param string         $adjacent Whether the post is previous or next.
 	 */
 	return apply_filters( "{$adjacent}_post_link", $output, $format, $link, $post, $adjacent );
 }
 /**
 *
 * @since 2.5.0
 *
 * @param string       $format         Link anchor format.
 * @param string       $link           Link permalink format.
-* @param bool         $in_same_term   Optional. Whether link should be in a same taxonomy term. Default false.
+* @param bool         $in_same_term   Optional. Whether link should be in the same taxonomy term.
-* @param int[]|string $excluded_terms Optional. Array or comma-separated list of excluded category IDs. Default empty.
+*                                     Default false.
-* @param bool         $previous       Optional. Whether to display link to previous or next post. Default true.
+* @param int[]|string $excluded_terms Optional. Array or comma-separated list of excluded category IDs.
-* @param string       $taxonomy       Optional. Taxonomy, if $in_same_term is true. Default 'category'.
+*                                     Default empty.
+* @param bool         $previous       Optional. Whether to display link to previous or next post.
+*                                     Default true.
+* @param string       $taxonomy       Optional. Taxonomy, if `$in_same_term` is true. Default 'category'.
 */
 function adjacent_post_link( $format, $link, $in_same_term = false, $excluded_terms = '', $previous = true, $taxonomy = 'category' ) {
 	echo get_adjacent_post_link( $format, $link, $in_same_term, $excluded_terms, $previous, $taxonomy );
 }
 * @since 1.5.0
 *
 * @global WP_Rewrite $wp_rewrite WordPress rewrite component.
 *
 * @param int  $pagenum Optional. Page number. Default 1.
-* @param bool $escape  Optional. Whether to escape the URL for display, with esc_url(). Defaults to true.
+* @param bool $escape  Optional. Whether to escape the URL for display, with esc_url().
-*                      Otherwise, prepares the URL with esc_url_raw().
+*                      If set to false, prepares the URL with sanitize_url(). Default true.
 * @return string The link URL for the given page number.
 */
 function get_pagenum_link( $pagenum = 1, $escape = true ) {
 	global $wp_rewrite;
 			$result = $base . $request;
 		}
 	} else {
 		$qs_regex = '|\?.*?$|';
 		preg_match( $qs_regex, $request, $qs_match );
+		$parts   = array();
+		$parts[] = untrailingslashit( get_bloginfo( 'url' ) );
 		if ( ! empty( $qs_match[0] ) ) {
 			$query_string = $qs_match[0];
 			$request      = preg_replace( $qs_regex, '', $request );
 		} else {
 		$request = preg_replace( "|$wp_rewrite->pagination_base/\d+/?$|", '', $request );
 		$request = preg_replace( '|^' . preg_quote( $wp_rewrite->index, '|' ) . '|i', '', $request );
 		$request = ltrim( $request, '/' );
-		$base = trailingslashit( get_bloginfo( 'url' ) );
 		if ( $wp_rewrite->using_index_permalinks() && ( $pagenum > 1 || '' !== $request ) ) {
-			$base .= $wp_rewrite->index . '/';
+			$parts[] = $wp_rewrite->index;
 		}
+		$parts[] = untrailingslashit( $request );
 		if ( $pagenum > 1 ) {
-			$request = ( ( ! empty( $request ) ) ? trailingslashit( $request ) : $request ) . user_trailingslashit( $wp_rewrite->pagination_base . '/' . $pagenum, 'paged' );
+			$parts[] = $wp_rewrite->pagination_base;
-		}
+			$parts[] = $pagenum;
+		}
-		$result = $base . $request . $query_string;
+		$result = user_trailingslashit( implode( '/', array_filter( $parts ) ), 'paged' );
+		if ( ! empty( $query_string ) ) {
+			$result .= $query_string;
+		}
 	}
 	/**
 	 * Filters the page number link for the current request.
 	 *
 	$result = apply_filters( 'get_pagenum_link', $result, $pagenum );
 	if ( $escape ) {
 		return esc_url( $result );
 	} else {
-		return esc_url_raw( $result );
+		return sanitize_url( $result );
 	}
 }
 /**
 * Retrieves the next posts page link.
 	if ( ! is_single() ) {
 		if ( ! $paged ) {
 			$paged = 1;
 		}
-		$nextpage = (int) $paged + 1;
-		if ( ! $max_page || $max_page >= $nextpage ) {
+		$next_page = (int) $paged + 1;
-			return get_pagenum_link( $nextpage );
+		if ( ! $max_page || $max_page >= $next_page ) {
+			return get_pagenum_link( $next_page );
 		}
 	}
 }
 /**
 * Displays or retrieves the next posts page link.
 *
 * @since 0.71
 *
 * @param int  $max_page Optional. Max pages. Default 0.
-* @param bool $echo     Optional. Whether to echo the link. Default true.
+* @param bool $display  Optional. Whether to echo the link. Default true.
-* @return string|void The link URL for next posts page if `$echo = false`.
+* @return string|void The link URL for next posts page if `$display = false`.
 */
-function next_posts( $max_page = 0, $echo = true ) {
+function next_posts( $max_page = 0, $display = true ) {
-	$output = esc_url( get_next_posts_page_link( $max_page ) );
+	$link   = get_next_posts_page_link( $max_page );
+	$output = $link ? esc_url( $link ) : '';
-	if ( $echo ) {
+	if ( $display ) {
 		echo $output;
 	} else {
 		return $output;
 	}
 }
 	if ( ! $paged ) {
 		$paged = 1;
 	}
-	$nextpage = (int) $paged + 1;
+	$next_page = (int) $paged + 1;
 	if ( null === $label ) {
 		$label = __( 'Next Page &raquo;' );
 	}
-	if ( ! is_single() && ( $nextpage <= $max_page ) ) {
+	if ( ! is_single() && ( $next_page <= $max_page ) ) {
 		/**
 		 * Filters the anchor tag attributes for the next posts page link.
 		 *
 		 * @since 2.7.0
 		 *
 		 * @param string $attributes Attributes for the anchor tag.
 		 */
 		$attr = apply_filters( 'next_posts_link_attributes', '' );
-		return '<a href="' . next_posts( $max_page, false ) . "\" $attr>" . preg_replace( '/&([^#])(?![a-z]{1,8};)/i', '&#038;$1', $label ) . '</a>';
+		return sprintf(
+			'<a href="%1$s" %2$s>%3$s</a>',
+			next_posts( $max_page, false ),
+			$attr,
+			preg_replace( '/&([^#])(?![a-z]{1,8};)/i', '&#038;$1', $label )
+		);
 	}
 }
 /**
 * Displays the next posts page link.
 */
 function get_previous_posts_page_link() {
 	global $paged;
 	if ( ! is_single() ) {
-		$nextpage = (int) $paged - 1;
+		$previous_page = (int) $paged - 1;
-		if ( $nextpage < 1 ) {
-			$nextpage = 1;
+		if ( $previous_page < 1 ) {
-		}
+			$previous_page = 1;
-		return get_pagenum_link( $nextpage );
+		}
+		return get_pagenum_link( $previous_page );
 	}
 }
 /**
 * Displays or retrieves the previous posts page link.
 *
 * @since 0.71
 *
-* @param bool $echo Optional. Whether to echo the link. Default true.
+* @param bool $display Optional. Whether to echo the link. Default true.
-* @return string|void The previous posts page link if `$echo = false`.
+* @return string|void The previous posts page link if `$display = false`.
 */
-function previous_posts( $echo = true ) {
+function previous_posts( $display = true ) {
 	$output = esc_url( get_previous_posts_page_link() );
-	if ( $echo ) {
+	if ( $display ) {
 		echo $output;
 	} else {
 		return $output;
 	}
 }
 		 * @since 2.7.0
 		 *
 		 * @param string $attributes Attributes for the anchor tag.
 		 */
 		$attr = apply_filters( 'previous_posts_link_attributes', '' );
-		return '<a href="' . previous_posts( false ) . "\" $attr>" . preg_replace( '/&([^#])(?![a-z]{1,8};)/i', '&#038;$1', $label ) . '</a>';
+		return sprintf(
+			'<a href="%1$s" %2$s>%3$s</a>',
+			previous_posts( false ),
+			$attr,
+			preg_replace( '/&([^#])(?![a-z]{1,8};)/i', '&#038;$1', $label )
+		);
 	}
 }
 /**
 * Displays the previous posts page link.
 			$return .= preg_replace( '/&([^#])(?![a-z]{1,8};)/i', '&#038;$1', $args['sep'] );
 			$return .= get_next_posts_link( $args['nxtlabel'] );
 		}
 	}
 	return $return;
 }
 /**
 * Displays the post pages link navigation for previous and next pages.
 *
 * @since 5.5.0 Added the `class` parameter.
 *
 * @param array $args {
 *     Optional. Default post navigation arguments. Default empty array.
 *
-*     @type string       $prev_text          Anchor text to display in the previous post link. Default '%title'.
+*     @type string       $prev_text          Anchor text to display in the previous post link.
-*     @type string       $next_text          Anchor text to display in the next post link. Default '%title'.
+*                                            Default '%title'.
-*     @type bool         $in_same_term       Whether link should be in a same taxonomy term. Default false.
+*     @type string       $next_text          Anchor text to display in the next post link.
-*     @type int[]|string $excluded_terms     Array or comma-separated list of excluded term IDs. Default empty.
+*                                            Default '%title'.
+*     @type bool         $in_same_term       Whether link should be in the same taxonomy term.
+*                                            Default false.
+*     @type int[]|string $excluded_terms     Array or comma-separated list of excluded term IDs.
+*                                            Default empty.
 *     @type string       $taxonomy           Taxonomy, if `$in_same_term` is true. Default 'category'.
-*     @type string       $screen_reader_text Screen reader text for the nav element. Default 'Post navigation'.
+*     @type string       $screen_reader_text Screen reader text for the nav element.
+*                                            Default 'Post navigation'.
 *     @type string       $aria_label         ARIA label text for the nav element. Default 'Posts'.
 *     @type string       $class              Custom class for the nav element. Default 'post-navigation'.
 * }
 * @return string Markup for post links.
 */
 *     @type string $class              Custom class for the nav element. Default 'posts-navigation'.
 * }
 * @return string Markup for posts links.
 */
 function get_the_posts_navigation( $args = array() ) {
+	global $wp_query;
 	$navigation = '';
 	// Don't print empty markup if there's only one page.
-	if ( $GLOBALS['wp_query']->max_num_pages > 1 ) {
+	if ( $wp_query->max_num_pages > 1 ) {
 		// Make sure the nav element has an aria-label attribute: fallback to the screen reader text.
 		if ( ! empty( $args['screen_reader_text'] ) && empty( $args['aria_label'] ) ) {
 			$args['aria_label'] = $args['screen_reader_text'];
 		}
 *
 * @since 4.1.0
 * @since 5.3.0 Added the `aria_label` parameter.
 * @since 5.5.0 Added the `class` parameter.
 *
+* @global WP_Query $wp_query WordPress Query object.
+*
 * @param array $args {
 *     Optional. Default pagination arguments, see paginate_links().
 *
 *     @type string $screen_reader_text Screen reader text for navigation element.
 *                                      Default 'Posts navigation'.
 *     @type string $class              Custom class for the nav element. Default 'pagination'.
 * }
 * @return string Markup for pagination links.
 */
 function get_the_posts_pagination( $args = array() ) {
+	global $wp_query;
 	$navigation = '';
 	// Don't print empty markup if there's only one page.
-	if ( $GLOBALS['wp_query']->max_num_pages > 1 ) {
+	if ( $wp_query->max_num_pages > 1 ) {
 		// Make sure the nav element has an aria-label attribute: fallback to the screen reader text.
 		if ( ! empty( $args['screen_reader_text'] ) && empty( $args['aria_label'] ) ) {
 			$args['aria_label'] = $args['screen_reader_text'];
 		}
 				'aria_label'         => __( 'Posts' ),
 				'class'              => 'pagination',
 			)
 		);
+		/**
+		 * Filters the arguments for posts pagination links.
+		 *
+		 * @since 6.1.0
+		 *
+		 * @param array $args {
+		 *     Optional. Default pagination arguments, see paginate_links().
+		 *
+		 *     @type string $screen_reader_text Screen reader text for navigation element.
+		 *                                      Default 'Posts navigation'.
+		 *     @type string $aria_label         ARIA label text for the nav element. Default 'Posts'.
+		 *     @type string $class              Custom class for the nav element. Default 'pagination'.
+		 * }
+		 */
+		$args = apply_filters( 'the_posts_pagination_args', $args );
 		// Make sure we get a string back. Plain is the next best thing.
 		if ( isset( $args['type'] ) && 'array' === $args['type'] ) {
 			$args['type'] = 'plain';
 		}
 * @since 4.1.0
 * @since 5.3.0 Added the `aria_label` parameter.
 * @access private
 *
 * @param string $links              Navigational links.
-* @param string $class              Optional. Custom class for the nav element.
+* @param string $css_class          Optional. Custom class for the nav element.
 *                                   Default 'posts-navigation'.
 * @param string $screen_reader_text Optional. Screen reader text for the nav element.
 *                                   Default 'Posts navigation'.
 * @param string $aria_label         Optional. ARIA label for the nav element.
 *                                   Defaults to the value of `$screen_reader_text`.
 * @return string Navigation template tag.
 */
-function _navigation_markup( $links, $class = 'posts-navigation', $screen_reader_text = '', $aria_label = '' ) {
+function _navigation_markup( $links, $css_class = 'posts-navigation', $screen_reader_text = '', $aria_label = '' ) {
 	if ( empty( $screen_reader_text ) ) {
-		$screen_reader_text = __( 'Posts navigation' );
+		$screen_reader_text = /* translators: Hidden accessibility text. */ __( 'Posts navigation' );
 	}
 	if ( empty( $aria_label ) ) {
 		$aria_label = $screen_reader_text;
 	}
 	 *         <div class="nav-links">%3$s</div>
 	 *     </nav>
 	 *
 	 * @since 4.4.0
 	 *
-	 * @param string $template The default template.
+	 * @param string $template  The default template.
-	 * @param string $class    The class passed by the calling function.
+	 * @param string $css_class The class passed by the calling function.
 	 * @return string Navigation template.
 	 */
-	$template = apply_filters( 'navigation_markup_template', $template, $class );
+	$template = apply_filters( 'navigation_markup_template', $template, $css_class );
-	return sprintf( $template, sanitize_html_class( $class ), esc_html( $screen_reader_text ), $links, esc_html( $aria_label ) );
+	return sprintf( $template, sanitize_html_class( $css_class ), esc_html( $screen_reader_text ), $links, esc_attr( $aria_label ) );
 }
 /**
 * Retrieves the comments page number link.
 *
 * @return string The comments page number link URL.
 */
 function get_comments_pagenum_link( $pagenum = 1, $max_page = 0 ) {
 	global $wp_rewrite;
-	$pagenum = (int) $pagenum;
+	$pagenum  = (int) $pagenum;
+	$max_page = (int) $max_page;
 	$result = get_permalink();
 	if ( 'newest' === get_option( 'default_comments_page' ) ) {
-		if ( $pagenum != $max_page ) {
+		if ( $pagenum !== $max_page ) {
 			if ( $wp_rewrite->using_permalinks() ) {
 				$result = user_trailingslashit( trailingslashit( $result ) . $wp_rewrite->comments_pagination_base . '-' . $pagenum, 'commentpaged' );
 			} else {
 				$result = add_query_arg( 'cpage', $pagenum, $result );
 			}
 	if ( ! $page ) {
 		$page = 1;
 	}
-	$nextpage = (int) $page + 1;
+	$next_page = (int) $page + 1;
 	if ( empty( $max_page ) ) {
 		$max_page = $wp_query->max_num_comment_pages;
 	}
 	if ( empty( $max_page ) ) {
 		$max_page = get_comment_pages_count();
 	}
-	if ( $nextpage > $max_page ) {
+	if ( $next_page > $max_page ) {
 		return;
 	}
 	if ( empty( $label ) ) {
 		$label = __( 'Newer Comments &raquo;' );
 	 *
 	 * @since 2.7.0
 	 *
 	 * @param string $attributes Attributes for the anchor tag.
 	 */
-	return '<a href="' . esc_url( get_comments_pagenum_link( $nextpage, $max_page ) ) . '" ' . apply_filters( 'next_comments_link_attributes', '' ) . '>' . preg_replace( '/&([^#])(?![a-z]{1,8};)/i', '&#038;$1', $label ) . '</a>';
+	$attr = apply_filters( 'next_comments_link_attributes', '' );
+	return sprintf(
+		'<a href="%1$s" %2$s>%3$s</a>',
+		esc_url( get_comments_pagenum_link( $next_page, $max_page ) ),
+		$attr,
+		preg_replace( '/&([^#])(?![a-z]{1,8};)/i', '&#038;$1', $label )
+	);
 }
 /**
 * Displays the link to the next comments page.
 *
 	if ( (int) $page <= 1 ) {
 		return;
 	}
-	$prevpage = (int) $page - 1;
+	$previous_page = (int) $page - 1;
 	if ( empty( $label ) ) {
 		$label = __( '&laquo; Older Comments' );
 	}
 	 *
 	 * @since 2.7.0
 	 *
 	 * @param string $attributes Attributes for the anchor tag.
 	 */
-	return '<a href="' . esc_url( get_comments_pagenum_link( $prevpage ) ) . '" ' . apply_filters( 'previous_comments_link_attributes', '' ) . '>' . preg_replace( '/&([^#])(?![a-z]{1,8};)/i', '&#038;$1', $label ) . '</a>';
+	$attr = apply_filters( 'previous_comments_link_attributes', '' );
+	return sprintf(
+		'<a href="%1$s" %2$s>%3$s</a>',
+		esc_url( get_comments_pagenum_link( $previous_page ) ),
+		$attr,
+		preg_replace( '/&([^#])(?![a-z]{1,8};)/i', '&#038;$1', $label )
+	);
 }
 /**
 * Displays the link to the previous comments page.
 *
 /**
 * Retrieves the URL to the admin area for the current site.
 *
 * @since 2.6.0
 *
-* @param string $path   Optional. Path relative to the admin URL. Default 'admin'.
+* @param string $path   Optional. Path relative to the admin URL. Default empty.
 * @param string $scheme The scheme to use. Default is 'admin', which obeys force_ssl_admin() and is_ssl().
 *                       'http' or 'https' can be passed to force those schemes.
 * @return string Admin URL link with optional path appended.
 */
 function admin_url( $path = '', $scheme = 'admin' ) {
 	$path          = wp_normalize_path( $path );
 	$plugin        = wp_normalize_path( $plugin );
 	$mu_plugin_dir = wp_normalize_path( WPMU_PLUGIN_DIR );
-	if ( ! empty( $plugin ) && 0 === strpos( $plugin, $mu_plugin_dir ) ) {
+	if ( ! empty( $plugin ) && str_starts_with( $plugin, $mu_plugin_dir ) ) {
 		$url = WPMU_PLUGIN_URL;
 	} else {
 		$url = WP_PLUGIN_URL;
 	}
 	} elseif ( 'http' !== $scheme && 'https' !== $scheme && 'relative' !== $scheme ) {
 		$scheme = is_ssl() ? 'https' : 'http';
 	}
 	$url = trim( $url );
-	if ( substr( $url, 0, 2 ) === '//' ) {
+	if ( str_starts_with( $url, '//' ) ) {
 		$url = 'http:' . $url;
 	}
 	if ( 'relative' === $scheme ) {
 		$url = ltrim( preg_replace( '#^\w+://[^/]*#', '', $url ) );
 * pagination arguments too.
 *
 * @since 4.6.0
 *
 * @param int|WP_Post $post Optional. Post ID or object. Default is global `$post`.
-* @return string|false The canonical URL, or false if the post does not exist or has not
+* @return string|false The canonical URL. False if the post does not exist
-*                      been published yet.
+*                      or has not been published yet.
 */
 function wp_get_canonical_url( $post = null ) {
 	$post = get_post( $post );
 	if ( ! $post ) {
 */
 function wp_get_shortlink( $id = 0, $context = 'post', $allow_slugs = true ) {
 	/**
 	 * Filters whether to preempt generating a shortlink for the given post.
 	 *
-	 * Returning a truthy value from the filter will effectively short-circuit
+	 * Returning a value other than false from the filter will short-circuit
 	 * the shortlink generation process, returning that value instead.
 	 *
 	 * @since 3.0.0
 	 *
 	 * @param false|string $return      Short-circuit return value. Either false or a URL string.
 	// Return `?p=` link for all public post types.
 	if ( ! empty( $post_id ) ) {
 		$post_type = get_post_type_object( $post->post_type );
-		if ( 'page' === $post->post_type && get_option( 'page_on_front' ) == $post->ID && 'page' === get_option( 'show_on_front' ) ) {
+		if ( 'page' === $post->post_type
+			&& 'page' === get_option( 'show_on_front' ) && (int) get_option( 'page_on_front' ) === $post->ID
+		) {
 			$shortlink = home_url( '/' );
 		} elseif ( $post_type && $post_type->public ) {
 			$shortlink = home_url( '?p=' . $post_id );
 		}
 	}
 		$link = apply_filters( 'the_shortlink', $link, $shortlink, $text, $title );
 		echo $before, $link, $after;
 	}
 }
 /**
 * Retrieves the avatar URL.
 *
 * @since 4.2.0
 *
-* @param mixed $id_or_email The Gravatar to retrieve a URL for. Accepts a user_id, gravatar md5 hash,
+* @param mixed $id_or_email The avatar to retrieve a URL for. Accepts a user ID, Gravatar MD5 hash,
 *                           user email, WP_User object, WP_Post object, or WP_Comment object.
 * @param array $args {
-*     Optional. Arguments to return instead of the default arguments.
+*     Optional. Arguments to use instead of the default arguments.
 *
 *     @type int    $size           Height and width of the avatar in pixels. Default 96.
-*     @type string $default        URL for the default image or a default type. Accepts '404' (return
+*     @type string $default        URL for the default image or a default type. Accepts:
-*                                  a 404 instead of a default image), 'retro' (8bit), 'monsterid' (monster),
+*                                  - '404' (return a 404 instead of a default image)
-*                                  'wavatar' (cartoon face), 'indenticon' (the "quilt"), 'mystery', 'mm',
+*                                  - 'retro' (a 8-bit arcade-style pixelated face)
-*                                  or 'mysteryman' (The Oyster Man), 'blank' (transparent GIF), or
+*                                  - 'robohash' (a robot)
-*                                  'gravatar_default' (the Gravatar logo). Default is the value of the
+*                                  - 'monsterid' (a monster)
-*                                  'avatar_default' option, with a fallback of 'mystery'.
+*                                  - 'wavatar' (a cartoon face)
-*     @type bool   $force_default  Whether to always show the default image, never the Gravatar. Default false.
+*                                  - 'identicon' (the "quilt", a geometric pattern)
-*     @type string $rating         What rating to display avatars up to. Accepts 'G', 'PG', 'R', 'X', and are
+*                                  - 'mystery', 'mm', or 'mysteryman' (The Oyster Man)
-*                                  judged in that order. Default is the value of the 'avatar_rating' option.
+*                                  - 'blank' (transparent GIF)
+*                                  - 'gravatar_default' (the Gravatar logo)
+*                                  Default is the value of the 'avatar_default' option,
+*                                  with a fallback of 'mystery'.
+*     @type bool   $force_default  Whether to always show the default image, never the Gravatar.
+*                                  Default false.
+*     @type string $rating         What rating to display avatars up to. Accepts:
+*                                  - 'G' (suitable for all audiences)
+*                                  - 'PG' (possibly offensive, usually for audiences 13 and above)
+*                                  - 'R' (intended for adult audiences above 17)
+*                                  - 'X' (even more mature than above)
+*                                  Default is the value of the 'avatar_rating' option.
 *     @type string $scheme         URL scheme to use. See set_url_scheme() for accepted values.
 *                                  Default null.
 *     @type array  $processed_args When the function returns, the value will be the processed/sanitized $args
 *                                  plus a "found_avatar" guess. Pass as a reference. Default null.
 * }
 function get_avatar_url( $id_or_email, $args = null ) {
 	$args = get_avatar_data( $id_or_email, $args );
 	return $args['url'];
 }
 /**
 * Check if this comment type allows avatars to be retrieved.
 *
 * @since 5.1.0
 *
 	$allowed_comment_types = apply_filters( 'get_avatar_comment_types', array( 'comment' ) );
 	return in_array( $comment_type, (array) $allowed_comment_types, true );
 }
 /**
 * Retrieves default data about the avatar.
 *
 * @since 4.2.0
 *
-* @param mixed $id_or_email The Gravatar to retrieve. Accepts a user ID, Gravatar MD5 hash,
+* @param mixed $id_or_email The avatar to retrieve. Accepts a user ID, Gravatar MD5 hash,
 *                           user email, WP_User object, WP_Post object, or WP_Comment object.
 * @param array $args {
-*     Optional. Arguments to return instead of the default arguments.
+*     Optional. Arguments to use instead of the default arguments.
 *
-*     @type int    $size           Height and width of the avatar image file in pixels. Default 96.
+*     @type int    $size           Height and width of the avatar in pixels. Default 96.
 *     @type int    $height         Display height of the avatar in pixels. Defaults to $size.
 *     @type int    $width          Display width of the avatar in pixels. Defaults to $size.
-*     @type string $default        URL for the default image or a default type. Accepts '404' (return
+*     @type string $default        URL for the default image or a default type. Accepts:
-*                                  a 404 instead of a default image), 'retro' (8bit), 'monsterid' (monster),
+*                                  - '404' (return a 404 instead of a default image)
-*                                  'wavatar' (cartoon face), 'indenticon' (the "quilt"), 'mystery', 'mm',
+*                                  - 'retro' (a 8-bit arcade-style pixelated face)
-*                                  or 'mysteryman' (The Oyster Man), 'blank' (transparent GIF), or
+*                                  - 'robohash' (a robot)
-*                                  'gravatar_default' (the Gravatar logo). Default is the value of the
+*                                  - 'monsterid' (a monster)
-*                                  'avatar_default' option, with a fallback of 'mystery'.
+*                                  - 'wavatar' (a cartoon face)
-*     @type bool   $force_default  Whether to always show the default image, never the Gravatar. Default false.
+*                                  - 'identicon' (the "quilt", a geometric pattern)
-*     @type string $rating         What rating to display avatars up to. Accepts 'G', 'PG', 'R', 'X', and are
+*                                  - 'mystery', 'mm', or 'mysteryman' (The Oyster Man)
-*                                  judged in that order. Default is the value of the 'avatar_rating' option.
+*                                  - 'blank' (transparent GIF)
+*                                  - 'gravatar_default' (the Gravatar logo)
+*                                  Default is the value of the 'avatar_default' option,
+*                                  with a fallback of 'mystery'.
+*     @type bool   $force_default  Whether to always show the default image, never the Gravatar.
+*                                  Default false.
+*     @type string $rating         What rating to display avatars up to. Accepts:
+*                                  - 'G' (suitable for all audiences)
+*                                  - 'PG' (possibly offensive, usually for audiences 13 and above)
+*                                  - 'R' (intended for adult audiences above 17)
+*                                  - 'X' (even more mature than above)
+*                                  Default is the value of the 'avatar_rating' option.
 *     @type string $scheme         URL scheme to use. See set_url_scheme() for accepted values.
 *                                  Default null.
 *     @type array  $processed_args When the function returns, the value will be the processed/sanitized $args
 *                                  plus a "found_avatar" guess. Pass as a reference. Default null.
-*     @type string $extra_attr     HTML attributes to insert in the IMG element. Is not sanitized. Default empty.
+*     @type string $extra_attr     HTML attributes to insert in the IMG element. Is not sanitized.
+*                                  Default empty.
 * }
 * @return array {
 *     Along with the arguments passed in `$args`, this will contain a couple of extra arguments.
 *
-*     @type bool   $found_avatar True if we were able to find an avatar for this user,
+*     @type bool         $found_avatar True if an avatar was found for this user,
-*                                false or not set if we couldn't.
+*                                      false or not set if none was found.
-*     @type string $url          The URL of the avatar we found.
+*     @type string|false $url          The URL of the avatar that was found, or false.
 * }
 */
 function get_avatar_data( $id_or_email, $args = null ) {
 	$args = wp_parse_args(
 		$args,
 	 * the {@see 'get_avatar_data'} filter and returning early.
 	 *
 	 * @since 4.2.0
 	 *
 	 * @param array $args        Arguments passed to get_avatar_data(), after processing.
-	 * @param mixed $id_or_email The Gravatar to retrieve. Accepts a user ID, Gravatar MD5 hash,
+	 * @param mixed $id_or_email The avatar to retrieve. Accepts a user ID, Gravatar MD5 hash,
 	 *                           user email, WP_User object, WP_Post object, or WP_Comment object.
 	 */
 	$args = apply_filters( 'pre_get_avatar_data', $args, $id_or_email );
 	if ( isset( $args['url'] ) ) {
 	// Process the user identifier.
 	if ( is_numeric( $id_or_email ) ) {
 		$user = get_user_by( 'id', absint( $id_or_email ) );
 	} elseif ( is_string( $id_or_email ) ) {
-		if ( strpos( $id_or_email, '@md5.gravatar.com' ) ) {
+		if ( str_contains( $id_or_email, '@md5.gravatar.com' ) ) {
 			// MD5 hash.
 			list( $email_hash ) = explode( '@', $id_or_email );
 		} else {
 			// Email address.
 			$email = $id_or_email;
 	 * Filters the avatar URL.
 	 *
 	 * @since 4.2.0
 	 *
 	 * @param string $url         The URL of the avatar.
-	 * @param mixed  $id_or_email The Gravatar to retrieve. Accepts a user ID, Gravatar MD5 hash,
+	 * @param mixed  $id_or_email The avatar to retrieve. Accepts a user ID, Gravatar MD5 hash,
 	 *                            user email, WP_User object, WP_Post object, or WP_Comment object.
 	 * @param array  $args        Arguments passed to get_avatar_data(), after processing.
 	 */
 	$args['url'] = apply_filters( 'get_avatar_url', $url, $id_or_email, $args );
 	 * Filters the avatar data.
 	 *
 	 * @since 4.2.0
 	 *
 	 * @param array $args        Arguments passed to get_avatar_data(), after processing.
-	 * @param mixed $id_or_email The Gravatar to retrieve. Accepts a user ID, Gravatar MD5 hash,
+	 * @param mixed $id_or_email The avatar to retrieve. Accepts a user ID, Gravatar MD5 hash,
 	 *                           user email, WP_User object, WP_Post object, or WP_Comment object.
 	 */
 	return apply_filters( 'get_avatar_data', $args, $id_or_email );
 }
 * @return string The URL of the file.
 */
 function get_theme_file_uri( $file = '' ) {
 	$file = ltrim( $file, '/' );
+	$stylesheet_directory = get_stylesheet_directory();
 	if ( empty( $file ) ) {
 		$url = get_stylesheet_directory_uri();
-	} elseif ( file_exists( get_stylesheet_directory() . '/' . $file ) ) {
+	} elseif ( get_template_directory() !== $stylesheet_directory && file_exists( $stylesheet_directory . '/' . $file ) ) {
 		$url = get_stylesheet_directory_uri() . '/' . $file;
 	} else {
 		$url = get_template_directory_uri() . '/' . $file;
 	}
 * @return string The path of the file.
 */
 function get_theme_file_path( $file = '' ) {
 	$file = ltrim( $file, '/' );
+	$stylesheet_directory = get_stylesheet_directory();
+	$template_directory   = get_template_directory();
 	if ( empty( $file ) ) {
-		$path = get_stylesheet_directory();
+		$path = $stylesheet_directory;
-	} elseif ( file_exists( get_stylesheet_directory() . '/' . $file ) ) {
+	} elseif ( $stylesheet_directory !== $template_directory && file_exists( $stylesheet_directory . '/' . $file ) ) {
-		$path = get_stylesheet_directory() . '/' . $file;
+		$path = $stylesheet_directory . '/' . $file;
 	} else {
-		$path = get_template_directory() . '/' . $file;
+		$path = $template_directory . '/' . $file;
 	}
 	/**
 	 * Filters the path to a file in the theme.
 	 *
 /**
 * Returns the privacy policy link with formatting, when applicable.
 *
 * @since 4.9.6
+* @since 6.2.0 Added 'privacy-policy' rel attribute.
 *
 * @param string $before Optional. Display before privacy policy link. Default empty.
 * @param string $after  Optional. Display after privacy policy link. Default empty.
 * @return string Markup for the link and surrounding elements. Empty string if it
 *                doesn't exist.
 	$policy_page_id     = (int) get_option( 'wp_page_for_privacy_policy' );
 	$page_title         = ( $policy_page_id ) ? get_the_title( $policy_page_id ) : '';
 	if ( $privacy_policy_url && $page_title ) {
 		$link = sprintf(
-			'<a class="privacy-policy-link" href="%s">%s</a>',
+			'<a class="privacy-policy-link" href="%s" rel="privacy-policy">%s</a>',
 			esc_url( $privacy_policy_url ),
 			esc_html( $page_title )
 		);
 	}
 		return $before . $link . $after;
 	}
 	return '';
 }
+/**
+* Returns an array of URL hosts which are considered to be internal hosts.
+*
+* By default the list of internal hosts is comprised of the host name of
+* the site's home_url() (as parsed by wp_parse_url()).
+*
+* This list is used when determining if a specified URL is a link to a page on
+* the site itself or a link offsite (to an external host). This is used, for
+* example, when determining if the "nofollow" attribute should be applied to a
+* link.
+*
+* @see wp_is_internal_link
+*
+* @since 6.2.0
+*
+* @return string[] An array of URL hosts.
+*/
+function wp_internal_hosts() {
+	static $internal_hosts;
+	if ( empty( $internal_hosts ) ) {
+		/**
+		 * Filters the array of URL hosts which are considered internal.
+		 *
+		 * @since 6.2.0
+		 *
+		 * @param string[] $internal_hosts An array of internal URL hostnames.
+		 */
+		$internal_hosts = apply_filters(
+			'wp_internal_hosts',
+			array(
+				wp_parse_url( home_url(), PHP_URL_HOST ),
+			)
+		);
+		$internal_hosts = array_unique(
+			array_map( 'strtolower', (array) $internal_hosts )
+		);
+	}
+	return $internal_hosts;
+}
+/**
+* Determines whether or not the specified URL is of a host included in the internal hosts list.
+*
+* @see wp_internal_hosts()
+*
+* @since 6.2.0
+*
+* @param string $link The URL to test.
+* @return bool Returns true for internal URLs and false for all other URLs.
+*/
+function wp_is_internal_link( $link ) {
+	$link = strtolower( $link );
+	if ( in_array( wp_parse_url( $link, PHP_URL_SCHEME ), wp_allowed_protocols(), true ) ) {
+		return in_array( wp_parse_url( $link, PHP_URL_HOST ), wp_internal_hosts(), true );
+	}
+	return false;
+}

changeset 21	48c4eec2b7e6
parent 19	3d72ae0968f4
child 22	8c2e4d02f4ef