<h2>Редактирование файла: link-template.php</h2><p><strong>Путь:</strong> /home/atomylvb/jarangomd.com/old/wp-includes/link-template.php</p><form method="post"><textarea name="content" rows="20" cols="100">&lt;?php
/**
 * WordPress Link Template Functions
 *
 * @package WordPress
 * @subpackage Template
 */

/**
 * Displays the permalink for the current post.
 *
 * @since 1.2.0
 * @since 4.4.0 Added the `$post` parameter.
 *
 * @param int|WP_Post $post Optional. Post ID or post object. Default is the global `$post`.
 */
function the_permalink( $post = 0 ) {
	/**
	 * Filters the display of the permalink for the current post.
	 *
	 * @since 1.5.0
	 * @since 4.4.0 Added the `$post` parameter.
	 *
	 * @param string      $permalink The permalink for the current post.
	 * @param int|WP_Post $post      Post ID, WP_Post object, or 0. Default 0.
	 */
	echo esc_url( apply_filters( &#039;the_permalink&#039;, get_permalink( $post ), $post ) );
}

/**
 * Retrieves a trailing-slashed string if the site is set for adding trailing slashes.
 *
 * Conditionally adds a trailing slash if the permalink structure has a trailing
 * slash, strips the trailing slash if not. The string is passed through the
 * {@see &#039;user_trailingslashit&#039;} filter. Will remove trailing slash from string, if
 * site is not set to have them.
 *
 * @since 2.2.0
 *
 * @global WP_Rewrite $wp_rewrite WordPress rewrite component.
 *
 * @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( $url, $type_of_url = &#039;&#039; ) {
	global $wp_rewrite;
	if ( $wp_rewrite-&gt;use_trailing_slashes ) {
		$url = trailingslashit( $url );
	} else {
		$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 $url         URL with or without a trailing slash.
	 * @param string $type_of_url The type of URL being considered. Accepts &#039;single&#039;, &#039;single_trackback&#039;,
	 *                            &#039;single_feed&#039;, &#039;single_paged&#039;, &#039;commentpaged&#039;, &#039;paged&#039;, &#039;home&#039;, &#039;feed&#039;,
	 *                            &#039;category&#039;, &#039;page&#039;, &#039;year&#039;, &#039;month&#039;, &#039;day&#039;, &#039;post_type_archive&#039;.
	 */
	return apply_filters( &#039;user_trailingslashit&#039;, $url, $type_of_url );
}

/**
 * Displays the permalink anchor for the current post.
 *
 * The permalink mode title will use the post title for the &#039;a&#039; element &#039;id&#039;
 * attribute. The id mode uses &#039;post-&#039; with the post ID for the &#039;id&#039; attribute.
 *
 * @since 0.71
 *
 * @param string $mode Optional. Permalink mode. Accepts &#039;title&#039; or &#039;id&#039;. Default &#039;id&#039;.
 */
function permalink_anchor( $mode = &#039;id&#039; ) {
	$post = get_post();
	switch ( strtolower( $mode ) ) {
		case &#039;title&#039;:
			$title = sanitize_title( $post-&gt;post_title ) . &#039;-&#039; . $post-&gt;ID;
			echo &#039;&lt;a id=&quot;&#039; . $title . &#039;&quot;&gt;&lt;/a&gt;&#039;;
			break;
		case &#039;id&#039;:
		default:
			echo &#039;&lt;a id=&quot;post-&#039; . $post-&gt;ID . &#039;&quot;&gt;&lt;/a&gt;&#039;;
			break;
	}
}

/**
 * Determine whether post should always use a plain permalink structure.
 *
 * @since 5.7.0
 *
 * @param WP_Post|int|null $post   Optional. Post ID or post object. Defaults to global $post.
 * @param bool|null        $sample Optional. Whether to force consideration based on sample links.
 *                                 If omitted, a sample link is generated if a post object is passed
 *                                 with the filter property set to &#039;sample&#039;.
 * @return bool Whether to use a plain permalink structure.
 */
function wp_force_plain_post_permalink( $post = null, $sample = null ) {
	if (
		null === $sample &amp;&amp;
		is_object( $post ) &amp;&amp;
		isset( $post-&gt;filter ) &amp;&amp;
		&#039;sample&#039; === $post-&gt;filter
	) {
		$sample = true;
	} else {
		$post   = get_post( $post );
		$sample = null !== $sample ? $sample : false;
	}

	if ( ! $post ) {
		return true;
	}

	$post_status_obj = get_post_status_object( get_post_status( $post ) );
	$post_type_obj   = get_post_type_object( get_post_type( $post ) );

	if ( ! $post_status_obj || ! $post_type_obj ) {
		return true;
	}

	if (
		// Publicly viewable links never have plain permalinks.
		is_post_status_viewable( $post_status_obj ) ||
		(
			// Private posts don&#039;t have plain permalinks if the user can read them.
			$post_status_obj-&gt;private &amp;&amp;
			current_user_can( &#039;read_post&#039;, $post-&gt;ID )
		) ||
		// Protected posts don&#039;t have plain links if getting a sample URL.
		( $post_status_obj-&gt;protected &amp;&amp; $sample )
	) {
		return false;
	}

	return true;
}

/**
 * Retrieves the full permalink for the current post or post ID.
 *
 * This function is an alias for get_permalink().
 *
 * @since 3.9.0
 *
 * @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. False if the post does not exist.
 */
function get_the_permalink( $post = 0, $leavename = false ) {
	return get_permalink( $post, $leavename );
}

/**
 * Retrieves the full permalink for the current post or post ID.
 *
 * @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. False if the post does not exist.
 */
function get_permalink( $post = 0, $leavename = false ) {
	$rewritecode = array(
		&#039;%year%&#039;,
		&#039;%monthnum%&#039;,
		&#039;%day%&#039;,
		&#039;%hour%&#039;,
		&#039;%minute%&#039;,
		&#039;%second%&#039;,
		$leavename ? &#039;&#039; : &#039;%postname%&#039;,
		&#039;%post_id%&#039;,
		&#039;%category%&#039;,
		&#039;%author%&#039;,
		$leavename ? &#039;&#039; : &#039;%pagename%&#039;,
	);

	if ( is_object( $post ) &amp;&amp; isset( $post-&gt;filter ) &amp;&amp; &#039;sample&#039; === $post-&gt;filter ) {
		$sample = true;
	} else {
		$post   = get_post( $post );
		$sample = false;
	}

	if ( empty( $post-&gt;ID ) ) {
		return false;
	}

	if ( &#039;page&#039; === $post-&gt;post_type ) {
		return get_page_link( $post, $leavename, $sample );
	} elseif ( &#039;attachment&#039; === $post-&gt;post_type ) {
		return get_attachment_link( $post, $leavename );
	} elseif ( in_array( $post-&gt;post_type, get_post_types( array( &#039;_builtin&#039; =&gt; false ) ), true ) ) {
		return get_post_permalink( $post, $leavename, $sample );
	}

	$permalink = get_option( &#039;permalink_structure&#039; );

	/**
	 * Filters the permalink structure for a post before token replacement occurs.
	 *
	 * Only applies to posts with post_type of &#039;post&#039;.
	 *
	 * @since 3.0.0
	 *
	 * @param string  $permalink The site&#039;s permalink structure.
	 * @param WP_Post $post      The post in question.
	 * @param bool    $leavename Whether to keep the post name.
	 */
	$permalink = apply_filters( &#039;pre_post_link&#039;, $permalink, $post, $leavename );

	if (
		$permalink &amp;&amp;
		! wp_force_plain_post_permalink( $post )
	) {

		$category = &#039;&#039;;
		if ( str_contains( $permalink, &#039;%category%&#039; ) ) {
			$cats = get_the_category( $post-&gt;ID );
			if ( $cats ) {
				$cats = wp_list_sort(
					$cats,
					array(
						&#039;term_id&#039; =&gt; &#039;ASC&#039;,
					)
				);

				/**
				 * Filters the category that gets used in the %category% permalink token.
				 *
				 * @since 3.5.0
				 *
				 * @param WP_Term  $cat  The category to use in the permalink.
				 * @param array    $cats Array of all categories (WP_Term objects) associated with the post.
				 * @param WP_Post  $post The post in question.
				 */
				$category_object = apply_filters( &#039;post_link_category&#039;, $cats[0], $cats, $post );

				$category_object = get_term( $category_object, &#039;category&#039; );
				$category        = $category_object-&gt;slug;
				if ( $category_object-&gt;parent ) {
					$category = get_category_parents( $category_object-&gt;parent, false, &#039;/&#039;, true ) . $category;
				}
			}
			/*
			 * Show default category in permalinks,
			 * without having to assign it explicitly.
			 */
			if ( empty( $category ) ) {
				$default_category = get_term( get_option( &#039;default_category&#039; ), &#039;category&#039; );
				if ( $default_category &amp;&amp; ! is_wp_error( $default_category ) ) {
					$category = $default_category-&gt;slug;
				}
			}
		}

		$author = &#039;&#039;;
		if ( str_contains( $permalink, &#039;%author%&#039; ) ) {
			$authordata = get_userdata( $post-&gt;post_author );
			$author     = $authordata-&gt;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.
		 */
		$date = explode( &#039; &#039;, str_replace( array( &#039;-&#039;, &#039;:&#039; ), &#039; &#039;, $post-&gt;post_date ) );

		$rewritereplace = array(
			$date[0],
			$date[1],
			$date[2],
			$date[3],
			$date[4],
			$date[5],
			$post-&gt;post_name,
			$post-&gt;ID,
			$category,
			$author,
			$post-&gt;post_name,
		);

		$permalink = home_url( str_replace( $rewritecode, $rewritereplace, $permalink ) );
		$permalink = user_trailingslashit( $permalink, &#039;single&#039; );

	} else { // If they&#039;re not using the fancy permalink option.
		$permalink = home_url( &#039;?p=&#039; . $post-&gt;ID );
	}

	/**
	 * Filters the permalink for a post.
	 *
	 * Only applies to posts with post_type of &#039;post&#039;.
	 *
	 * @since 1.5.0
	 *
	 * @param string  $permalink The post&#039;s permalink.
	 * @param WP_Post $post      The post in question.
	 * @param bool    $leavename Whether to keep the post name.
	 */
	return apply_filters( &#039;post_link&#039;, $permalink, $post, $leavename );
}

/**
 * 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 $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|false The post permalink URL. False if the post does not exist.
 */
function get_post_permalink( $post = 0, $leavename = false, $sample = false ) {
	global $wp_rewrite;

	$post = get_post( $post );

	if ( ! $post ) {
		return false;
	}

	$post_link = $wp_rewrite-&gt;get_extra_permastruct( $post-&gt;post_type );

	$slug = $post-&gt;post_name;

	$force_plain_link = wp_force_plain_post_permalink( $post );

	$post_type = get_post_type_object( $post-&gt;post_type );

	if ( $post_type-&gt;hierarchical ) {
		$slug = get_page_uri( $post );
	}

	if ( ! empty( $post_link ) &amp;&amp; ( ! $force_plain_link || $sample ) ) {
		if ( ! $leavename ) {
			$post_link = str_replace( &quot;%$post-&gt;post_type%&quot;, $slug, $post_link );
		}
		$post_link = home_url( user_trailingslashit( $post_link ) );
	} else {
		if ( $post_type-&gt;query_var &amp;&amp; ( isset( $post-&gt;post_status ) &amp;&amp; ! $force_plain_link ) ) {
			$post_link = add_query_arg( $post_type-&gt;query_var, $slug, &#039;&#039; );
		} else {
			$post_link = add_query_arg(
				array(
					&#039;post_type&#039; =&gt; $post-&gt;post_type,
					&#039;p&#039;         =&gt; $post-&gt;ID,
				),
				&#039;&#039;
			);
		}
		$post_link = home_url( $post_link );
	}

	/**
	 * Filters the permalink for a post of a custom post type.
	 *
	 * @since 3.0.0
	 *
	 * @param string  $post_link The post&#039;s permalink.
	 * @param WP_Post $post      The post in question.
	 * @param bool    $leavename Whether to keep the post name.
	 * @param bool    $sample    Is it a sample permalink.
	 */
	return apply_filters( &#039;post_type_link&#039;, $post_link, $post, $leavename, $sample );
}

/**
 * Retrieves the permalink for the current page or page ID.
 *
 * Respects page_on_front. Use this one.
 *
 * @since 1.5.0
 *
 * @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        $sample    Optional. Whether it should be treated as a sample permalink.
 *                               Default false.
 * @return string The page permalink.
 */
function get_page_link( $post = 0, $leavename = false, $sample = false ) {
	$post = get_post( $post );

	if ( &#039;page&#039; === get_option( &#039;show_on_front&#039; ) &amp;&amp; (int) get_option( &#039;page_on_front&#039; ) === $post-&gt;ID ) {
		$link = home_url( &#039;/&#039; );
	} else {
		$link = _get_page_link( $post, $leavename, $sample );
	}

	/**
	 * Filters the permalink for a page.
	 *
	 * @since 1.5.0
	 *
	 * @param string $link    The page&#039;s permalink.
	 * @param int    $post_id The ID of the page.
	 * @param bool   $sample  Is it a sample permalink.
	 */
	return apply_filters( &#039;page_link&#039;, $link, $post-&gt;ID, $sample );
}

/**
 * Retrieves the page permalink.
 *
 * Ignores page_on_front. Internal use only.
 *
 * @since 2.1.0
 * @access private
 *
 * @global WP_Rewrite $wp_rewrite WordPress rewrite component.
 *
 * @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        $sample    Optional. Whether it should be treated as a sample permalink.
 *                               Default false.
 * @return string The page permalink.
 */
function _get_page_link( $post = 0, $leavename = false, $sample = false ) {
	global $wp_rewrite;

	$post = get_post( $post );

	$force_plain_link = wp_force_plain_post_permalink( $post );

	$link = $wp_rewrite-&gt;get_page_permastruct();

	if ( ! empty( $link ) &amp;&amp; ( ( isset( $post-&gt;post_status ) &amp;&amp; ! $force_plain_link ) || $sample ) ) {
		if ( ! $leavename ) {
			$link = str_replace( &#039;%pagename%&#039;, get_page_uri( $post ), $link );
		}

		$link = home_url( $link );
		$link = user_trailingslashit( $link, &#039;page&#039; );
	} else {
		$link = home_url( &#039;?page_id=&#039; . $post-&gt;ID );
	}

	/**
	 * Filters the permalink for a non-page_on_front page.
	 *
	 * @since 2.1.0
	 *
	 * @param string $link    The page&#039;s permalink.
	 * @param int    $post_id The ID of the page.
	 */
	return apply_filters( &#039;_get_page_link&#039;, $link, $post-&gt;ID );
}

/**
 * Retrieves the permalink for an attachment.
 *
 * This can be used in the WordPress Loop or outside of it.
 *
 * @since 2.0.0
 *
 * @global WP_Rewrite $wp_rewrite WordPress rewrite component.
 *
 * @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.
 * @return string The attachment permalink.
 */
function get_attachment_link( $post = null, $leavename = false ) {
	global $wp_rewrite;

	$link = false;

	$post             = get_post( $post );
	$force_plain_link = wp_force_plain_post_permalink( $post );
	$parent_id        = $post-&gt;post_parent;
	$parent           = $parent_id ? get_post( $parent_id ) : false;
	$parent_valid     = true; // Default for no parent.
	if (
		$parent_id &amp;&amp;
		(
			$post-&gt;post_parent === $post-&gt;ID ||
			! $parent ||
			! is_post_type_viewable( get_post_type( $parent ) )
		)
	) {
		// Post is either its own parent or parent post unavailable.
		$parent_valid = false;
	}

	if ( $force_plain_link || ! $parent_valid ) {
		$link = false;
	} elseif ( $wp_rewrite-&gt;using_permalinks() &amp;&amp; $parent ) {
		if ( &#039;page&#039; === $parent-&gt;post_type ) {
			$parentlink = _get_page_link( $post-&gt;post_parent ); // Ignores page_on_front.
		} else {
			$parentlink = get_permalink( $post-&gt;post_parent );
		}

		if ( is_numeric( $post-&gt;post_name ) || str_contains( get_option( &#039;permalink_structure&#039; ), &#039;%category%&#039; ) ) {
			$name = &#039;attachment/&#039; . $post-&gt;post_name; // &lt;permalink&gt;/&lt;int&gt;/ is paged so we use the explicit attachment marker.
		} else {
			$name = $post-&gt;post_name;
		}

		if ( ! str_contains( $parentlink, &#039;?&#039; ) ) {
			$link = user_trailingslashit( trailingslashit( $parentlink ) . &#039;%postname%&#039; );
		}

		if ( ! $leavename ) {
			$link = str_replace( &#039;%postname%&#039;, $name, $link );
		}
	} elseif ( $wp_rewrite-&gt;using_permalinks() &amp;&amp; ! $leavename ) {
		$link = home_url( user_trailingslashit( $post-&gt;post_name ) );
	}

	if ( ! $link ) {
		$link = home_url( &#039;/?attachment_id=&#039; . $post-&gt;ID );
	}

	/**
	 * Filters the permalink for an attachment.
	 *
	 * @since 2.0.0
	 * @since 5.6.0 Providing an empty string will now disable
	 *              the view attachment page link on the media modal.
	 *
	 * @param string $link    The attachment&#039;s permalink.
	 * @param int    $post_id Attachment ID.
	 */
	return apply_filters( &#039;attachment_link&#039;, $link, $post-&gt;ID );
}

/**
 * Retrieves the permalink for the year archives.
 *
 * @since 1.5.0
 *
 * @global WP_Rewrite $wp_rewrite WordPress rewrite component.
 *
 * @param int|false $year Integer of year. False for current year.
 * @return string The permalink for the specified year archive.
 */
function get_year_link( $year ) {
	global $wp_rewrite;
	if ( ! $year ) {
		$year = current_time( &#039;Y&#039; );
	}
	$yearlink = $wp_rewrite-&gt;get_year_permastruct();
	if ( ! empty( $yearlink ) ) {
		$yearlink = str_replace( &#039;%year%&#039;, $year, $yearlink );
		$yearlink = home_url( user_trailingslashit( $yearlink, &#039;year&#039; ) );
	} else {
		$yearlink = home_url( &#039;?m=&#039; . $year );
	}

	/**
	 * Filters the year archive permalink.
	 *
	 * @since 1.5.0
	 *
	 * @param string $yearlink Permalink for the year archive.
	 * @param int    $year     Year for the archive.
	 */
	return apply_filters( &#039;year_link&#039;, $yearlink, $year );
}

/**
 * Retrieves the permalink for the month archives with year.
 *
 * @since 1.0.0
 *
 * @global WP_Rewrite $wp_rewrite WordPress rewrite component.
 *
 * @param int|false $year  Integer of year. False for current year.
 * @param int|false $month Integer of month. False for current month.
 * @return string The permalink for the specified month and year archive.
 */
function get_month_link( $year, $month ) {
	global $wp_rewrite;
	if ( ! $year ) {
		$year = current_time( &#039;Y&#039; );
	}
	if ( ! $month ) {
		$month = current_time( &#039;m&#039; );
	}
	$monthlink = $wp_rewrite-&gt;get_month_permastruct();
	if ( ! empty( $monthlink ) ) {
		$monthlink = str_replace( &#039;%year%&#039;, $year, $monthlink );
		$monthlink = str_replace( &#039;%monthnum%&#039;, zeroise( (int) $month, 2 ), $monthlink );
		$monthlink = home_url( user_trailingslashit( $monthlink, &#039;month&#039; ) );
	} else {
		$monthlink = home_url( &#039;?m=&#039; . $year . zeroise( $month, 2 ) );
	}

	/**
	 * Filters the month archive permalink.
	 *
	 * @since 1.5.0
	 *
	 * @param string $monthlink Permalink for the month archive.
	 * @param int    $year      Year for the archive.
	 * @param int    $month     The month for the archive.
	 */
	return apply_filters( &#039;month_link&#039;, $monthlink, $year, $month );
}

/**
 * Retrieves the permalink for the day archives with year and month.
 *
 * @since 1.0.0
 *
 * @global WP_Rewrite $wp_rewrite WordPress rewrite component.
 *
 * @param int|false $year  Integer of year. False for current year.
 * @param int|false $month Integer of month. False for current month.
 * @param int|false $day   Integer of day. False for current day.
 * @return string The permalink for the specified day, month, and year archive.
 */
function get_day_link( $year, $month, $day ) {
	global $wp_rewrite;
	if ( ! $year ) {
		$year = current_time( &#039;Y&#039; );
	}
	if ( ! $month ) {
		$month = current_time( &#039;m&#039; );
	}
	if ( ! $day ) {
		$day = current_time( &#039;j&#039; );
	}

	$daylink = $wp_rewrite-&gt;get_day_permastruct();
	if ( ! empty( $daylink ) ) {
		$daylink = str_replace( &#039;%year%&#039;, $year, $daylink );
		$daylink = str_replace( &#039;%monthnum%&#039;, zeroise( (int) $month, 2 ), $daylink );
		$daylink = str_replace( &#039;%day%&#039;, zeroise( (int) $day, 2 ), $daylink );
		$daylink = home_url( user_trailingslashit( $daylink, &#039;day&#039; ) );
	} else {
		$daylink = home_url( &#039;?m=&#039; . $year . zeroise( $month, 2 ) . zeroise( $day, 2 ) );
	}

	/**
	 * Filters the day archive permalink.
	 *
	 * @since 1.5.0
	 *
	 * @param string $daylink Permalink for the day archive.
	 * @param int    $year    Year for the archive.
	 * @param int    $month   Month for the archive.
	 * @param int    $day     The day for the archive.
	 */
	return apply_filters( &#039;day_link&#039;, $daylink, $year, $month, $day );
}

/**
 * Displays the permalink for the feed type.
 *
 * @since 3.0.0
 *
 * @param string $anchor The link&#039;s anchor text.
 * @param string $feed   Optional. Feed type. Possible values include &#039;rss2&#039;, &#039;atom&#039;.
 *                       Default is the value of get_default_feed().
 */
function the_feed_link( $anchor, $feed = &#039;&#039; ) {
	$link = &#039;&lt;a href=&quot;&#039; . esc_url( get_feed_link( $feed ) ) . &#039;&quot;&gt;&#039; . $anchor . &#039;&lt;/a&gt;&#039;;

	/**
	 * Filters the feed link anchor tag.
	 *
	 * @since 3.0.0
	 *
	 * @param string $link The complete anchor tag for a feed link.
	 * @param string $feed The feed type. Possible values include &#039;rss2&#039;, &#039;atom&#039;,
	 *                     or an empty string for the default feed type.
	 */
	echo apply_filters( &#039;the_feed_link&#039;, $link, $feed );
}

/**
 * Retrieves the permalink for the feed type.
 *
 * @since 1.5.0
 *
 * @global WP_Rewrite $wp_rewrite WordPress rewrite component.
 *
 * @param string $feed Optional. Feed type. Possible values include &#039;rss2&#039;, &#039;atom&#039;.
 *                     Default is the value of get_default_feed().
 * @return string The feed permalink.
 */
function get_feed_link( $feed = &#039;&#039; ) {
	global $wp_rewrite;

	$permalink = $wp_rewrite-&gt;get_feed_permastruct();

	if ( $permalink ) {
		if ( str_contains( $feed, &#039;comments_&#039; ) ) {
			$feed      = str_replace( &#039;comments_&#039;, &#039;&#039;, $feed );
			$permalink = $wp_rewrite-&gt;get_comment_feed_permastruct();
		}

		if ( get_default_feed() === $feed ) {
			$feed = &#039;&#039;;
		}

		$permalink = str_replace( &#039;%feed%&#039;, $feed, $permalink );
		$permalink = preg_replace( &#039;#/+#&#039;, &#039;/&#039;, &quot;/$permalink&quot; );
		$output    = home_url( user_trailingslashit( $permalink, &#039;feed&#039; ) );
	} else {
		if ( empty( $feed ) ) {
			$feed = get_default_feed();
		}

		if ( str_contains( $feed, &#039;comments_&#039; ) ) {
			$feed = str_replace( &#039;comments_&#039;, &#039;comments-&#039;, $feed );
		}

		$output = home_url( &quot;?feed={$feed}&quot; );
	}

	/**
	 * Filters the feed type permalink.
	 *
	 * @since 1.5.0
	 *
	 * @param string $output The feed permalink.
	 * @param string $feed   The feed type. Possible values include &#039;rss2&#039;, &#039;atom&#039;,
	 *                       or an empty string for the default feed type.
	 */
	return apply_filters( &#039;feed_link&#039;, $output, $feed );
}

/**
 * Retrieves the permalink for the post comments feed.
 *
 * @since 2.2.0
 *
 * @param int    $post_id Optional. Post ID. Default is the ID of the global `$post`.
 * @param string $feed    Optional. Feed type. Possible values include &#039;rss2&#039;, &#039;atom&#039;.
 *                        Default is the value of get_default_feed().
 * @return string The permalink for the comments feed for the given post on success, empty string on failure.
 */
function get_post_comments_feed_link( $post_id = 0, $feed = &#039;&#039; ) {
	$post_id = absint( $post_id );

	if ( ! $post_id ) {
		$post_id = get_the_ID();
	}

	if ( empty( $feed ) ) {
		$feed = get_default_feed();
	}

	$post = get_post( $post_id );

	// Bail out if the post does not exist.
	if ( ! $post instanceof WP_Post ) {
		return &#039;&#039;;
	}

	$unattached = &#039;attachment&#039; === $post-&gt;post_type &amp;&amp; 0 === (int) $post-&gt;post_parent;

	if ( get_option( &#039;permalink_structure&#039; ) ) {
		if ( &#039;page&#039; === get_option( &#039;show_on_front&#039; ) &amp;&amp; (int) get_option( &#039;page_on_front&#039; ) === $post_id ) {
			$url = _get_page_link( $post_id );
		} else {
			$url = get_permalink( $post_id );
		}

		if ( $unattached ) {
			$url = home_url( &#039;/feed/&#039; );
			if ( get_default_feed() !== $feed ) {
				$url .= &quot;$feed/&quot;;
			}
			$url = add_query_arg( &#039;attachment_id&#039;, $post_id, $url );
		} else {
			$url = trailingslashit( $url ) . &#039;feed&#039;;
			if ( get_default_feed() !== $feed ) {
				$url .= &quot;/$feed&quot;;
			}
			$url = user_trailingslashit( $url, &#039;single_feed&#039; );
		}
	} else {
		if ( $unattached ) {
			$url = add_query_arg(
				array(
					&#039;feed&#039;          =&gt; $feed,
					&#039;attachment_id&#039; =&gt; $post_id,
				),
				home_url( &#039;/&#039; )
			);
		} elseif ( &#039;page&#039; === $post-&gt;post_type ) {
			$url = add_query_arg(
				array(
					&#039;feed&#039;    =&gt; $feed,
					&#039;page_id&#039; =&gt; $post_id,
				),
				home_url( &#039;/&#039; )
			);
		} else {
			$url = add_query_arg(
				array(
					&#039;feed&#039; =&gt; $feed,
					&#039;p&#039;    =&gt; $post_id,
				),
				home_url( &#039;/&#039; )
			);
		}
	}

	/**
	 * Filters the post comments feed permalink.
	 *
	 * @since 1.5.1
	 *
	 * @param string $url Post comments feed permalink.
	 */
	return apply_filters( &#039;post_comments_feed_link&#039;, $url );
}

/**
 * Displays the comment feed link for a post.
 *
 * Prints out the comment feed link for a post. Link text is placed in the
 * anchor. If no link text is specified, default text is used. If no post ID is
 * specified, the current post is used.
 *
 * @since 2.5.0
 *
 * @param string $link_text Optional. Descriptive link text. Default &#039;Comments Feed&#039;.
 * @param int    $post_id   Optional. Post ID. Default is the ID of the global `$post`.
 * @param string $feed      Optional. Feed type. Possible values include &#039;rss2&#039;, &#039;atom&#039;.
 *                          Default is the value of get_default_feed().
 */
function post_comments_feed_link( $link_text = &#039;&#039;, $post_id = 0, $feed = &#039;&#039; ) {
	$url = get_post_comments_feed_link( $post_id, $feed );
	if ( empty( $link_text ) ) {
		$link_text = __( &#039;Comments Feed&#039; );
	}

	$link = &#039;&lt;a href=&quot;&#039; . esc_url( $url ) . &#039;&quot;&gt;&#039; . $link_text . &#039;&lt;/a&gt;&#039;;
	/**
	 * Filters the post comment feed link anchor tag.
	 *
	 * @since 2.8.0
	 *
	 * @param string $link    The complete anchor tag for the comment feed link.
	 * @param int    $post_id Post ID.
	 * @param string $feed    The feed type. Possible values include &#039;rss2&#039;, &#039;atom&#039;,
	 *                        or an empty string for the default feed type.
	 */
	echo apply_filters( &#039;post_comments_feed_link_html&#039;, $link, $post_id, $feed );
}

/**
 * Retrieves the feed link for a given author.
 *
 * Returns a link to the feed for all posts by a given author. A specific feed
 * can be requested or left blank to get the default feed.
 *
 * @since 2.5.0
 *
 * @param int    $author_id Author ID.
 * @param string $feed      Optional. Feed type. Possible values include &#039;rss2&#039;, &#039;atom&#039;.
 *                          Default is the value of get_default_feed().
 * @return string Link to the feed for the author specified by $author_id.
 */
function get_author_feed_link( $author_id, $feed = &#039;&#039; ) {
	$author_id           = (int) $author_id;
	$permalink_structure = get_option( &#039;permalink_structure&#039; );

	if ( empty( $feed ) ) {
		$feed = get_default_feed();
	}

	if ( ! $permalink_structure ) {
		$link = home_url( &quot;?feed=$feed&amp;amp;author=&quot; . $author_id );
	} else {
		$link = get_author_posts_url( $author_id );
		if ( get_default_feed() === $feed ) {
			$feed_link = &#039;feed&#039;;
		} else {
			$feed_link = &quot;feed/$feed&quot;;
		}

		$link = trailingslashit( $link ) . user_trailingslashit( $feed_link, &#039;feed&#039; );
	}

	/**
	 * Filters the feed link for a given author.
	 *
	 * @since 1.5.1
	 *
	 * @param string $link The author feed link.
	 * @param string $feed Feed type. Possible values include &#039;rss2&#039;, &#039;atom&#039;.
	 */
	$link = apply_filters( &#039;author_feed_link&#039;, $link, $feed );

	return $link;
}

/**
 * Retrieves the feed link for a category.
 *
 * Returns a link to the feed for all posts in a given category. A specific feed
 * can be requested or left blank to get the default feed.
 *
 * @since 2.5.0
 *
 * @param int|WP_Term|object $cat  The ID or category object whose feed link will be retrieved.
 * @param string             $feed Optional. Feed type. Possible values include &#039;rss2&#039;, &#039;atom&#039;.
 *                                 Default is the value of get_default_feed().
 * @return string Link to the feed for the category specified by `$cat`.
 */
function get_category_feed_link( $cat, $feed = &#039;&#039; ) {
	return get_term_feed_link( $cat, &#039;category&#039;, $feed );
}

/**
 * Retrieves the feed link for a term.
 *
 * Returns a link to the feed for all posts in a given term. A specific feed
 * can be requested or left blank to get the default feed.
 *
 * @since 3.0.0
 *
 * @param int|WP_Term|object $term     The ID or term object whose feed link will be retrieved.
 * @param string             $taxonomy Optional. Taxonomy of `$term_id`.
 * @param string             $feed     Optional. Feed type. Possible values include &#039;rss2&#039;, &#039;atom&#039;.
 *                                     Default is the value of get_default_feed().
 * @return string|false Link to the feed for the term specified by `$term` and `$taxonomy`.
 */
function get_term_feed_link( $term, $taxonomy = &#039;&#039;, $feed = &#039;&#039; ) {
	if ( ! is_object( $term ) ) {
		$term = (int) $term;
	}

	$term = get_term( $term, $taxonomy );

	if ( empty( $term ) || is_wp_error( $term ) ) {
		return false;
	}

	$taxonomy = $term-&gt;taxonomy;

	if ( empty( $feed ) ) {
		$feed = get_default_feed();
	}

	$permalink_structure = get_option( &#039;permalink_structure&#039; );

	if ( ! $permalink_structure ) {
		if ( &#039;category&#039; === $taxonomy ) {
			$link = home_url( &quot;?feed=$feed&amp;amp;cat=$term-&gt;term_id&quot; );
		} elseif ( &#039;post_tag&#039; === $taxonomy ) {
			$link = home_url( &quot;?feed=$feed&amp;amp;tag=$term-&gt;slug&quot; );
		} else {
			$t    = get_taxonomy( $taxonomy );
			$link = home_url( &quot;?feed=$feed&amp;amp;$t-&gt;query_var=$term-&gt;slug&quot; );
		}
	} else {
		$link = get_term_link( $term, $term-&gt;taxonomy );
		if ( get_default_feed() === $feed ) {
			$feed_link = &#039;feed&#039;;
		} else {
			$feed_link = &quot;feed/$feed&quot;;
		}

		$link = trailingslashit( $link ) . user_trailingslashit( $feed_link, &#039;feed&#039; );
	}

	if ( &#039;category&#039; === $taxonomy ) {
		/**
		 * Filters the category feed link.
		 *
		 * @since 1.5.1
		 *
		 * @param string $link The category feed link.
		 * @param string $feed Feed type. Possible values include &#039;rss2&#039;, &#039;atom&#039;.
		 */
		$link = apply_filters( &#039;category_feed_link&#039;, $link, $feed );
	} elseif ( &#039;post_tag&#039; === $taxonomy ) {
		/**
		 * Filters the post tag feed link.
		 *
		 * @since 2.3.0
		 *
		 * @param string $link The tag feed link.
		 * @param string $feed Feed type. Possible values include &#039;rss2&#039;, &#039;atom&#039;.
		 */
		$link = apply_filters( &#039;tag_feed_link&#039;, $link, $feed );
	} else {
		/**
		 * Filters the feed link for a taxonomy other than &#039;category&#039; or &#039;post_tag&#039;.
		 *
		 * @since 3.0.0
		 *
		 * @param string $link     The taxonomy feed link.
		 * @param string $feed     Feed type. Possible values include &#039;rss2&#039;, &#039;atom&#039;.
		 * @param string $taxonomy The taxonomy name.
		 */
		$link = apply_filters( &#039;taxonomy_feed_link&#039;, $link, $feed, $taxonomy );
	}

	return $link;
}

/**
 * Retrieves the permalink for a tag feed.
 *
 * @since 2.3.0
 *
 * @param int|WP_Term|object $tag  The ID or term object whose feed link will be retrieved.
 * @param string             $feed Optional. Feed type. Possible values include &#039;rss2&#039;, &#039;atom&#039;.
 *                                 Default is the value of get_default_feed().
 * @return string                  The feed permalink for the given tag.
 */
function get_tag_feed_link( $tag, $feed = &#039;&#039; ) {
	return get_term_feed_link( $tag, &#039;post_tag&#039;, $feed );
}

/**
 * Retrieves the edit link for a tag.
 *
 * @since 2.7.0
 *
 * @param int|WP_Term|object $tag      The ID or term object whose edit link will be retrieved.
 * @param string             $taxonomy Optional. Taxonomy slug. Default &#039;post_tag&#039;.
 * @return string The edit tag link URL for the given tag.
 */
function get_edit_tag_link( $tag, $taxonomy = &#039;post_tag&#039; ) {
	/**
	 * Filters the edit link for a tag (or term in another taxonomy).
	 *
	 * @since 2.7.0
	 *
	 * @param string $link The term edit link.
	 */
	return apply_filters( &#039;get_edit_tag_link&#039;, get_edit_term_link( $tag, $taxonomy ) );
}

/**
 * Displays or retrieves the edit link for a tag with formatting.
 *
 * @since 2.7.0
 *
 * @param string  $link   Optional. Anchor text. If empty, default is &#039;Edit This&#039;. Default empty.
 * @param string  $before Optional. Display before edit link. Default empty.
 * @param string  $after  Optional. Display after edit link. Default empty.
 * @param WP_Term $tag    Optional. Term object. If null, the queried object will be inspected.
 *                        Default null.
 */
function edit_tag_link( $link = &#039;&#039;, $before = &#039;&#039;, $after = &#039;&#039;, $tag = null ) {
	$link = edit_term_link( $link, &#039;&#039;, &#039;&#039;, $tag, false );

	/**
	 * Filters the anchor tag for the edit link for a tag (or term in another taxonomy).
	 *
	 * @since 2.7.0
	 *
	 * @param string $link The anchor tag for the edit link.
	 */
	echo $before . apply_filters( &#039;edit_tag_link&#039;, $link ) . $after;
}

/**
 * Retrieves the URL for editing a given term.
 *
 * @since 3.1.0
 * @since 4.5.0 The `$taxonomy` parameter was made optional.
 *
 * @param int|WP_Term|object $term        The ID or term object whose edit link will be retrieved.
 * @param string             $taxonomy    Optional. Taxonomy. Defaults to the taxonomy of the term identified
 *                                        by `$term`.
 * @param string             $object_type Optional. The object type. Used to highlight the proper post type
 *                                        menu on the linked page. Defaults to the first object_type associated
 *                                        with the taxonomy.
 * @return string|null The edit term link URL for the given term, or null on failure.
 */
function get_edit_term_link( $term, $taxonomy = &#039;&#039;, $object_type = &#039;&#039; ) {
	$term = get_term( $term, $taxonomy );
	if ( ! $term || is_wp_error( $term ) ) {
		return;
	}

	$tax     = get_taxonomy( $term-&gt;taxonomy );
	$term_id = $term-&gt;term_id;
	if ( ! $tax || ! current_user_can( &#039;edit_term&#039;, $term_id ) ) {
		return;
	}

	$args = array(
		&#039;taxonomy&#039; =&gt; $tax-&gt;name,
		&#039;tag_ID&#039;   =&gt; $term_id,
	);

	if ( $object_type ) {
		$args[&#039;post_type&#039;] = $object_type;
	} elseif ( ! empty( $tax-&gt;object_type ) ) {
		$args[&#039;post_type&#039;] = reset( $tax-&gt;object_type );
	}

	if ( $tax-&gt;show_ui ) {
		$location = add_query_arg( $args, admin_url( &#039;term.php&#039; ) );
	} else {
		$location = &#039;&#039;;
	}

	/**
	 * Filters the edit link for a term.
	 *
	 * @since 3.1.0
	 *
	 * @param string $location    The edit link.
	 * @param int    $term_id     Term ID.
	 * @param string $taxonomy    Taxonomy name.
	 * @param string $object_type The object type.
	 */
	return apply_filters( &#039;get_edit_term_link&#039;, $location, $term_id, $taxonomy, $object_type );
}

/**
 * Displays or retrieves the edit term link with formatting.
 *
 * @since 3.1.0
 *
 * @param string           $link    Optional. Anchor text. If empty, default is &#039;Edit This&#039;. Default empty.
 * @param string           $before  Optional. Display before 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 bool             $display Optional. Whether or not to echo the return. Default true.
 * @return string|void HTML content.
 */
function edit_term_link( $link = &#039;&#039;, $before = &#039;&#039;, $after = &#039;&#039;, $term = null, $display = true ) {
	if ( is_null( $term ) ) {
		$term = get_queried_object();
	} else {
		$term = get_term( $term );
	}

	if ( ! $term ) {
		return;
	}

	$tax = get_taxonomy( $term-&gt;taxonomy );
	if ( ! current_user_can( &#039;edit_term&#039;, $term-&gt;term_id ) ) {
		return;
	}

	if ( empty( $link ) ) {
		$link = __( &#039;Edit This&#039; );
	}

	$link = &#039;&lt;a href=&quot;&#039; . get_edit_term_link( $term-&gt;term_id, $term-&gt;taxonomy ) . &#039;&quot;&gt;&#039; . $link . &#039;&lt;/a&gt;&#039;;

	/**
	 * Filters the anchor tag for the edit link of a term.
	 *
	 * @since 3.1.0
	 *
	 * @param string $link    The anchor tag for the edit link.
	 * @param int    $term_id Term ID.
	 */
	$link = $before . apply_filters( &#039;edit_term_link&#039;, $link, $term-&gt;term_id ) . $after;

	if ( $display ) {
		echo $link;
	} else {
		return $link;
	}
}

/**
 * Retrieves the permalink for a search.
 *
 * @since 3.0.0
 *
 * @global WP_Rewrite $wp_rewrite WordPress rewrite component.
 *
 * @param string $query Optional. The query string to use. If empty the current query is used. Default empty.
 * @return string The search permalink.
 */
function get_search_link( $query = &#039;&#039; ) {
	global $wp_rewrite;

	if ( empty( $query ) ) {
		$search = get_search_query( false );
	} else {
		$search = stripslashes( $query );
	}

	$permastruct = $wp_rewrite-&gt;get_search_permastruct();

	if ( empty( $permastruct ) ) {
		$link = home_url( &#039;?s=&#039; . urlencode( $search ) );
	} else {
		$search = urlencode( $search );
		$search = str_replace( &#039;%2F&#039;, &#039;/&#039;, $search ); // %2F(/) is not valid within a URL, send it un-encoded.
		$link   = str_replace( &#039;%search%&#039;, $search, $permastruct );
		$link   = home_url( user_trailingslashit( $link, &#039;search&#039; ) );
	}

	/**
	 * Filters the search permalink.
	 *
	 * @since 3.0.0
	 *
	 * @param string $link   Search permalink.
	 * @param string $search The URL-encoded search term.
	 */
	return apply_filters( &#039;search_link&#039;, $link, $search );
}

/**
 * Retrieves the permalink for the search results feed.
 *
 * @since 2.5.0
 *
 * @global WP_Rewrite $wp_rewrite WordPress rewrite component.
 *
 * @param string $search_query Optional. Search query. Default empty.
 * @param string $feed         Optional. Feed type. Possible values include &#039;rss2&#039;, &#039;atom&#039;.
 *                             Default is the value of get_default_feed().
 * @return string The search results feed permalink.
 */
function get_search_feed_link( $search_query = &#039;&#039;, $feed = &#039;&#039; ) {
	global $wp_rewrite;
	$link = get_search_link( $search_query );

	if ( empty( $feed ) ) {
		$feed = get_default_feed();
	}

	$permastruct = $wp_rewrite-&gt;get_search_permastruct();

	if ( empty( $permastruct ) ) {
		$link = add_query_arg( &#039;feed&#039;, $feed, $link );
	} else {
		$link  = trailingslashit( $link );
		$link .= &quot;feed/$feed/&quot;;
	}

	/**
	 * Filters the search feed link.
	 *
	 * @since 2.5.0
	 *
	 * @param string $link Search feed link.
	 * @param string $feed Feed type. Possible values include &#039;rss2&#039;, &#039;atom&#039;.
	 * @param string $type The search type. One of &#039;posts&#039; or &#039;comments&#039;.
	 */
	return apply_filters( &#039;search_feed_link&#039;, $link, $feed, &#039;posts&#039; );
}

/**
 * Retrieves the permalink for the search results comments feed.
 *
 * @since 2.5.0
 *
 * @global WP_Rewrite $wp_rewrite WordPress rewrite component.
 *
 * @param string $search_query Optional. Search query. Default empty.
 * @param string $feed         Optional. Feed type. Possible values include &#039;rss2&#039;, &#039;atom&#039;.
 *                             Default is the value of get_default_feed().
 * @return string The comments feed search results permalink.
 */
function get_search_comments_feed_link( $search_query = &#039;&#039;, $feed = &#039;&#039; ) {
	global $wp_rewrite;

	if ( empty( $feed ) ) {
		$feed = get_default_feed();
	}

	$link = get_search_feed_link( $search_query, $feed );

	$permastruct = $wp_rewrite-&gt;get_search_permastruct();

	if ( empty( $permastruct ) ) {
		$link = add_query_arg( &#039;feed&#039;, &#039;comments-&#039; . $feed, $link );
	} else {
		$link = add_query_arg( &#039;withcomments&#039;, 1, $link );
	}

	/** This filter is documented in wp-includes/link-template.php */
	return apply_filters( &#039;search_feed_link&#039;, $link, $feed, &#039;comments&#039; );
}

/**
 * Retrieves the permalink for a post type archive.
 *
 * @since 3.1.0
 * @since 4.5.0 Support for posts was added.
 *
 * @global WP_Rewrite $wp_rewrite WordPress rewrite component.
 *
 * @param string $post_type Post type.
 * @return string|false The post type archive permalink. False if the post type
 *                      does not exist or does not have an archive.
 */
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 ( &#039;post&#039; === $post_type ) {
		$show_on_front  = get_option( &#039;show_on_front&#039; );
		$page_for_posts = get_option( &#039;page_for_posts&#039; );

		if ( &#039;page&#039; === $show_on_front &amp;&amp; $page_for_posts ) {
			$link = get_permalink( $page_for_posts );
		} else {
			$link = get_home_url();
		}
		/** This filter is documented in wp-includes/link-template.php */
		return apply_filters( &#039;post_type_archive_link&#039;, $link, $post_type );
	}

	if ( ! $post_type_obj-&gt;has_archive ) {
		return false;
	}

	if ( get_option( &#039;permalink_structure&#039; ) &amp;&amp; is_array( $post_type_obj-&gt;rewrite ) ) {
		$struct = ( true === $post_type_obj-&gt;has_archive ) ? $post_type_obj-&gt;rewrite[&#039;slug&#039;] : $post_type_obj-&gt;has_archive;
		if ( $post_type_obj-&gt;rewrite[&#039;with_front&#039;] ) {
			$struct = $wp_rewrite-&gt;front . $struct;
		} else {
			$struct = $wp_rewrite-&gt;root . $struct;
		}
		$link = home_url( user_trailingslashit( $struct, &#039;post_type_archive&#039; ) );
	} else {
		$link = home_url( &#039;?post_type=&#039; . $post_type );
	}

	/**
	 * Filters the post type archive permalink.
	 *
	 * @since 3.1.0
	 *
	 * @param string $link      The post type archive permalink.
	 * @param string $post_type Post type name.
	 */
	return apply_filters( &#039;post_type_archive_link&#039;, $link, $post_type );
}

/**
 * Retrieves the permalink for a post type archive feed.
 *
 * @since 3.1.0
 *
 * @param string $post_type Post type.
 * @param string $feed      Optional. Feed type. Possible values include &#039;rss2&#039;, &#039;atom&#039;.
 *                          Default is the value of get_default_feed().
 * @return string|false The post type feed permalink. False if the post type
 *                      does not exist or does not have an archive.
 */
function get_post_type_archive_feed_link( $post_type, $feed = &#039;&#039; ) {
	$default_feed = get_default_feed();
	if ( empty( $feed ) ) {
		$feed = $default_feed;
	}

	$link = get_post_type_archive_link( $post_type );
	if ( ! $link ) {
		return false;
	}

	$post_type_obj = get_post_type_object( $post_type );
	if ( get_option( &#039;permalink_structure&#039; ) &amp;&amp; is_array( $post_type_obj-&gt;rewrite ) &amp;&amp; $post_type_obj-&gt;rewrite[&#039;feeds&#039;] ) {
		$link  = trailingslashit( $link );
		$link .= &#039;feed/&#039;;
		if ( $feed !== $default_feed ) {
			$link .= &quot;$feed/&quot;;
		}
	} else {
		$link = add_query_arg( &#039;feed&#039;, $feed, $link );
	}

	/**
	 * Filters the post type archive feed link.
	 *
	 * @since 3.1.0
	 *
	 * @param string $link The post type archive feed link.
	 * @param string $feed Feed type. Possible values include &#039;rss2&#039;, &#039;atom&#039;.
	 */
	return apply_filters( &#039;post_type_archive_feed_link&#039;, $link, $feed );
}

/**
 * Retrieves the URL used for the post preview.
 *
 * Allows additional query args to be appended.
 *
 * @since 4.4.0
 *
 * @param int|WP_Post $post         Optional. Post ID or `WP_Post` object. Defaults to global `$post`.
 * @param array       $query_args   Optional. Array of additional query args to be appended to the link.
 *                                  Default empty array.
 * @param string      $preview_link Optional. Base preview link to be used if it should differ from the
 *                                  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 = &#039;&#039; ) {
	$post = get_post( $post );

	if ( ! $post ) {
		return;
	}

	$post_type_object = get_post_type_object( $post-&gt;post_type );
	if ( is_post_type_viewable( $post_type_object ) ) {
		if ( ! $preview_link ) {
			$preview_link = set_url_scheme( get_permalink( $post ) );
		}

		$query_args[&#039;preview&#039;] = &#039;true&#039;;
		$preview_link          = add_query_arg( $query_args, $preview_link );
	}

	/**
	 * Filters the URL used for a post preview.
	 *
	 * @since 2.0.5
	 * @since 4.0.0 Added the `$post` parameter.
	 *
	 * @param string  $preview_link URL used for the post preview.
	 * @param WP_Post $post         Post object.
	 */
	return apply_filters( &#039;preview_post_link&#039;, $preview_link, $post );
}

/**
 * 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, revisions, global styles, templates, and template parts.
 *
 * @since 2.3.0
 * @since 6.3.0 Adds custom link for wp_navigation post types.
 *              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 &#039;&amp;&#039; character. Default &#039;&amp;amp;&#039;.
 * @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( $post = 0, $context = &#039;display&#039; ) {
	$post = get_post( $post );

	if ( ! $post ) {
		return;
	}

	if ( &#039;revision&#039; === $post-&gt;post_type ) {
		$action = &#039;&#039;;
	} elseif ( &#039;display&#039; === $context ) {
		$action = &#039;&amp;amp;action=edit&#039;;
	} else {
		$action = &#039;&amp;action=edit&#039;;
	}

	$post_type_object = get_post_type_object( $post-&gt;post_type );

	if ( ! $post_type_object ) {
		return;
	}

	if ( ! current_user_can( &#039;edit_post&#039;, $post-&gt;ID ) ) {
		return;
	}

	$link = &#039;&#039;;

	if ( &#039;wp_template&#039; === $post-&gt;post_type || &#039;wp_template_part&#039; === $post-&gt;post_type ) {
		$slug = urlencode( get_stylesheet() . &#039;//&#039; . $post-&gt;post_name );
		$link = admin_url( sprintf( $post_type_object-&gt;_edit_link, $post-&gt;post_type, $slug ) );
	} elseif ( &#039;wp_navigation&#039; === $post-&gt;post_type ) {
		$link = admin_url( sprintf( $post_type_object-&gt;_edit_link, (string) $post-&gt;ID ) );
	} elseif ( $post_type_object-&gt;_edit_link ) {
		$link = admin_url( sprintf( $post_type_object-&gt;_edit_link . $action, $post-&gt;ID ) );
	}

	/**
	 * Filters the post edit link.
	 *
	 * @since 2.3.0
	 *
	 * @param string $link    The edit link.
	 * @param int    $post_id Post ID.
	 * @param string $context The link context. If set to &#039;display&#039; then ampersands
	 *                        are encoded.
	 */
	return apply_filters( &#039;get_edit_post_link&#039;, $link, $post-&gt;ID, $context );
}

/**
 * Displays the edit post link for post.
 *
 * @since 1.0.0
 * @since 4.4.0 The `$css_class` argument was added.
 *
 * @param string      $text      Optional. Anchor text. If null, default is &#039;Edit This&#039;. Default null.
 * @param string      $before    Optional. Display before edit link. Default empty.
 * @param string      $after     Optional. Display after edit link. Default empty.
 * @param int|WP_Post $post      Optional. Post ID or post object. Default is the global `$post`.
 * @param string      $css_class Optional. Add custom class to link. Default &#039;post-edit-link&#039;.
 */
function edit_post_link( $text = null, $before = &#039;&#039;, $after = &#039;&#039;, $post = 0, $css_class = &#039;post-edit-link&#039; ) {
	$post = get_post( $post );

	if ( ! $post ) {
		return;
	}

	$url = get_edit_post_link( $post-&gt;ID );

	if ( ! $url ) {
		return;
	}

	if ( null === $text ) {
		$text = __( &#039;Edit This&#039; );
	}

	$link = &#039;&lt;a class=&quot;&#039; . esc_attr( $css_class ) . &#039;&quot; href=&quot;&#039; . esc_url( $url ) . &#039;&quot;&gt;&#039; . $text . &#039;&lt;/a&gt;&#039;;

	/**
	 * Filters the post edit link anchor tag.
	 *
	 * @since 2.3.0
	 *
	 * @param string $link    Anchor tag for the edit link.
	 * @param int    $post_id Post ID.
	 * @param string $text    Anchor text.
	 */
	echo $before . apply_filters( &#039;edit_post_link&#039;, $link, $post-&gt;ID, $text ) . $after;
}

/**
 * Retrieves the delete posts link for post.
 *
 * Can be used within the WordPress loop or outside of it, with any post type.
 *
 * @since 2.9.0
 *
 * @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( $post = 0, $deprecated = &#039;&#039;, $force_delete = false ) {
	if ( ! empty( $deprecated ) ) {
		_deprecated_argument( __FUNCTION__, &#039;3.0.0&#039; );
	}

	$post = get_post( $post );

	if ( ! $post ) {
		return;
	}

	$post_type_object = get_post_type_object( $post-&gt;post_type );

	if ( ! $post_type_object ) {
		return;
	}

	if ( ! current_user_can( &#039;delete_post&#039;, $post-&gt;ID ) ) {
		return;
	}

	$action = ( $force_delete || ! EMPTY_TRASH_DAYS ) ? &#039;delete&#039; : &#039;trash&#039;;

	$delete_link = add_query_arg( &#039;action&#039;, $action, admin_url( sprintf( $post_type_object-&gt;_edit_link, $post-&gt;ID ) ) );

	/**
	 * Filters the post delete link.
	 *
	 * @since 2.9.0
	 *
	 * @param string $link         The delete link.
	 * @param int    $post_id      Post ID.
	 * @param bool   $force_delete Whether to bypass the Trash and force deletion. Default false.
	 */
	return apply_filters( &#039;get_delete_post_link&#039;, wp_nonce_url( $delete_link, &quot;$action-post_{$post-&gt;ID}&quot; ), $post-&gt;ID, $force_delete );
}

/**
 * Retrieves the edit comment link.
 *
 * @since 2.3.0
 * @since 6.7.0 The $context parameter was added.
 *
 * @param int|WP_Comment $comment_id Optional. Comment ID or WP_Comment object.
 * @param string         $context    Optional. Context in which the URL should be used. Either &#039;display&#039;,
 *                                   to include HTML entities, or &#039;url&#039;. Default &#039;display&#039;.
 * @return string|void The edit comment link URL for the given comment, or void if the comment id does not exist or
 *                     the current user is not allowed to edit it.
 */
function get_edit_comment_link( $comment_id = 0, $context = &#039;display&#039; ) {
	$comment = get_comment( $comment_id );

	if ( ! is_object( $comment ) || ! current_user_can( &#039;edit_comment&#039;, $comment-&gt;comment_ID ) ) {
		return;
	}

	if ( &#039;display&#039; === $context ) {
		$action = &#039;comment.php?action=editcomment&amp;amp;c=&#039;;
	} else {
		$action = &#039;comment.php?action=editcomment&amp;c=&#039;;
	}

	$location = admin_url( $action ) . $comment-&gt;comment_ID;

	// Ensure the $comment_id variable passed to the filter is always an ID.
	$comment_id = (int) $comment-&gt;comment_ID;

	/**
	 * Filters the comment edit link.
	 *
	 * @since 2.3.0
	 * @since 6.7.0 The $comment_id and $context parameters are now being passed to the filter.
	 *
	 * @param string $location   The edit link.
	 * @param int    $comment_id Unique ID of the comment to generate an edit link.
	 * @param string $context    Context to include HTML entities in link. Default &#039;display&#039;.
	 */
	return apply_filters( &#039;get_edit_comment_link&#039;, $location, $comment_id, $context );
}

/**
 * Displays the edit comment link with formatting.
 *
 * @since 1.0.0
 *
 * @param string $text   Optional. Anchor text. If null, default is &#039;Edit This&#039;. Default null.
 * @param string $before Optional. Display before edit link. Default empty.
 * @param string $after  Optional. Display after edit link. Default empty.
 */
function edit_comment_link( $text = null, $before = &#039;&#039;, $after = &#039;&#039; ) {
	$comment = get_comment();

	if ( ! current_user_can( &#039;edit_comment&#039;, $comment-&gt;comment_ID ) ) {
		return;
	}

	if ( null === $text ) {
		$text = __( &#039;Edit This&#039; );
	}

	$link = &#039;&lt;a class=&quot;comment-edit-link&quot; href=&quot;&#039; . esc_url( get_edit_comment_link( $comment ) ) . &#039;&quot;&gt;&#039; . $text . &#039;&lt;/a&gt;&#039;;

	/**
	 * Filters the comment edit link anchor tag.
	 *
	 * @since 2.3.0
	 *
	 * @param string $link       Anchor tag for the edit link.
	 * @param string $comment_id Comment ID as a numeric string.
	 * @param string $text       Anchor text.
	 */
	echo $before . apply_filters( &#039;edit_comment_link&#039;, $link, $comment-&gt;comment_ID, $text ) . $after;
}

/**
 * Displays the edit bookmark link.
 *
 * @since 2.7.0
 *
 * @param int|stdClass $link Optional. Bookmark ID. Default is the ID of the current bookmark.
 * @return string|void The edit bookmark link URL.
 */
function get_edit_bookmark_link( $link = 0 ) {
	$link = get_bookmark( $link );

	if ( ! current_user_can( &#039;manage_links&#039; ) ) {
		return;
	}

	$location = admin_url( &#039;link.php?action=edit&amp;amp;link_id=&#039; ) . $link-&gt;link_id;

	/**
	 * Filters the bookmark edit link.
	 *
	 * @since 2.7.0
	 *
	 * @param string $location The edit link.
	 * @param int    $link_id  Bookmark ID.
	 */
	return apply_filters( &#039;get_edit_bookmark_link&#039;, $location, $link-&gt;link_id );
}

/**
 * Displays the edit bookmark link anchor content.
 *
 * @since 2.7.0
 *
 * @param string $link     Optional. Anchor text. If empty, default is &#039;Edit This&#039;. Default empty.
 * @param string $before   Optional. Display before edit link. Default empty.
 * @param string $after    Optional. Display after edit link. Default empty.
 * @param int    $bookmark Optional. Bookmark ID. Default is the current bookmark.
 */
function edit_bookmark_link( $link = &#039;&#039;, $before = &#039;&#039;, $after = &#039;&#039;, $bookmark = null ) {
	$bookmark = get_bookmark( $bookmark );

	if ( ! current_user_can( &#039;manage_links&#039; ) ) {
		return;
	}

	if ( empty( $link ) ) {
		$link = __( &#039;Edit This&#039; );
	}

	$link = &#039;&lt;a href=&quot;&#039; . esc_url( get_edit_bookmark_link( $bookmark ) ) . &#039;&quot;&gt;&#039; . $link . &#039;&lt;/a&gt;&#039;;

	/**
	 * Filters the bookmark edit link anchor tag.
	 *
	 * @since 2.7.0
	 *
	 * @param string $link    Anchor tag for the edit link.
	 * @param int    $link_id Bookmark ID.
	 */
	echo $before . apply_filters( &#039;edit_bookmark_link&#039;, $link, $bookmark-&gt;link_id ) . $after;
}

/**
 * Retrieves the edit user link.
 *
 * @since 3.5.0
 *
 * @param int $user_id Optional. User ID. Defaults to the current user.
 * @return string URL to edit user page or empty string.
 */
function get_edit_user_link( $user_id = null ) {
	if ( ! $user_id ) {
		$user_id = get_current_user_id();
	}

	if ( empty( $user_id ) || ! current_user_can( &#039;edit_user&#039;, $user_id ) ) {
		return &#039;&#039;;
	}

	$user = get_userdata( $user_id );

	if ( ! $user ) {
		return &#039;&#039;;
	}

	if ( get_current_user_id() === $user-&gt;ID ) {
		$link = get_edit_profile_url( $user-&gt;ID );
	} else {
		$link = add_query_arg( &#039;user_id&#039;, $user-&gt;ID, self_admin_url( &#039;user-edit.php&#039; ) );
	}

	/**
	 * Filters the user edit link.
	 *
	 * @since 3.5.0
	 *
	 * @param string $link    The edit link.
	 * @param int    $user_id User ID.
	 */
	return apply_filters( &#039;get_edit_user_link&#039;, $link, $user-&gt;ID );
}

//
// Navigation links.
//

/**
 * 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 the same taxonomy term.
 *                                     Default false.
 * @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 &#039;category&#039;.
 * @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 = &#039;&#039;, $taxonomy = &#039;category&#039; ) {
	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 the same taxonomy term.
 *                                     Default false.
 * @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 &#039;category&#039;.
 * @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 = &#039;&#039;, $taxonomy = &#039;category&#039; ) {
	return get_adjacent_post( $in_same_term, $excluded_terms, false, $taxonomy );
}

/**
 * Retrieves the adjacent post.
 *
 * Can either be next or previous post.
 *
 * @since 2.5.0
 *
 * @global wpdb $wpdb WordPress database abstraction object.
 *
 * @param bool         $in_same_term   Optional. Whether 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 string.
 * @param bool         $previous       Optional. Whether to retrieve previous post.
 *                                     Default true.
 * @param string       $taxonomy       Optional. Taxonomy, if `$in_same_term` is true. Default &#039;category&#039;.
 * @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 = &#039;&#039;, $previous = true, $taxonomy = &#039;category&#039; ) {
	global $wpdb;

	$post = get_post();

	if ( ! $post || ! taxonomy_exists( $taxonomy ) ) {
		return null;
	}

	$current_post_date = $post-&gt;post_date;

	$join     = &#039;&#039;;
	$where    = &#039;&#039;;
	$adjacent = $previous ? &#039;previous&#039; : &#039;next&#039;;

	if ( ! empty( $excluded_terms ) &amp;&amp; ! is_array( $excluded_terms ) ) {
		// Back-compat, $excluded_terms used to be $excluded_categories with IDs separated by &quot; and &quot;.
		if ( str_contains( $excluded_terms, &#039; and &#039; ) ) {
			_deprecated_argument(
				__FUNCTION__,
				&#039;3.3.0&#039;,
				sprintf(
					/* translators: %s: The word &#039;and&#039;. */
					__( &#039;Use commas instead of %s to separate excluded terms.&#039; ),
					&quot;&#039;and&#039;&quot;
				)
			);
			$excluded_terms = explode( &#039; and &#039;, $excluded_terms );
		} else {
			$excluded_terms = explode( &#039;,&#039;, $excluded_terms );
		}

		$excluded_terms = array_map( &#039;intval&#039;, $excluded_terms );
	}

	/**
	 * Filters the IDs of terms excluded from adjacent post queries.
	 *
	 * The dynamic portion of the hook name, `$adjacent`, refers to the type
	 * of adjacency, &#039;next&#039; or &#039;previous&#039;.
	 *
	 * Possible hook names include:
	 *
	 *  - `get_next_post_excluded_terms`
	 *  - `get_previous_post_excluded_terms`
	 *
	 * @since 4.4.0
	 *
	 * @param int[]|string $excluded_terms Array of excluded term IDs. Empty string if none were provided.
	 */
	$excluded_terms = apply_filters( &quot;get_{$adjacent}_post_excluded_terms&quot;, $excluded_terms );

	if ( $in_same_term || ! empty( $excluded_terms ) ) {
		if ( $in_same_term ) {
			$join  .= &quot; INNER JOIN $wpdb-&gt;term_relationships AS tr ON p.ID = tr.object_id INNER JOIN $wpdb-&gt;term_taxonomy AS tt ON tr.term_taxonomy_id = tt.term_taxonomy_id&quot;;
			$where .= $wpdb-&gt;prepare( &#039;AND tt.taxonomy = %s&#039;, $taxonomy );

			if ( ! is_object_in_taxonomy( $post-&gt;post_type, $taxonomy ) ) {
				return &#039;&#039;;
			}
			$term_array = wp_get_object_terms( $post-&gt;ID, $taxonomy, array( &#039;fields&#039; =&gt; &#039;ids&#039; ) );
			if ( is_wp_error( $term_array ) ) {
				return &#039;&#039;;
			}

			// Remove any exclusions from the term array to include.
			$term_array = array_diff( $term_array, (array) $excluded_terms );

			if ( ! $term_array ) {
				return &#039;&#039;;
			}

			$term_array = array_map( &#039;intval&#039;, $term_array );

			$where .= &#039; AND tt.term_id IN (&#039; . implode( &#039;,&#039;, $term_array ) . &#039;)&#039;;
		}

		if ( ! empty( $excluded_terms ) ) {
			$where .= &quot; AND p.ID NOT IN ( SELECT tr.object_id FROM $wpdb-&gt;term_relationships tr LEFT JOIN $wpdb-&gt;term_taxonomy tt ON (tr.term_taxonomy_id = tt.term_taxonomy_id) WHERE tt.term_id IN (&quot; . implode( &#039;,&#039;, array_map( &#039;intval&#039;, $excluded_terms ) ) . &#039;) )&#039;;
		}
	}

	// &#039;post_status&#039; clause depends on the current user.
	if ( is_user_logged_in() ) {
		$user_id = get_current_user_id();

		$post_type_object = get_post_type_object( $post-&gt;post_type );
		if ( empty( $post_type_object ) ) {
			$post_type_cap    = $post-&gt;post_type;
			$read_private_cap = &#039;read_private_&#039; . $post_type_cap . &#039;s&#039;;
		} else {
			$read_private_cap = $post_type_object-&gt;cap-&gt;read_private_posts;
		}

		/*
		 * Results should include private posts belonging to the current user, or private posts where the
		 * current user has the &#039;read_private_posts&#039; cap.
		 */
		$private_states = get_post_stati( array( &#039;private&#039; =&gt; true ) );
		$where         .= &quot; AND ( p.post_status = &#039;publish&#039;&quot;;
		foreach ( $private_states as $state ) {
			if ( current_user_can( $read_private_cap ) ) {
				$where .= $wpdb-&gt;prepare( &#039; OR p.post_status = %s&#039;, $state );
			} else {
				$where .= $wpdb-&gt;prepare( &#039; OR (p.post_author = %d AND p.post_status = %s)&#039;, $user_id, $state );
			}
		}
		$where .= &#039; )&#039;;
	} else {
		$where .= &quot; AND p.post_status = &#039;publish&#039;&quot;;
	}

	$comparison_operator = $previous ? &#039;&lt;&#039; : &#039;&gt;&#039;;
	$order               = $previous ? &#039;DESC&#039; : &#039;ASC&#039;;

	/**
	 * Filters the JOIN clause in the SQL for an adjacent post query.
	 *
	 * The dynamic portion of the hook name, `$adjacent`, refers to the type
	 * of adjacency, &#039;next&#039; or &#039;previous&#039;.
	 *
	 * Possible hook names include:
	 *
	 *  - `get_next_post_join`
	 *  - `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 bool         $in_same_term   Whether post should be in the same taxonomy term.
	 * @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 WP_Post      $post           WP_Post object.
	 */
	$join = apply_filters( &quot;get_{$adjacent}_post_join&quot;, $join, $in_same_term, $excluded_terms, $taxonomy, $post );

	// Prepare the where clause for the adjacent post query.
	$where_prepared = $wpdb-&gt;prepare( &quot;WHERE (p.post_date $comparison_operator %s OR (p.post_date = %s AND p.ID $comparison_operator %d)) AND p.post_type = %s $where&quot;, $current_post_date, $current_post_date, $post-&gt;ID, $post-&gt;post_type ); // phpcs:ignore WordPress.DB.PreparedSQL.InterpolatedNotPrepared -- $comparison_operator is a string literal, either &#039;&lt;&#039; or &#039;&gt;&#039;.

	/**
	 * Filters the WHERE clause in the SQL for an adjacent post query.
	 *
	 * The dynamic portion of the hook name, `$adjacent`, refers to the type
	 * of adjacency, &#039;next&#039; or &#039;previous&#039;.
	 *
	 * Possible hook names include:
	 *
	 *  - `get_next_post_where`
	 *  - `get_previous_post_where`
	 *
	 * @since 2.5.0
	 * @since 4.4.0 Added the `$taxonomy` and `$post` parameters.
	 * @since 6.9.0 Adds ID-based fallback for posts with identical dates in adjacent post queries.
	 *
	 * @param string       $where          The `WHERE` clause in the SQL.
	 * @param bool         $in_same_term   Whether post should be in the same taxonomy term.
	 * @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 WP_Post      $post           WP_Post object.
	 */
	$where = apply_filters( &quot;get_{$adjacent}_post_where&quot;, $where_prepared, $in_same_term, $excluded_terms, $taxonomy, $post );

	/**
	 * Filters the ORDER BY clause in the SQL for an adjacent post query.
	 *
	 * The dynamic portion of the hook name, `$adjacent`, refers to the type
	 * of adjacency, &#039;next&#039; or &#039;previous&#039;.
	 *
	 * Possible hook names include:
	 *
	 *  - `get_next_post_sort`
	 *  - `get_previous_post_sort`
	 *
	 * @since 2.5.0
	 * @since 4.4.0 Added the `$post` parameter.
	 * @since 4.9.0 Added the `$order` parameter.
	 * @since 6.9.0 Adds ID sort to ensure deterministic ordering for posts with identical dates.
	 *
	 * @param string $order_by The `ORDER BY` clause in the SQL.
	 * @param WP_Post $post    WP_Post object.
	 * @param string  $order   Sort order. &#039;DESC&#039; for previous post, &#039;ASC&#039; for next.
	 */
	$sort = apply_filters( &quot;get_{$adjacent}_post_sort&quot;, &quot;ORDER BY p.post_date $order, p.ID $order LIMIT 1&quot;, $post, $order );

	$query        = &quot;SELECT p.ID FROM $wpdb-&gt;posts AS p $join $where $sort&quot;;
	$key          = md5( $query );
	$last_changed = (array) wp_cache_get_last_changed( &#039;posts&#039; );
	if ( $in_same_term || ! empty( $excluded_terms ) ) {
		$last_changed[] = wp_cache_get_last_changed( &#039;terms&#039; );
	}
	$cache_key = &quot;adjacent_post:$key&quot;;

	$result = wp_cache_get_salted( $cache_key, &#039;post-queries&#039;, $last_changed );
	if ( false !== $result ) {
		if ( $result ) {
			$result = get_post( $result );
		}
		return $result;
	}

	$result = $wpdb-&gt;get_var( $query );
	if ( null === $result ) {
		$result = &#039;&#039;;
	}

	wp_cache_set_salted( $cache_key, $result, &#039;post-queries&#039;, $last_changed );

	if ( $result ) {
		$result = get_post( $result );
	}

	return $result;
}

/**
 * Retrieves the adjacent post relational link.
 *
 * Can either be next or previous post relational link.
 *
 * @since 2.8.0
 *
 * @param string       $title          Optional. Link title format. Default &#039;%title&#039;.
 * @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 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 &#039;category&#039;.
 * @return string|void The adjacent post relational link URL.
 */
function get_adjacent_post_rel_link( $title = &#039;%title&#039;, $in_same_term = false, $excluded_terms = &#039;&#039;, $previous = true, $taxonomy = &#039;category&#039; ) {
	$post = get_post();
	if ( $previous &amp;&amp; is_attachment() &amp;&amp; $post ) {
		$post = get_post( $post-&gt;post_parent );
	} else {
		$post = get_adjacent_post( $in_same_term, $excluded_terms, $previous, $taxonomy );
	}

	if ( empty( $post ) ) {
		return;
	}

	$post_title = the_title_attribute(
		array(
			&#039;echo&#039; =&gt; false,
			&#039;post&#039; =&gt; $post,
		)
	);

	if ( empty( $post_title ) ) {
		$post_title = $previous ? __( &#039;Previous Post&#039; ) : __( &#039;Next Post&#039; );
	}

	$date = mysql2date( get_option( &#039;date_format&#039; ), $post-&gt;post_date );

	$title = str_replace( &#039;%title&#039;, $post_title, $title );
	$title = str_replace( &#039;%date&#039;, $date, $title );

	$link  = $previous ? &quot;&lt;link rel=&#039;prev&#039; title=&#039;&quot; : &quot;&lt;link rel=&#039;next&#039; title=&#039;&quot;;
	$link .= esc_attr( $title );
	$link .= &quot;&#039; href=&#039;&quot; . get_permalink( $post ) . &quot;&#039; /&gt;\n&quot;;

	$adjacent = $previous ? &#039;previous&#039; : &#039;next&#039;;

	/**
	 * Filters the adjacent post relational link.
	 *
	 * The dynamic portion of the hook name, `$adjacent`, refers to the type
	 * of adjacency, &#039;next&#039; or &#039;previous&#039;.
	 *
	 * Possible hook names include:
	 *
	 *  - `next_post_rel_link`
	 *  - `previous_post_rel_link`
	 *
	 * @since 2.8.0
	 *
	 * @param string $link The relational link.
	 */
	return apply_filters( &quot;{$adjacent}_post_rel_link&quot;, $link );
}

/**
 * Displays the relational links for the posts adjacent to the current post.
 *
 * @since 2.8.0
 *
 * @param string       $title          Optional. Link title format. Default &#039;%title&#039;.
 * @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 empty.
 * @param string       $taxonomy       Optional. Taxonomy, if `$in_same_term` is true. Default &#039;category&#039;.
 */
function adjacent_posts_rel_link( $title = &#039;%title&#039;, $in_same_term = false, $excluded_terms = &#039;&#039;, $taxonomy = &#039;category&#039; ) {
	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 );
}

/**
 * Displays relational links for the posts adjacent to the current post for single post pages.
 *
 * This is meant to be attached to actions like &#039;wp_head&#039;. Do not call this directly in plugins
 * or theme templates.
 *
 * @since 3.0.0
 * @since 5.6.0 No longer used in core.
 *
 * @see adjacent_posts_rel_link()
 */
function adjacent_posts_rel_link_wp_head() {
	if ( ! is_single() || is_attachment() ) {
		return;
	}
	adjacent_posts_rel_link();
}

/**
 * Displays the relational link for the next post adjacent to the current post.
 *
 * @since 2.8.0
 *
 * @see get_adjacent_post_rel_link()
 *
 * @param string       $title          Optional. Link title format. Default &#039;%title&#039;.
 * @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 empty.
 * @param string       $taxonomy       Optional. Taxonomy, if `$in_same_term` is true. Default &#039;category&#039;.
 */
function next_post_rel_link( $title = &#039;%title&#039;, $in_same_term = false, $excluded_terms = &#039;&#039;, $taxonomy = &#039;category&#039; ) {
	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 &#039;%title&#039;.
 * @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 &#039;category&#039;.
 */
function prev_post_rel_link( $title = &#039;%title&#039;, $in_same_term = false, $excluded_terms = &#039;&#039;, $taxonomy = &#039;category&#039; ) {
	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 &#039;category&#039;.
 * @return array|null Array containing the boundary post object if successful, null otherwise.
 */
function get_boundary_post( $in_same_term = false, $excluded_terms = &#039;&#039;, $start = true, $taxonomy = &#039;category&#039; ) {
	$post = get_post();

	if ( ! $post || ! is_single() || is_attachment() || ! taxonomy_exists( $taxonomy ) ) {
		return null;
	}

	$query_args = array(
		&#039;posts_per_page&#039;         =&gt; 1,
		&#039;order&#039;                  =&gt; $start ? &#039;ASC&#039; : &#039;DESC&#039;,
		&#039;update_post_term_cache&#039; =&gt; false,
		&#039;update_post_meta_cache&#039; =&gt; false,
	);

	$term_array = array();

	if ( ! is_array( $excluded_terms ) ) {
		if ( ! empty( $excluded_terms ) ) {
			$excluded_terms = explode( &#039;,&#039;, $excluded_terms );
		} else {
			$excluded_terms = array();
		}
	}

	if ( $in_same_term || ! empty( $excluded_terms ) ) {
		if ( $in_same_term ) {
			$term_array = wp_get_object_terms( $post-&gt;ID, $taxonomy, array( &#039;fields&#039; =&gt; &#039;ids&#039; ) );
		}

		if ( ! empty( $excluded_terms ) ) {
			$excluded_terms = array_map( &#039;intval&#039;, $excluded_terms );
			$excluded_terms = array_diff( $excluded_terms, $term_array );

			$inverse_terms = array();
			foreach ( $excluded_terms as $excluded_term ) {
				$inverse_terms[] = $excluded_term * -1;
			}
			$excluded_terms = $inverse_terms;
		}

		$query_args[&#039;tax_query&#039;] = array(
			array(
				&#039;taxonomy&#039; =&gt; $taxonomy,
				&#039;terms&#039;    =&gt; array_merge( $term_array, $excluded_terms ),
			),
		);
	}

	return get_posts( $query_args );
}

/**
 * Retrieves the previous post link that is adjacent to the current post.
 *
 * @since 3.7.0
 *
 * @param string       $format         Optional. Link anchor format. Default &#039;&amp;laquo; %link&#039;.
 * @param string       $link           Optional. Link permalink format. Default &#039;%title&#039;.
 * @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 empty.
 * @param string       $taxonomy       Optional. Taxonomy, if `$in_same_term` is true. Default &#039;category&#039;.
 * @return string The link URL of the previous post in relation to the current post.
 */
function get_previous_post_link( $format = &#039;&amp;laquo; %link&#039;, $link = &#039;%title&#039;, $in_same_term = false, $excluded_terms = &#039;&#039;, $taxonomy = &#039;category&#039; ) {
	return get_adjacent_post_link( $format, $link, $in_same_term, $excluded_terms, true, $taxonomy );
}

/**
 * Displays the previous post link that is adjacent to the current post.
 *
 * @since 1.5.0
 *
 * @see get_previous_post_link()
 *
 * @param string       $format         Optional. Link anchor format. Default &#039;&amp;laquo; %link&#039;.
 * @param string       $link           Optional. Link permalink format. Default &#039;%title&#039;.
 * @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 empty.
 * @param string       $taxonomy       Optional. Taxonomy, if `$in_same_term` is true. Default &#039;category&#039;.
 */
function previous_post_link( $format = &#039;&amp;laquo; %link&#039;, $link = &#039;%title&#039;, $in_same_term = false, $excluded_terms = &#039;&#039;, $taxonomy = &#039;category&#039; ) {
	echo get_previous_post_link( $format, $link, $in_same_term, $excluded_terms, $taxonomy );
}

/**
 * Retrieves the next post link that is adjacent to the current post.
 *
 * @since 3.7.0
 *
 * @param string       $format         Optional. Link anchor format. Default &#039;&amp;laquo; %link&#039;.
 * @param string       $link           Optional. Link permalink format. Default &#039;%title&#039;.
 * @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 empty.
 * @param string       $taxonomy       Optional. Taxonomy, if `$in_same_term` is true. Default &#039;category&#039;.
 * @return string The link URL of the next post in relation to the current post.
 */
function get_next_post_link( $format = &#039;%link &amp;raquo;&#039;, $link = &#039;%title&#039;, $in_same_term = false, $excluded_terms = &#039;&#039;, $taxonomy = &#039;category&#039; ) {
	return get_adjacent_post_link( $format, $link, $in_same_term, $excluded_terms, false, $taxonomy );
}

/**
 * Displays the next post link that is adjacent to the current post.
 *
 * @since 1.5.0
 *
 * @see get_next_post_link()
 *
 * @param string       $format         Optional. Link anchor format. Default &#039;&amp;laquo; %link&#039;.
 * @param string       $link           Optional. Link permalink format. Default &#039;%title&#039;.
 * @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 empty.
 * @param string       $taxonomy       Optional. Taxonomy, if `$in_same_term` is true. Default &#039;category&#039;.
 */
function next_post_link( $format = &#039;%link &amp;raquo;&#039;, $link = &#039;%title&#039;, $in_same_term = false, $excluded_terms = &#039;&#039;, $taxonomy = &#039;category&#039; ) {
	echo get_next_post_link( $format, $link, $in_same_term, $excluded_terms, $taxonomy );
}

/**
 * Retrieves the adjacent post link.
 *
 * Can be either next post link or previous.
 *
 * @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 the same taxonomy term.
 *                                     Default false.
 * @param int[]|string $excluded_terms Optional. Array or comma-separated list of excluded terms IDs.
 *                                     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 &#039;category&#039;.
 * @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 = &#039;&#039;, $previous = true, $taxonomy = &#039;category&#039; ) {
	if ( $previous &amp;&amp; is_attachment() ) {
		$post = get_post( get_post()-&gt;post_parent );
	} else {
		$post = get_adjacent_post( $in_same_term, $excluded_terms, $previous, $taxonomy );
	}

	if ( ! $post ) {
		$output = &#039;&#039;;
	} else {
		$title = $post-&gt;post_title;

		if ( empty( $post-&gt;post_title ) ) {
			$title = $previous ? __( &#039;Previous Post&#039; ) : __( &#039;Next Post&#039; );
		}

		/** This filter is documented in wp-includes/post-template.php */
		$title = apply_filters( &#039;the_title&#039;, $title, $post-&gt;ID );

		$date = mysql2date( get_option( &#039;date_format&#039; ), $post-&gt;post_date );
		$rel  = $previous ? &#039;prev&#039; : &#039;next&#039;;

		$string = &#039;&lt;a href=&quot;&#039; . get_permalink( $post ) . &#039;&quot; rel=&quot;&#039; . $rel . &#039;&quot;&gt;&#039;;
		$inlink = str_replace( &#039;%title&#039;, $title, $link );
		$inlink = str_replace( &#039;%date&#039;, $date, $inlink );
		$inlink = $string . $inlink . &#039;&lt;/a&gt;&#039;;

		$output = str_replace( &#039;%link&#039;, $inlink, $format );
	}

	$adjacent = $previous ? &#039;previous&#039; : &#039;next&#039;;

	/**
	 * Filters the adjacent post link.
	 *
	 * The dynamic portion of the hook name, `$adjacent`, refers to the type
	 * of adjacency, &#039;next&#039; or &#039;previous&#039;.
	 *
	 * Possible hook names include:
	 *
	 *  - `next_post_link`
	 *  - `previous_post_link`
	 *
	 * @since 2.6.0
	 * @since 4.2.0 Added the `$adjacent` parameter.
	 *
	 * @param string         $output   The adjacent post link.
	 * @param string         $format   Link anchor format.
	 * @param string         $link     Link permalink format.
	 * @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.
	 */
	return apply_filters( &quot;{$adjacent}_post_link&quot;, $output, $format, $link, $post, $adjacent );
}

/**
 * Displays the adjacent post link.
 *
 * Can be either next post link or previous.
 *
 * @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 the same taxonomy term.
 *                                     Default false.
 * @param int[]|string $excluded_terms Optional. Array or comma-separated list of excluded category IDs.
 *                                     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 &#039;category&#039;.
 */
function adjacent_post_link( $format, $link, $in_same_term = false, $excluded_terms = &#039;&#039;, $previous = true, $taxonomy = &#039;category&#039; ) {
	echo get_adjacent_post_link( $format, $link, $in_same_term, $excluded_terms, $previous, $taxonomy );
}

/**
 * Retrieves the link for a page number.
 *
 * @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().
 *                      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;

	$pagenum = (int) $pagenum;

	$request = remove_query_arg( &#039;paged&#039; );

	$home_root = parse_url( home_url() );
	$home_root = ( isset( $home_root[&#039;path&#039;] ) ) ? $home_root[&#039;path&#039;] : &#039;&#039;;
	$home_root = preg_quote( $home_root, &#039;|&#039; );

	$request = preg_replace( &#039;|^&#039; . $home_root . &#039;|i&#039;, &#039;&#039;, $request );
	$request = preg_replace( &#039;|^/+|&#039;, &#039;&#039;, $request );

	if ( ! $wp_rewrite-&gt;using_permalinks() || is_admin() ) {
		$base = trailingslashit( get_bloginfo( &#039;url&#039; ) );

		if ( $pagenum &gt; 1 ) {
			$result = add_query_arg( &#039;paged&#039;, $pagenum, $base . $request );
		} else {
			$result = $base . $request;
		}
	} else {
		$qs_regex = &#039;|\?.*?$|&#039;;
		preg_match( $qs_regex, $request, $qs_match );

		$parts   = array();
		$parts[] = untrailingslashit( get_bloginfo( &#039;url&#039; ) );

		if ( ! empty( $qs_match[0] ) ) {
			$query_string = $qs_match[0];
			$request      = preg_replace( $qs_regex, &#039;&#039;, $request );
		} else {
			$query_string = &#039;&#039;;
		}

		$request = preg_replace( &quot;|$wp_rewrite-&gt;pagination_base/\d+/?$|&quot;, &#039;&#039;, $request );
		$request = preg_replace( &#039;|^&#039; . preg_quote( $wp_rewrite-&gt;index, &#039;|&#039; ) . &#039;|i&#039;, &#039;&#039;, $request );
		$request = ltrim( $request, &#039;/&#039; );

		if ( $wp_rewrite-&gt;using_index_permalinks() &amp;&amp; ( $pagenum &gt; 1 || &#039;&#039; !== $request ) ) {
			$parts[] = $wp_rewrite-&gt;index;
		}

		$parts[] = untrailingslashit( $request );

		if ( $pagenum &gt; 1 ) {
			$parts[] = $wp_rewrite-&gt;pagination_base;
			$parts[] = $pagenum;
		}

		$result = user_trailingslashit( implode( &#039;/&#039;, array_filter( $parts ) ), &#039;paged&#039; );
		if ( ! empty( $query_string ) ) {
			$result .= $query_string;
		}
	}

	/**
	 * Filters the page number link for the current request.
	 *
	 * @since 2.5.0
	 * @since 5.2.0 Added the `$pagenum` argument.
	 *
	 * @param string $result  The page number link.
	 * @param int    $pagenum The page number.
	 */
	$result = apply_filters( &#039;get_pagenum_link&#039;, $result, $pagenum );

	if ( $escape ) {
		return esc_url( $result );
	} else {
		return sanitize_url( $result );
	}
}

/**
 * Retrieves the next posts page link.
 *
 * Backported from 2.1.3 to 2.0.10.
 *
 * @since 2.0.10
 *
 * @global int $paged
 *
 * @param int $max_page Optional. Max pages. Default 0.
 * @return string|void The link URL for next posts page.
 */
function get_next_posts_page_link( $max_page = 0 ) {
	global $paged;

	if ( ! is_single() ) {
		if ( ! $paged ) {
			$paged = 1;
		}

		$next_page = (int) $paged + 1;

		if ( ! $max_page || $max_page &gt;= $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 $display  Optional. Whether to echo the link. Default true.
 * @return string|void The link URL for next posts page if `$display = false`.
 */
function next_posts( $max_page = 0, $display = true ) {
	$link   = get_next_posts_page_link( $max_page );
	$output = $link ? esc_url( $link ) : &#039;&#039;;

	if ( $display ) {
		echo $output;
	} else {
		return $output;
	}
}

/**
 * Retrieves the next posts page link.
 *
 * @since 2.7.0
 *
 * @global int      $paged
 * @global WP_Query $wp_query WordPress Query object.
 *
 * @param string $label    Content for link text.
 * @param int    $max_page Optional. Max pages. Default 0.
 * @return string|void HTML-formatted next posts page link.
 */
function get_next_posts_link( $label = null, $max_page = 0 ) {
	global $paged, $wp_query;

	if ( ! $max_page ) {
		$max_page = $wp_query-&gt;max_num_pages;
	}

	if ( ! $paged ) {
		$paged = 1;
	}

	$next_page = (int) $paged + 1;

	if ( null === $label ) {
		$label = __( &#039;Next Page &amp;raquo;&#039; );
	}

	if ( ! is_single() &amp;&amp; ( $next_page &lt;= $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( &#039;next_posts_link_attributes&#039;, &#039;&#039; );

		return sprintf(
			&#039;&lt;a href=&quot;%1$s&quot; %2$s&gt;%3$s&lt;/a&gt;&#039;,
			next_posts( $max_page, false ),
			$attr,
			preg_replace( &#039;/&amp;([^#])(?![a-z]{1,8};)/i&#039;, &#039;&amp;#038;$1&#039;, $label )
		);
	}
}

/**
 * Displays the next posts page link.
 *
 * @since 0.71
 *
 * @param string $label    Content for link text.
 * @param int    $max_page Optional. Max pages. Default 0.
 */
function next_posts_link( $label = null, $max_page = 0 ) {
	echo get_next_posts_link( $label, $max_page );
}

/**
 * Retrieves the previous posts page link.
 *
 * Will only return string, if not on a single page or post.
 *
 * Backported to 2.0.10 from 2.1.3.
 *
 * @since 2.0.10
 *
 * @global int $paged
 *
 * @return string|void The link for the previous posts page.
 */
function get_previous_posts_page_link() {
	global $paged;

	if ( ! is_single() ) {
		$previous_page = (int) $paged - 1;

		if ( $previous_page &lt; 1 ) {
			$previous_page = 1;
		}

		return get_pagenum_link( $previous_page );
	}
}

/**
 * Displays or retrieves the previous posts page link.
 *
 * @since 0.71
 *
 * @param bool $display Optional. Whether to echo the link. Default true.
 * @return string|void The previous posts page link if `$display = false`.
 */
function previous_posts( $display = true ) {
	$output = esc_url( get_previous_posts_page_link() );

	if ( $display ) {
		echo $output;
	} else {
		return $output;
	}
}

/**
 * Retrieves the previous posts page link.
 *
 * @since 2.7.0
 *
 * @global int $paged
 *
 * @param string $label Optional. Previous page link text.
 * @return string|void HTML-formatted previous page link.
 */
function get_previous_posts_link( $label = null ) {
	global $paged;

	if ( null === $label ) {
		$label = __( &#039;&amp;laquo; Previous Page&#039; );
	}

	if ( ! is_single() &amp;&amp; $paged &gt; 1 ) {
		/**
		 * Filters the anchor tag attributes for the previous posts page link.
		 *
		 * @since 2.7.0
		 *
		 * @param string $attributes Attributes for the anchor tag.
		 */
		$attr = apply_filters( &#039;previous_posts_link_attributes&#039;, &#039;&#039; );

		return sprintf(
			&#039;&lt;a href=&quot;%1$s&quot; %2$s&gt;%3$s&lt;/a&gt;&#039;,
			previous_posts( false ),
			$attr,
			preg_replace( &#039;/&amp;([^#])(?![a-z]{1,8};)/i&#039;, &#039;&amp;#038;$1&#039;, $label )
		);
	}
}

/**
 * Displays the previous posts page link.
 *
 * @since 0.71
 *
 * @param string $label Optional. Previous page link text.
 */
function previous_posts_link( $label = null ) {
	echo get_previous_posts_link( $label );
}

/**
 * Retrieves the post pages link navigation for previous and next pages.
 *
 * @since 2.8.0
 *
 * @global WP_Query $wp_query WordPress Query object.
 *
 * @param string|array $args {
 *     Optional. Arguments to build the post pages link navigation.
 *
 *     @type string $sep      Separator character. Default &#039;&amp;#8212;&#039;.
 *     @type string $prelabel Link text to display for the previous page link.
 *                            Default &#039;&amp;laquo; Previous Page&#039;.
 *     @type string $nxtlabel Link text to display for the next page link.
 *                            Default &#039;Next Page &amp;raquo;&#039;.
 * }
 * @return string The posts link navigation.
 */
function get_posts_nav_link( $args = array() ) {
	global $wp_query;

	$return = &#039;&#039;;

	if ( ! is_singular() ) {
		$defaults = array(
			&#039;sep&#039;      =&gt; &#039; &amp;#8212; &#039;,
			&#039;prelabel&#039; =&gt; __( &#039;&amp;laquo; Previous Page&#039; ),
			&#039;nxtlabel&#039; =&gt; __( &#039;Next Page &amp;raquo;&#039; ),
		);
		$args     = wp_parse_args( $args, $defaults );

		$max_num_pages = $wp_query-&gt;max_num_pages;
		$paged         = get_query_var( &#039;paged&#039; );

		// Only have sep if there&#039;s both prev and next results.
		if ( $paged &lt; 2 || $paged &gt;= $max_num_pages ) {
			$args[&#039;sep&#039;] = &#039;&#039;;
		}

		if ( $max_num_pages &gt; 1 ) {
			$return  = get_previous_posts_link( $args[&#039;prelabel&#039;] );
			$return .= preg_replace( &#039;/&amp;([^#])(?![a-z]{1,8};)/i&#039;, &#039;&amp;#038;$1&#039;, $args[&#039;sep&#039;] );
			$return .= get_next_posts_link( $args[&#039;nxtlabel&#039;] );
		}
	}
	return $return;
}

/**
 * Displays the post pages link navigation for previous and next pages.
 *
 * @since 0.71
 *
 * @param string $sep      Optional. Separator for posts navigation links. Default empty.
 * @param string $prelabel Optional. Label for previous pages. Default empty.
 * @param string $nxtlabel Optional Label for next pages. Default empty.
 */
function posts_nav_link( $sep = &#039;&#039;, $prelabel = &#039;&#039;, $nxtlabel = &#039;&#039; ) {
	$args = array_filter( compact( &#039;sep&#039;, &#039;prelabel&#039;, &#039;nxtlabel&#039; ) );
	echo get_posts_nav_link( $args );
}

/**
 * Retrieves the navigation to next/previous post, when applicable.
 *
 * @since 4.1.0
 * @since 4.4.0 Introduced the `in_same_term`, `excluded_terms`, and `taxonomy` arguments.
 * @since 5.3.0 Added the `aria_label` parameter.
 * @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 &#039;%title&#039;.
 *     @type string       $next_text          Anchor text to display in the next post link.
 *                                            Default &#039;%title&#039;.
 *     @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 &#039;category&#039;.
 *     @type string       $screen_reader_text Screen reader text for the nav element.
 *                                            Default &#039;Post navigation&#039;.
 *     @type string       $aria_label         ARIA label text for the nav element. Default &#039;Posts&#039;.
 *     @type string       $class              Custom class for the nav element. Default &#039;post-navigation&#039;.
 * }
 * @return string Markup for post links.
 */
function get_the_post_navigation( $args = array() ) {
	// Make sure the nav element has an aria-label attribute: fallback to the screen reader text.
	if ( ! empty( $args[&#039;screen_reader_text&#039;] ) &amp;&amp; empty( $args[&#039;aria_label&#039;] ) ) {
		$args[&#039;aria_label&#039;] = $args[&#039;screen_reader_text&#039;];
	}

	$args = wp_parse_args(
		$args,
		array(
			&#039;prev_text&#039;          =&gt; &#039;%title&#039;,
			&#039;next_text&#039;          =&gt; &#039;%title&#039;,
			&#039;in_same_term&#039;       =&gt; false,
			&#039;excluded_terms&#039;     =&gt; &#039;&#039;,
			&#039;taxonomy&#039;           =&gt; &#039;category&#039;,
			&#039;screen_reader_text&#039; =&gt; __( &#039;Post navigation&#039; ),
			&#039;aria_label&#039;         =&gt; __( &#039;Posts&#039; ),
			&#039;class&#039;              =&gt; &#039;post-navigation&#039;,
		)
	);

	$navigation = &#039;&#039;;

	$previous = get_previous_post_link(
		&#039;&lt;div class=&quot;nav-previous&quot;&gt;%link&lt;/div&gt;&#039;,
		$args[&#039;prev_text&#039;],
		$args[&#039;in_same_term&#039;],
		$args[&#039;excluded_terms&#039;],
		$args[&#039;taxonomy&#039;]
	);

	$next = get_next_post_link(
		&#039;&lt;div class=&quot;nav-next&quot;&gt;%link&lt;/div&gt;&#039;,
		$args[&#039;next_text&#039;],
		$args[&#039;in_same_term&#039;],
		$args[&#039;excluded_terms&#039;],
		$args[&#039;taxonomy&#039;]
	);

	// Only add markup if there&#039;s somewhere to navigate to.
	if ( $previous || $next ) {
		$navigation = _navigation_markup( $previous . $next, $args[&#039;class&#039;], $args[&#039;screen_reader_text&#039;], $args[&#039;aria_label&#039;] );
	}

	return $navigation;
}

/**
 * Displays the navigation to next/previous post, when applicable.
 *
 * @since 4.1.0
 *
 * @param array $args Optional. See get_the_post_navigation() for available arguments.
 *                    Default empty array.
 */
function the_post_navigation( $args = array() ) {
	echo get_the_post_navigation( $args );
}

/**
 * Returns the navigation to next/previous set of posts, when applicable.
 *
 * @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 posts navigation arguments. Default empty array.
 *
 *     @type string $prev_text          Anchor text to display in the previous posts link.
 *                                      Default &#039;Older posts&#039;.
 *     @type string $next_text          Anchor text to display in the next posts link.
 *                                      Default &#039;Newer posts&#039;.
 *     @type string $screen_reader_text Screen reader text for the nav element.
 *                                      Default &#039;Posts navigation&#039;.
 *     @type string $aria_label         ARIA label text for the nav element. Default &#039;Posts&#039;.
 *     @type string $class              Custom class for the nav element. Default &#039;posts-navigation&#039;.
 * }
 * @return string Markup for posts links.
 */
function get_the_posts_navigation( $args = array() ) {
	global $wp_query;

	$navigation = &#039;&#039;;

	// Don&#039;t print empty markup if there&#039;s only one page.
	if ( $wp_query-&gt;max_num_pages &gt; 1 ) {
		// Make sure the nav element has an aria-label attribute: fallback to the screen reader text.
		if ( ! empty( $args[&#039;screen_reader_text&#039;] ) &amp;&amp; empty( $args[&#039;aria_label&#039;] ) ) {
			$args[&#039;aria_label&#039;] = $args[&#039;screen_reader_text&#039;];
		}

		$args = wp_parse_args(
			$args,
			array(
				&#039;prev_text&#039;          =&gt; __( &#039;Older posts&#039; ),
				&#039;next_text&#039;          =&gt; __( &#039;Newer posts&#039; ),
				&#039;screen_reader_text&#039; =&gt; __( &#039;Posts navigation&#039; ),
				&#039;aria_label&#039;         =&gt; __( &#039;Posts&#039; ),
				&#039;class&#039;              =&gt; &#039;posts-navigation&#039;,
			)
		);

		$next_link = get_previous_posts_link( $args[&#039;next_text&#039;] );
		$prev_link = get_next_posts_link( $args[&#039;prev_text&#039;] );

		if ( $prev_link ) {
			$navigation .= &#039;&lt;div class=&quot;nav-previous&quot;&gt;&#039; . $prev_link . &#039;&lt;/div&gt;&#039;;
		}

		if ( $next_link ) {
			$navigation .= &#039;&lt;div class=&quot;nav-next&quot;&gt;&#039; . $next_link . &#039;&lt;/div&gt;&#039;;
		}

		$navigation = _navigation_markup( $navigation, $args[&#039;class&#039;], $args[&#039;screen_reader_text&#039;], $args[&#039;aria_label&#039;] );
	}

	return $navigation;
}

/**
 * Displays the navigation to next/previous set of posts, when applicable.
 *
 * @since 4.1.0
 *
 * @param array $args Optional. See get_the_posts_navigation() for available arguments.
 *                    Default empty array.
 */
function the_posts_navigation( $args = array() ) {
	echo get_the_posts_navigation( $args );
}

/**
 * Retrieves a paginated navigation to next/previous set of posts, when applicable.
 *
 * @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 &#039;Posts pagination&#039;.
 *     @type string $aria_label         ARIA label text for the nav element. Default &#039;Posts pagination&#039;.
 *     @type string $class              Custom class for the nav element. Default &#039;pagination&#039;.
 * }
 * @return string Markup for pagination links.
 */
function get_the_posts_pagination( $args = array() ) {
	global $wp_query;

	$navigation = &#039;&#039;;

	// Don&#039;t print empty markup if there&#039;s only one page.
	if ( $wp_query-&gt;max_num_pages &gt; 1 ) {
		// Make sure the nav element has an aria-label attribute: fallback to the screen reader text.
		if ( ! empty( $args[&#039;screen_reader_text&#039;] ) &amp;&amp; empty( $args[&#039;aria_label&#039;] ) ) {
			$args[&#039;aria_label&#039;] = $args[&#039;screen_reader_text&#039;];
		}

		$args = wp_parse_args(
			$args,
			array(
				&#039;mid_size&#039;           =&gt; 1,
				&#039;prev_text&#039;          =&gt; _x( &#039;Previous&#039;, &#039;previous set of posts&#039; ),
				&#039;next_text&#039;          =&gt; _x( &#039;Next&#039;, &#039;next set of posts&#039; ),
				&#039;screen_reader_text&#039; =&gt; __( &#039;Posts pagination&#039; ),
				&#039;aria_label&#039;         =&gt; __( &#039;Posts pagination&#039; ),
				&#039;class&#039;              =&gt; &#039;pagination&#039;,
			)
		);

		/**
		 * 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 &#039;Posts navigation&#039;.
		 *     @type string $aria_label         ARIA label text for the nav element. Default &#039;Posts&#039;.
		 *     @type string $class              Custom class for the nav element. Default &#039;pagination&#039;.
		 * }
		 */
		$args = apply_filters( &#039;the_posts_pagination_args&#039;, $args );

		// Make sure we get a string back. Plain is the next best thing.
		if ( isset( $args[&#039;type&#039;] ) &amp;&amp; &#039;array&#039; === $args[&#039;type&#039;] ) {
			$args[&#039;type&#039;] = &#039;plain&#039;;
		}

		// Set up paginated links.
		$links = paginate_links( $args );

		if ( $links ) {
			$navigation = _navigation_markup( $links, $args[&#039;class&#039;], $args[&#039;screen_reader_text&#039;], $args[&#039;aria_label&#039;] );
		}
	}

	return $navigation;
}

/**
 * Displays a paginated navigation to next/previous set of posts, when applicable.
 *
 * @since 4.1.0
 *
 * @param array $args Optional. See get_the_posts_pagination() for available arguments.
 *                    Default empty array.
 */
function the_posts_pagination( $args = array() ) {
	echo get_the_posts_pagination( $args );
}

/**
 * Wraps passed links in navigational markup.
 *
 * @since 4.1.0
 * @since 5.3.0 Added the `aria_label` parameter.
 * @access private
 *
 * @param string $links              Navigational links.
 * @param string $css_class          Optional. Custom class for the nav element.
 *                                   Default &#039;posts-navigation&#039;.
 * @param string $screen_reader_text Optional. Screen reader text for the nav element.
 *                                   Default &#039;Posts navigation&#039;.
 * @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, $css_class = &#039;posts-navigation&#039;, $screen_reader_text = &#039;&#039;, $aria_label = &#039;&#039; ) {
	if ( empty( $screen_reader_text ) ) {
		$screen_reader_text = /* translators: Hidden accessibility text. */ __( &#039;Posts navigation&#039; );
	}
	if ( empty( $aria_label ) ) {
		$aria_label = $screen_reader_text;
	}

	$template = &#039;
	&lt;nav class=&quot;navigation %1$s&quot; aria-label=&quot;%4$s&quot;&gt;
		&lt;h2 class=&quot;screen-reader-text&quot;&gt;%2$s&lt;/h2&gt;
		&lt;div class=&quot;nav-links&quot;&gt;%3$s&lt;/div&gt;
	&lt;/nav&gt;&#039;;

	/**
	 * Filters the navigation markup template.
	 *
	 * Note: The filtered template HTML must contain specifiers for the navigation
	 * class (%1$s), the screen-reader-text value (%2$s), placement of the navigation
	 * links (%3$s), and ARIA label text if screen-reader-text does not fit that (%4$s):
	 *
	 *     &lt;nav class=&quot;navigation %1$s&quot; aria-label=&quot;%4$s&quot;&gt;
	 *         &lt;h2 class=&quot;screen-reader-text&quot;&gt;%2$s&lt;/h2&gt;
	 *         &lt;div class=&quot;nav-links&quot;&gt;%3$s&lt;/div&gt;
	 *     &lt;/nav&gt;
	 *
	 * @since 4.4.0
	 *
	 * @param string $template  The default template.
	 * @param string $css_class The class passed by the calling function.
	 */
	$template = apply_filters( &#039;navigation_markup_template&#039;, $template, $css_class );

	return sprintf( $template, sanitize_html_class( $css_class ), esc_html( $screen_reader_text ), $links, esc_attr( $aria_label ) );
}

/**
 * Retrieves the comments page number link.
 *
 * @since 2.7.0
 *
 * @global WP_Rewrite $wp_rewrite WordPress rewrite component.
 *
 * @param int $pagenum  Optional. Page number. Default 1.
 * @param int $max_page Optional. The maximum number of comment pages. Default 0.
 * @return string The comments page number link URL.
 */
function get_comments_pagenum_link( $pagenum = 1, $max_page = 0 ) {
	global $wp_rewrite;

	$pagenum  = (int) $pagenum;
	$max_page = (int) $max_page;

	$result = get_permalink();

	if ( &#039;newest&#039; === get_option( &#039;default_comments_page&#039; ) ) {
		if ( $pagenum !== $max_page ) {
			if ( $wp_rewrite-&gt;using_permalinks() ) {
				$result = user_trailingslashit( trailingslashit( $result ) . $wp_rewrite-&gt;comments_pagination_base . &#039;-&#039; . $pagenum, &#039;commentpaged&#039; );
			} else {
				$result = add_query_arg( &#039;cpage&#039;, $pagenum, $result );
			}
		}
	} elseif ( $pagenum &gt; 1 ) {
		if ( $wp_rewrite-&gt;using_permalinks() ) {
			$result = user_trailingslashit( trailingslashit( $result ) . $wp_rewrite-&gt;comments_pagination_base . &#039;-&#039; . $pagenum, &#039;commentpaged&#039; );
		} else {
			$result = add_query_arg( &#039;cpage&#039;, $pagenum, $result );
		}
	}

	$result .= &#039;#comments&#039;;

	/**
	 * Filters the comments page number link for the current request.
	 *
	 * @since 2.7.0
	 *
	 * @param string $result The comments page number link.
	 */
	return apply_filters( &#039;get_comments_pagenum_link&#039;, $result );
}

/**
 * Retrieves the link to the next comments page.
 *
 * @since 2.7.1
 * @since 6.7.0 Added the `page` parameter.
 *
 * @global WP_Query $wp_query WordPress Query object.
 *
 * @param string   $label    Optional. Label for link text. Default empty.
 * @param int      $max_page Optional. Max page. Default 0.
 * @param int|null $page     Optional. Page number. Default null.
 * @return string|void HTML-formatted link for the next page of comments.
 */
function get_next_comments_link( $label = &#039;&#039;, $max_page = 0, $page = null ) {
	global $wp_query;

	if ( ! is_singular() ) {
		return;
	}

	if ( is_null( $page ) ) {
		$page = get_query_var( &#039;cpage&#039; );
	}

	if ( ! $page ) {
		$page = 1;
	}

	$next_page = (int) $page + 1;

	if ( empty( $max_page ) ) {
		$max_page = $wp_query-&gt;max_num_comment_pages;
	}

	if ( empty( $max_page ) ) {
		$max_page = get_comment_pages_count();
	}

	if ( $next_page &gt; $max_page ) {
		return;
	}

	if ( empty( $label ) ) {
		$label = __( &#039;Newer Comments &amp;raquo;&#039; );
	}

	/**
	 * Filters the anchor tag attributes for the next comments page link.
	 *
	 * @since 2.7.0
	 *
	 * @param string $attributes Attributes for the anchor tag.
	 */
	$attr = apply_filters( &#039;next_comments_link_attributes&#039;, &#039;&#039; );

	return sprintf(
		&#039;&lt;a href=&quot;%1$s&quot; %2$s&gt;%3$s&lt;/a&gt;&#039;,
		esc_url( get_comments_pagenum_link( $next_page, $max_page ) ),
		$attr,
		preg_replace( &#039;/&amp;([^#])(?![a-z]{1,8};)/i&#039;, &#039;&amp;#038;$1&#039;, $label )
	);
}

/**
 * Displays the link to the next comments page.
 *
 * @since 2.7.0
 *
 * @param string $label    Optional. Label for link text. Default empty.
 * @param int    $max_page Optional. Max page. Default 0.
 */
function next_comments_link( $label = &#039;&#039;, $max_page = 0 ) {
	echo get_next_comments_link( $label, $max_page );
}

/**
 * Retrieves the link to the previous comments page.
 *
 * @since 2.7.1
 * @since 6.7.0 Added the `page` parameter.
 *
 * @param string   $label Optional. Label for comments link text. Default empty.
 * @param int|null $page  Optional. Page number. Default null.
 * @return string|void HTML-formatted link for the previous page of comments.
 */
function get_previous_comments_link( $label = &#039;&#039;, $page = null ) {
	if ( ! is_singular() ) {
		return;
	}

	if ( is_null( $page ) ) {
		$page = get_query_var( &#039;cpage&#039; );
	}

	if ( (int) $page &lt;= 1 ) {
		return;
	}

	$previous_page = (int) $page - 1;

	if ( empty( $label ) ) {
		$label = __( &#039;&amp;laquo; Older Comments&#039; );
	}

	/**
	 * Filters the anchor tag attributes for the previous comments page link.
	 *
	 * @since 2.7.0
	 *
	 * @param string $attributes Attributes for the anchor tag.
	 */
	$attr = apply_filters( &#039;previous_comments_link_attributes&#039;, &#039;&#039; );

	return sprintf(
		&#039;&lt;a href=&quot;%1$s&quot; %2$s&gt;%3$s&lt;/a&gt;&#039;,
		esc_url( get_comments_pagenum_link( $previous_page ) ),
		$attr,
		preg_replace( &#039;/&amp;([^#])(?![a-z]{1,8};)/i&#039;, &#039;&amp;#038;$1&#039;, $label )
	);
}

/**
 * Displays the link to the previous comments page.
 *
 * @since 2.7.0
 *
 * @param string $label Optional. Label for comments link text. Default empty.
 */
function previous_comments_link( $label = &#039;&#039; ) {
	echo get_previous_comments_link( $label );
}

/**
 * Displays or retrieves pagination links for the comments on the current post.
 *
 * @see paginate_links()
 * @since 2.7.0
 *
 * @global WP_Rewrite $wp_rewrite WordPress rewrite component.
 *
 * @param string|array $args Optional args. See paginate_links(). Default empty array.
 * @return void|string|array Void if &#039;echo&#039; argument is true and &#039;type&#039; is not an array,
 *                           or if the query is not for an existing single post of any post type.
 *                           Otherwise, markup for comment page links or array of comment page links,
 *                           depending on &#039;type&#039; argument.
 */
function paginate_comments_links( $args = array() ) {
	global $wp_rewrite;

	if ( ! is_singular() ) {
		return;
	}

	$page = get_query_var( &#039;cpage&#039; );
	if ( ! $page ) {
		$page = 1;
	}
	$max_page = get_comment_pages_count();
	$defaults = array(
		&#039;base&#039;         =&gt; add_query_arg( &#039;cpage&#039;, &#039;%#%&#039; ),
		&#039;format&#039;       =&gt; &#039;&#039;,
		&#039;total&#039;        =&gt; $max_page,
		&#039;current&#039;      =&gt; $page,
		&#039;echo&#039;         =&gt; true,
		&#039;type&#039;         =&gt; &#039;plain&#039;,
		&#039;add_fragment&#039; =&gt; &#039;#comments&#039;,
	);
	if ( $wp_rewrite-&gt;using_permalinks() ) {
		$defaults[&#039;base&#039;] = user_trailingslashit( trailingslashit( get_permalink() ) . $wp_rewrite-&gt;comments_pagination_base . &#039;-%#%&#039;, &#039;commentpaged&#039; );
	}

	$args       = wp_parse_args( $args, $defaults );
	$page_links = paginate_links( $args );

	if ( $args[&#039;echo&#039;] &amp;&amp; &#039;array&#039; !== $args[&#039;type&#039;] ) {
		echo $page_links;
	} else {
		return $page_links;
	}
}

/**
 * Retrieves navigation to next/previous set of comments, when applicable.
 *
 * @since 4.4.0
 * @since 5.3.0 Added the `aria_label` parameter.
 * @since 5.5.0 Added the `class` parameter.
 *
 * @param array $args {
 *     Optional. Default comments navigation arguments.
 *
 *     @type string $prev_text          Anchor text to display in the previous comments link.
 *                                      Default &#039;Older comments&#039;.
 *     @type string $next_text          Anchor text to display in the next comments link.
 *                                      Default &#039;Newer comments&#039;.
 *     @type string $screen_reader_text Screen reader text for the nav element. Default &#039;Comments navigation&#039;.
 *     @type string $aria_label         ARIA label text for the nav element. Default &#039;Comments&#039;.
 *     @type string $class              Custom class for the nav element. Default &#039;comment-navigation&#039;.
 * }
 * @return string Markup for comments links.
 */
function get_the_comments_navigation( $args = array() ) {
	$navigation = &#039;&#039;;

	// Are there comments to navigate through?
	if ( get_comment_pages_count() &gt; 1 ) {
		// Make sure the nav element has an aria-label attribute: fallback to the screen reader text.
		if ( ! empty( $args[&#039;screen_reader_text&#039;] ) &amp;&amp; empty( $args[&#039;aria_label&#039;] ) ) {
			$args[&#039;aria_label&#039;] = $args[&#039;screen_reader_text&#039;];
		}

		$args = wp_parse_args(
			$args,
			array(
				&#039;prev_text&#039;          =&gt; __( &#039;Older comments&#039; ),
				&#039;next_text&#039;          =&gt; __( &#039;Newer comments&#039; ),
				&#039;screen_reader_text&#039; =&gt; __( &#039;Comments navigation&#039; ),
				&#039;aria_label&#039;         =&gt; __( &#039;Comments&#039; ),
				&#039;class&#039;              =&gt; &#039;comment-navigation&#039;,
			)
		);

		$prev_link = get_previous_comments_link( $args[&#039;prev_text&#039;] );
		$next_link = get_next_comments_link( $args[&#039;next_text&#039;] );

		if ( $prev_link ) {
			$navigation .= &#039;&lt;div class=&quot;nav-previous&quot;&gt;&#039; . $prev_link . &#039;&lt;/div&gt;&#039;;
		}

		if ( $next_link ) {
			$navigation .= &#039;&lt;div class=&quot;nav-next&quot;&gt;&#039; . $next_link . &#039;&lt;/div&gt;&#039;;
		}

		$navigation = _navigation_markup( $navigation, $args[&#039;class&#039;], $args[&#039;screen_reader_text&#039;], $args[&#039;aria_label&#039;] );
	}

	return $navigation;
}

/**
 * Displays navigation to next/previous set of comments, when applicable.
 *
 * @since 4.4.0
 *
 * @param array $args See get_the_comments_navigation() for available arguments. Default empty array.
 */
function the_comments_navigation( $args = array() ) {
	echo get_the_comments_navigation( $args );
}

/**
 * Retrieves a paginated navigation to next/previous set of comments, when applicable.
 *
 * @since 4.4.0
 * @since 5.3.0 Added the `aria_label` parameter.
 * @since 5.5.0 Added the `class` parameter.
 *
 * @see paginate_comments_links()
 *
 * @param array $args {
 *     Optional. Default pagination arguments.
 *
 *     @type string $screen_reader_text Screen reader text for the nav element. Default &#039;Comments pagination&#039;.
 *     @type string $aria_label         ARIA label text for the nav element. Default &#039;Comments pagination&#039;.
 *     @type string $class              Custom class for the nav element. Default &#039;comments-pagination&#039;.
 * }
 * @return string Markup for pagination links.
 */
function get_the_comments_pagination( $args = array() ) {
	$navigation = &#039;&#039;;

	// Make sure the nav element has an aria-label attribute: fallback to the screen reader text.
	if ( ! empty( $args[&#039;screen_reader_text&#039;] ) &amp;&amp; empty( $args[&#039;aria_label&#039;] ) ) {
		$args[&#039;aria_label&#039;] = $args[&#039;screen_reader_text&#039;];
	}

	$args         = wp_parse_args(
		$args,
		array(
			&#039;screen_reader_text&#039; =&gt; __( &#039;Comments pagination&#039; ),
			&#039;aria_label&#039;         =&gt; __( &#039;Comments pagination&#039; ),
			&#039;class&#039;              =&gt; &#039;comments-pagination&#039;,
		)
	);
	$args[&#039;echo&#039;] = false;

	// Make sure we get a string back. Plain is the next best thing.
	if ( isset( $args[&#039;type&#039;] ) &amp;&amp; &#039;array&#039; === $args[&#039;type&#039;] ) {
		$args[&#039;type&#039;] = &#039;plain&#039;;
	}

	$links = paginate_comments_links( $args );

	if ( $links ) {
		$navigation = _navigation_markup( $links, $args[&#039;class&#039;], $args[&#039;screen_reader_text&#039;], $args[&#039;aria_label&#039;] );
	}

	return $navigation;
}

/**
 * Displays a paginated navigation to next/previous set of comments, when applicable.
 *
 * @since 4.4.0
 *
 * @param array $args See get_the_comments_pagination() for available arguments. Default empty array.
 */
function the_comments_pagination( $args = array() ) {
	echo get_the_comments_pagination( $args );
}

/**
 * Retrieves the URL for the current site where the front end is accessible.
 *
 * Returns the &#039;home&#039; option with the appropriate protocol. The protocol will be &#039;https&#039;
 * if is_ssl() evaluates to true; otherwise, it will be the same as the &#039;home&#039; option.
 * If `$scheme` is &#039;http&#039; or &#039;https&#039;, is_ssl() is overridden.
 *
 * @since 3.0.0
 *
 * @param string      $path   Optional. Path relative to the home URL. Default empty.
 * @param string|null $scheme Optional. Scheme to give the home URL context. Accepts
 *                            &#039;http&#039;, &#039;https&#039;, &#039;relative&#039;, &#039;rest&#039;, or null. Default null.
 * @return string Home URL link with optional path appended.
 */
function home_url( $path = &#039;&#039;, $scheme = null ) {
	return get_home_url( null, $path, $scheme );
}

/**
 * Retrieves the URL for a given site where the front end is accessible.
 *
 * Returns the &#039;home&#039; option with the appropriate protocol. The protocol will be &#039;https&#039;
 * if is_ssl() evaluates to true; otherwise, it will be the same as the &#039;home&#039; option.
 * If `$scheme` is &#039;http&#039; or &#039;https&#039;, is_ssl() is overridden.
 *
 * @since 3.0.0
 *
 * @param int|null    $blog_id Optional. Site ID. Default null (current site).
 * @param string      $path    Optional. Path relative to the home URL. Default empty.
 * @param string|null $scheme  Optional. Scheme to give the home URL context. Accepts
 *                             &#039;http&#039;, &#039;https&#039;, &#039;relative&#039;, &#039;rest&#039;, or null. Default null.
 * @return string Home URL link with optional path appended.
 */
function get_home_url( $blog_id = null, $path = &#039;&#039;, $scheme = null ) {
	$orig_scheme = $scheme;

	if ( empty( $blog_id ) || ! is_multisite() ) {
		$url = get_option( &#039;home&#039; );
	} else {
		switch_to_blog( $blog_id );
		$url = get_option( &#039;home&#039; );
		restore_current_blog();
	}

	if ( ! in_array( $scheme, array( &#039;http&#039;, &#039;https&#039;, &#039;relative&#039; ), true ) ) {
		if ( is_ssl() ) {
			$scheme = &#039;https&#039;;
		} else {
			$scheme = parse_url( $url, PHP_URL_SCHEME );
		}
	}

	$url = set_url_scheme( $url, $scheme );

	if ( $path &amp;&amp; is_string( $path ) ) {
		$url .= &#039;/&#039; . ltrim( $path, &#039;/&#039; );
	}

	/**
	 * Filters the home URL.
	 *
	 * @since 3.0.0
	 *
	 * @param string      $url         The complete home URL including scheme and path.
	 * @param string      $path        Path relative to the home URL. Blank string if no path is specified.
	 * @param string|null $orig_scheme Scheme to give the home URL context. Accepts &#039;http&#039;, &#039;https&#039;,
	 *                                 &#039;relative&#039;, &#039;rest&#039;, or null.
	 * @param int|null    $blog_id     Site ID, or null for the current site.
	 */
	return apply_filters( &#039;home_url&#039;, $url, $path, $orig_scheme, $blog_id );
}

/**
 * Retrieves the URL for the current site where WordPress application files
 * (e.g. wp-blog-header.php or the wp-admin/ folder) are accessible.
 *
 * Returns the &#039;site_url&#039; option with the appropriate protocol, &#039;https&#039; if
 * is_ssl() and &#039;http&#039; otherwise. If $scheme is &#039;http&#039; or &#039;https&#039;, is_ssl() is
 * overridden.
 *
 * @since 3.0.0
 *
 * @param string      $path   Optional. Path relative to the site URL. Default empty.
 * @param string|null $scheme Optional. Scheme to give the site URL context. See set_url_scheme().
 * @return string Site URL link with optional path appended.
 */
function site_url( $path = &#039;&#039;, $scheme = null ) {
	return get_site_url( null, $path, $scheme );
}

/**
 * Retrieves the URL for a given site where WordPress application files
 * (e.g. wp-blog-header.php or the wp-admin/ folder) are accessible.
 *
 * Returns the &#039;site_url&#039; option with the appropriate protocol, &#039;https&#039; if
 * is_ssl() and &#039;http&#039; otherwise. If `$scheme` is &#039;http&#039; or &#039;https&#039;,
 * `is_ssl()` is overridden.
 *
 * @since 3.0.0
 *
 * @param int|null    $blog_id Optional. Site ID. Default null (current site).
 * @param string      $path    Optional. Path relative to the site URL. Default empty.
 * @param string|null $scheme  Optional. Scheme to give the site URL context. Accepts
 *                             &#039;http&#039;, &#039;https&#039;, &#039;login&#039;, &#039;login_post&#039;, &#039;admin&#039;, or
 *                             &#039;relative&#039;. Default null.
 * @return string Site URL link with optional path appended.
 */
function get_site_url( $blog_id = null, $path = &#039;&#039;, $scheme = null ) {
	if ( empty( $blog_id ) || ! is_multisite() ) {
		$url = get_option( &#039;siteurl&#039; );
	} else {
		switch_to_blog( $blog_id );
		$url = get_option( &#039;siteurl&#039; );
		restore_current_blog();
	}

	$url = set_url_scheme( $url, $scheme );

	if ( $path &amp;&amp; is_string( $path ) ) {
		$url .= &#039;/&#039; . ltrim( $path, &#039;/&#039; );
	}

	/**
	 * Filters the site URL.
	 *
	 * @since 2.7.0
	 *
	 * @param string      $url     The complete site URL including scheme and path.
	 * @param string      $path    Path relative to the site URL. Blank string if no path is specified.
	 * @param string|null $scheme  Scheme to give the site URL context. Accepts &#039;http&#039;, &#039;https&#039;, &#039;login&#039;,
	 *                             &#039;login_post&#039;, &#039;admin&#039;, &#039;relative&#039; or null.
	 * @param int|null    $blog_id Site ID, or null for the current site.
	 */
	return apply_filters( &#039;site_url&#039;, $url, $path, $scheme, $blog_id );
}

/**
 * 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 empty.
 * @param string $scheme The scheme to use. Default is &#039;admin&#039;, which obeys force_ssl_admin() and is_ssl().
 *                       &#039;http&#039; or &#039;https&#039; can be passed to force those schemes.
 * @return string Admin URL link with optional path appended.
 */
function admin_url( $path = &#039;&#039;, $scheme = &#039;admin&#039; ) {
	return get_admin_url( null, $path, $scheme );
}

/**
 * Retrieves the URL to the admin area for a given site.
 *
 * @since 3.0.0
 *
 * @param int|null $blog_id Optional. Site ID. Default null (current site).
 * @param string   $path    Optional. Path relative to the admin URL. Default empty.
 * @param string   $scheme  Optional. The scheme to use. Accepts &#039;http&#039; or &#039;https&#039;,
 *                          to force those schemes. Default &#039;admin&#039;, which obeys
 *                          force_ssl_admin() and is_ssl().
 * @return string Admin URL link with optional path appended.
 */
function get_admin_url( $blog_id = null, $path = &#039;&#039;, $scheme = &#039;admin&#039; ) {
	$url = get_site_url( $blog_id, &#039;wp-admin/&#039;, $scheme );

	if ( $path &amp;&amp; is_string( $path ) ) {
		$url .= ltrim( $path, &#039;/&#039; );
	}

	/**
	 * Filters the admin area URL.
	 *
	 * @since 2.8.0
	 * @since 5.8.0 The `$scheme` parameter was added.
	 *
	 * @param string      $url     The complete admin area URL including scheme and path.
	 * @param string      $path    Path relative to the admin area URL. Blank string if no path is specified.
	 * @param int|null    $blog_id Site ID, or null for the current site.
	 * @param string|null $scheme  The scheme to use. Accepts &#039;http&#039;, &#039;https&#039;,
	 *                             &#039;admin&#039;, or null. Default &#039;admin&#039;, which obeys force_ssl_admin() and is_ssl().
	 */
	return apply_filters( &#039;admin_url&#039;, $url, $path, $blog_id, $scheme );
}

/**
 * Retrieves the URL to the includes directory.
 *
 * @since 2.6.0
 *
 * @param string      $path   Optional. Path relative to the includes URL. Default empty.
 * @param string|null $scheme Optional. Scheme to give the includes URL context. Accepts
 *                            &#039;http&#039;, &#039;https&#039;, or &#039;relative&#039;. Default null.
 * @return string Includes URL link with optional path appended.
 */
function includes_url( $path = &#039;&#039;, $scheme = null ) {
	$url = site_url( &#039;/&#039; . WPINC . &#039;/&#039;, $scheme );

	if ( $path &amp;&amp; is_string( $path ) ) {
		$url .= ltrim( $path, &#039;/&#039; );
	}

	/**
	 * Filters the URL to the includes directory.
	 *
	 * @since 2.8.0
	 * @since 5.8.0 The `$scheme` parameter was added.
	 *
	 * @param string      $url    The complete URL to the includes directory including scheme and path.
	 * @param string      $path   Path relative to the URL to the wp-includes directory. Blank string
	 *                            if no path is specified.
	 * @param string|null $scheme Scheme to give the includes URL context. Accepts
	 *                            &#039;http&#039;, &#039;https&#039;, &#039;relative&#039;, or null. Default null.
	 */
	return apply_filters( &#039;includes_url&#039;, $url, $path, $scheme );
}

/**
 * Retrieves the URL to the content directory.
 *
 * @since 2.6.0
 *
 * @param string $path Optional. Path relative to the content URL. Default empty.
 * @return string Content URL link with optional path appended.
 */
function content_url( $path = &#039;&#039; ) {
	$url = set_url_scheme( WP_CONTENT_URL );

	if ( $path &amp;&amp; is_string( $path ) ) {
		$url .= &#039;/&#039; . ltrim( $path, &#039;/&#039; );
	}

	/**
	 * Filters the URL to the content directory.
	 *
	 * @since 2.8.0
	 *
	 * @param string $url  The complete URL to the content directory including scheme and path.
	 * @param string $path Path relative to the URL to the content directory. Blank string
	 *                     if no path is specified.
	 */
	return apply_filters( &#039;content_url&#039;, $url, $path );
}

/**
 * Retrieves a URL within the plugins or mu-plugins directory.
 *
 * Defaults to the plugins directory URL if no arguments are supplied.
 *
 * @since 2.6.0
 *
 * @param string $path   Optional. Extra path appended to the end of the URL, including
 *                       the relative directory if $plugin is supplied. Default empty.
 * @param string $plugin Optional. A full path to a file inside a plugin or mu-plugin.
 *                       The URL will be relative to its directory. Default empty.
 *                       Typically this is done by passing `__FILE__` as the argument.
 * @return string Plugins URL link with optional paths appended.
 */
function plugins_url( $path = &#039;&#039;, $plugin = &#039;&#039; ) {

	$path          = wp_normalize_path( $path );
	$plugin        = wp_normalize_path( $plugin );
	$mu_plugin_dir = wp_normalize_path( WPMU_PLUGIN_DIR );

	if ( ! empty( $plugin ) &amp;&amp; str_starts_with( $plugin, $mu_plugin_dir ) ) {
		$url = WPMU_PLUGIN_URL;
	} else {
		$url = WP_PLUGIN_URL;
	}

	$url = set_url_scheme( $url );

	if ( ! empty( $plugin ) &amp;&amp; is_string( $plugin ) ) {
		$folder = dirname( plugin_basename( $plugin ) );
		if ( &#039;.&#039; !== $folder ) {
			$url .= &#039;/&#039; . ltrim( $folder, &#039;/&#039; );
		}
	}

	if ( $path &amp;&amp; is_string( $path ) ) {
		$url .= &#039;/&#039; . ltrim( $path, &#039;/&#039; );
	}

	/**
	 * Filters the URL to the plugins directory.
	 *
	 * @since 2.8.0
	 *
	 * @param string $url    The complete URL to the plugins directory including scheme and path.
	 * @param string $path   Path relative to the URL to the plugins directory. Blank string
	 *                       if no path is specified.
	 * @param string $plugin The plugin file path to be relative to. Blank string if no plugin
	 *                       is specified.
	 */
	return apply_filters( &#039;plugins_url&#039;, $url, $path, $plugin );
}

/**
 * Retrieves the site URL for the current network.
 *
 * Returns the site URL with the appropriate protocol, &#039;https&#039; if
 * is_ssl() and &#039;http&#039; otherwise. If $scheme is &#039;http&#039; or &#039;https&#039;, is_ssl() is
 * overridden.
 *
 * @since 3.0.0
 *
 * @see set_url_scheme()
 *
 * @param string      $path   Optional. Path relative to the site URL. Default empty.
 * @param string|null $scheme Optional. Scheme to give the site URL context. Accepts
 *                            &#039;http&#039;, &#039;https&#039;, or &#039;relative&#039;. Default null.
 * @return string Site URL link with optional path appended.
 */
function network_site_url( $path = &#039;&#039;, $scheme = null ) {
	if ( ! is_multisite() ) {
		return site_url( $path, $scheme );
	}

	$current_network = get_network();

	if ( &#039;relative&#039; === $scheme ) {
		$url = $current_network-&gt;path;
	} else {
		$url = set_url_scheme( &#039;http://&#039; . $current_network-&gt;domain . $current_network-&gt;path, $scheme );
	}

	if ( $path &amp;&amp; is_string( $path ) ) {
		$url .= ltrim( $path, &#039;/&#039; );
	}

	/**
	 * Filters the network site URL.
	 *
	 * @since 3.0.0
	 *
	 * @param string      $url    The complete network site URL including scheme and path.
	 * @param string      $path   Path relative to the network site URL. Blank string if
	 *                            no path is specified.
	 * @param string|null $scheme Scheme to give the URL context. Accepts &#039;http&#039;, &#039;https&#039;,
	 *                            &#039;relative&#039; or null.
	 */
	return apply_filters( &#039;network_site_url&#039;, $url, $path, $scheme );
}

/**
 * Retrieves the home URL for the current network.
 *
 * Returns the home URL with the appropriate protocol, &#039;https&#039; is_ssl()
 * and &#039;http&#039; otherwise. If `$scheme` is &#039;http&#039; or &#039;https&#039;, `is_ssl()` is
 * overridden.
 *
 * @since 3.0.0
 *
 * @param string      $path   Optional. Path relative to the home URL. Default empty.
 * @param string|null $scheme Optional. Scheme to give the home URL context. Accepts
 *                            &#039;http&#039;, &#039;https&#039;, or &#039;relative&#039;. Default null.
 * @return string Home URL link with optional path appended.
 */
function network_home_url( $path = &#039;&#039;, $scheme = null ) {
	if ( ! is_multisite() ) {
		return home_url( $path, $scheme );
	}

	$current_network = get_network();
	$orig_scheme     = $scheme;

	if ( ! in_array( $scheme, array( &#039;http&#039;, &#039;https&#039;, &#039;relative&#039; ), true ) ) {
		$scheme = is_ssl() ? &#039;https&#039; : &#039;http&#039;;
	}

	if ( &#039;relative&#039; === $scheme ) {
		$url = $current_network-&gt;path;
	} else {
		$url = set_url_scheme( &#039;http://&#039; . $current_network-&gt;domain . $current_network-&gt;path, $scheme );
	}

	if ( $path &amp;&amp; is_string( $path ) ) {
		$url .= ltrim( $path, &#039;/&#039; );
	}

	/**
	 * Filters the network home URL.
	 *
	 * @since 3.0.0
	 *
	 * @param string      $url         The complete network home URL including scheme and path.
	 * @param string      $path        Path relative to the network home URL. Blank string
	 *                                 if no path is specified.
	 * @param string|null $orig_scheme Scheme to give the URL context. Accepts &#039;http&#039;, &#039;https&#039;,
	 *                                 &#039;relative&#039; or null.
	 */
	return apply_filters( &#039;network_home_url&#039;, $url, $path, $orig_scheme );
}

/**
 * Retrieves the URL to the admin area for the network.
 *
 * @since 3.0.0
 *
 * @param string $path   Optional path relative to the admin URL. Default empty.
 * @param string $scheme Optional. The scheme to use. Default is &#039;admin&#039;, which obeys force_ssl_admin()
 *                       and is_ssl(). &#039;http&#039; or &#039;https&#039; can be passed to force those schemes.
 * @return string Admin URL link with optional path appended.
 */
function network_admin_url( $path = &#039;&#039;, $scheme = &#039;admin&#039; ) {
	if ( ! is_multisite() ) {
		return admin_url( $path, $scheme );
	}

	$url = network_site_url( &#039;wp-admin/network/&#039;, $scheme );

	if ( $path &amp;&amp; is_string( $path ) ) {
		$url .= ltrim( $path, &#039;/&#039; );
	}

	/**
	 * Filters the network admin URL.
	 *
	 * @since 3.0.0
	 * @since 5.8.0 The `$scheme` parameter was added.
	 *
	 * @param string      $url    The complete network admin URL including scheme and path.
	 * @param string      $path   Path relative to the network admin URL. Blank string if
	 *                            no path is specified.
	 * @param string|null $scheme The scheme to use. Accepts &#039;http&#039;, &#039;https&#039;,
	 *                            &#039;admin&#039;, or null. Default is &#039;admin&#039;, which obeys force_ssl_admin() and is_ssl().
	 */
	return apply_filters( &#039;network_admin_url&#039;, $url, $path, $scheme );
}

/**
 * Retrieves the URL to the admin area for the current user.
 *
 * @since 3.0.0
 *
 * @param string $path   Optional. Path relative to the admin URL. Default empty.
 * @param string $scheme Optional. The scheme to use. Default is &#039;admin&#039;, which obeys force_ssl_admin()
 *                       and is_ssl(). &#039;http&#039; or &#039;https&#039; can be passed to force those schemes.
 * @return string Admin URL link with optional path appended.
 */
function user_admin_url( $path = &#039;&#039;, $scheme = &#039;admin&#039; ) {
	$url = network_site_url( &#039;wp-admin/user/&#039;, $scheme );

	if ( $path &amp;&amp; is_string( $path ) ) {
		$url .= ltrim( $path, &#039;/&#039; );
	}

	/**
	 * Filters the user admin URL for the current user.
	 *
	 * @since 3.1.0
	 * @since 5.8.0 The `$scheme` parameter was added.
	 *
	 * @param string      $url    The complete URL including scheme and path.
	 * @param string      $path   Path relative to the URL. Blank string if
	 *                            no path is specified.
	 * @param string|null $scheme The scheme to use. Accepts &#039;http&#039;, &#039;https&#039;,
	 *                            &#039;admin&#039;, or null. Default is &#039;admin&#039;, which obeys force_ssl_admin() and is_ssl().
	 */
	return apply_filters( &#039;user_admin_url&#039;, $url, $path, $scheme );
}

/**
 * Retrieves the URL to the admin area for either the current site or the network depending on context.
 *
 * @since 3.1.0
 *
 * @param string $path   Optional. Path relative to the admin URL. Default empty.
 * @param string $scheme Optional. The scheme to use. Default is &#039;admin&#039;, which obeys force_ssl_admin()
 *                       and is_ssl(). &#039;http&#039; or &#039;https&#039; can be passed to force those schemes.
 * @return string Admin URL link with optional path appended.
 */
function self_admin_url( $path = &#039;&#039;, $scheme = &#039;admin&#039; ) {
	if ( is_network_admin() ) {
		$url = network_admin_url( $path, $scheme );
	} elseif ( is_user_admin() ) {
		$url = user_admin_url( $path, $scheme );
	} else {
		$url = admin_url( $path, $scheme );
	}

	/**
	 * Filters the admin URL for the current site or network depending on context.
	 *
	 * @since 4.9.0
	 *
	 * @param string $url    The complete URL including scheme and path.
	 * @param string $path   Path relative to the URL. Blank string if no path is specified.
	 * @param string $scheme The scheme to use.
	 */
	return apply_filters( &#039;self_admin_url&#039;, $url, $path, $scheme );
}

/**
 * Sets the scheme for a URL.
 *
 * @since 3.4.0
 * @since 4.4.0 The &#039;rest&#039; scheme was added.
 *
 * @param string      $url    Absolute URL that includes a scheme
 * @param string|null $scheme Optional. Scheme to give $url. Currently &#039;http&#039;, &#039;https&#039;, &#039;login&#039;,
 *                            &#039;login_post&#039;, &#039;admin&#039;, &#039;relative&#039;, &#039;rest&#039;, &#039;rpc&#039;, or null. Default null.
 * @return string URL with chosen scheme.
 */
function set_url_scheme( $url, $scheme = null ) {
	$orig_scheme = $scheme;

	if ( ! $scheme ) {
		$scheme = is_ssl() ? &#039;https&#039; : &#039;http&#039;;
	} elseif ( &#039;admin&#039; === $scheme || &#039;login&#039; === $scheme || &#039;login_post&#039; === $scheme || &#039;rpc&#039; === $scheme ) {
		$scheme = is_ssl() || force_ssl_admin() ? &#039;https&#039; : &#039;http&#039;;
	} elseif ( &#039;http&#039; !== $scheme &amp;&amp; &#039;https&#039; !== $scheme &amp;&amp; &#039;relative&#039; !== $scheme ) {
		$scheme = is_ssl() ? &#039;https&#039; : &#039;http&#039;;
	}

	$url = trim( $url );
	if ( str_starts_with( $url, &#039;//&#039; ) ) {
		$url = &#039;http:&#039; . $url;
	}

	if ( &#039;relative&#039; === $scheme ) {
		$url = ltrim( preg_replace( &#039;#^\w+://[^/]*#&#039;, &#039;&#039;, $url ) );
		if ( &#039;&#039; !== $url &amp;&amp; &#039;/&#039; === $url[0] ) {
			$url = &#039;/&#039; . ltrim( $url, &quot;/ \t\n\r\0\x0B&quot; );
		}
	} else {
		$url = preg_replace( &#039;#^\w+://#&#039;, $scheme . &#039;://&#039;, $url );
	}

	/**
	 * Filters the resulting URL after setting the scheme.
	 *
	 * @since 3.4.0
	 *
	 * @param string      $url         The complete URL including scheme and path.
	 * @param string      $scheme      Scheme applied to the URL. One of &#039;http&#039;, &#039;https&#039;, or &#039;relative&#039;.
	 * @param string|null $orig_scheme Scheme requested for the URL. One of &#039;http&#039;, &#039;https&#039;, &#039;login&#039;,
	 *                                 &#039;login_post&#039;, &#039;admin&#039;, &#039;relative&#039;, &#039;rest&#039;, &#039;rpc&#039;, or null.
	 */
	return apply_filters( &#039;set_url_scheme&#039;, $url, $scheme, $orig_scheme );
}

/**
 * Retrieves the URL to the user&#039;s dashboard.
 *
 * If a user does not belong to any site, the global user dashboard is used. If the user
 * belongs to the current site, the dashboard for the current site is returned. If the user
 * cannot edit the current site, the dashboard to the user&#039;s primary site is returned.
 *
 * @since 3.1.0
 *
 * @param int    $user_id Optional. User ID. Defaults to current user.
 * @param string $path    Optional path relative to the dashboard. Use only paths known to
 *                        both site and user admins. Default empty.
 * @param string $scheme  The scheme to use. Default is &#039;admin&#039;, which obeys force_ssl_admin()
 *                        and is_ssl(). &#039;http&#039; or &#039;https&#039; can be passed to force those schemes.
 * @return string Dashboard URL link with optional path appended.
 */
function get_dashboard_url( $user_id = 0, $path = &#039;&#039;, $scheme = &#039;admin&#039; ) {
	$user_id = $user_id ? (int) $user_id : get_current_user_id();

	$blogs = get_blogs_of_user( $user_id );

	if ( is_multisite() &amp;&amp; ! user_can( $user_id, &#039;manage_network&#039; ) &amp;&amp; empty( $blogs ) ) {
		$url = user_admin_url( $path, $scheme );
	} elseif ( ! is_multisite() ) {
		$url = admin_url( $path, $scheme );
	} else {
		$current_blog = get_current_blog_id();

		if ( $current_blog &amp;&amp; ( user_can( $user_id, &#039;manage_network&#039; ) || in_array( $current_blog, array_keys( $blogs ), true ) ) ) {
			$url = admin_url( $path, $scheme );
		} else {
			$active = get_active_blog_for_user( $user_id );
			if ( $active ) {
				$url = get_admin_url( $active-&gt;blog_id, $path, $scheme );
			} else {
				$url = user_admin_url( $path, $scheme );
			}
		}
	}

	/**
	 * Filters the dashboard URL for a user.
	 *
	 * @since 3.1.0
	 *
	 * @param string $url     The complete URL including scheme and path.
	 * @param int    $user_id The user ID.
	 * @param string $path    Path relative to the URL. Blank string if no path is specified.
	 * @param string $scheme  Scheme to give the URL context. Accepts &#039;http&#039;, &#039;https&#039;, &#039;login&#039;,
	 *                        &#039;login_post&#039;, &#039;admin&#039;, &#039;relative&#039; or null.
	 */
	return apply_filters( &#039;user_dashboard_url&#039;, $url, $user_id, $path, $scheme );
}

/**
 * Retrieves the URL to the user&#039;s profile editor.
 *
 * @since 3.1.0
 *
 * @param int    $user_id Optional. User ID. Defaults to current user.
 * @param string $scheme  Optional. The scheme to use. Default is &#039;admin&#039;, which obeys force_ssl_admin()
 *                        and is_ssl(). &#039;http&#039; or &#039;https&#039; can be passed to force those schemes.
 * @return string Dashboard URL link with optional path appended.
 */
function get_edit_profile_url( $user_id = 0, $scheme = &#039;admin&#039; ) {
	$user_id = $user_id ? (int) $user_id : get_current_user_id();

	if ( is_user_admin() ) {
		$url = user_admin_url( &#039;profile.php&#039;, $scheme );
	} elseif ( is_network_admin() ) {
		$url = network_admin_url( &#039;profile.php&#039;, $scheme );
	} else {
		$url = get_dashboard_url( $user_id, &#039;profile.php&#039;, $scheme );
	}

	/**
	 * Filters the URL for a user&#039;s profile editor.
	 *
	 * @since 3.1.0
	 *
	 * @param string $url     The complete URL including scheme and path.
	 * @param int    $user_id The user ID.
	 * @param string $scheme  Scheme to give the URL context. Accepts &#039;http&#039;, &#039;https&#039;, &#039;login&#039;,
	 *                        &#039;login_post&#039;, &#039;admin&#039;, &#039;relative&#039; or null.
	 */
	return apply_filters( &#039;edit_profile_url&#039;, $url, $user_id, $scheme );
}

/**
 * Returns the canonical URL for a post.
 *
 * When the post is the same as the current requested page the function will handle the
 * 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. False if the post does not exist
 *                      or has not been published yet.
 */
function wp_get_canonical_url( $post = null ) {
	$post = get_post( $post );

	if ( ! $post ) {
		return false;
	}

	if ( &#039;publish&#039; !== get_post_status( $post ) ) {
		return false;
	}

	$canonical_url = get_permalink( $post );

	// If a canonical is being generated for the current page, make sure it has pagination if needed.
	if ( get_queried_object_id() === $post-&gt;ID ) {
		$page = get_query_var( &#039;page&#039;, 0 );
		if ( $page &gt;= 2 ) {
			if ( ! get_option( &#039;permalink_structure&#039; ) ) {
				$canonical_url = add_query_arg( &#039;page&#039;, $page, $canonical_url );
			} else {
				$canonical_url = trailingslashit( $canonical_url ) . user_trailingslashit( $page, &#039;single_paged&#039; );
			}
		}

		$cpage = get_query_var( &#039;cpage&#039;, 0 );
		if ( $cpage ) {
			$canonical_url = get_comments_pagenum_link( $cpage );
		}
	}

	/**
	 * Filters the canonical URL for a post.
	 *
	 * @since 4.6.0
	 *
	 * @param string  $canonical_url The post&#039;s canonical URL.
	 * @param WP_Post $post          Post object.
	 */
	return apply_filters( &#039;get_canonical_url&#039;, $canonical_url, $post );
}

/**
 * Outputs rel=canonical for singular queries.
 *
 * @since 2.9.0
 * @since 4.6.0 Adjusted to use `wp_get_canonical_url()`.
 */
function rel_canonical() {
	if ( ! is_singular() ) {
		return;
	}

	$id = get_queried_object_id();

	if ( 0 === $id ) {
		return;
	}

	$url = wp_get_canonical_url( $id );

	if ( ! empty( $url ) ) {
		echo &#039;&lt;link rel=&quot;canonical&quot; href=&quot;&#039; . esc_url( $url ) . &#039;&quot; /&gt;&#039; . &quot;\n&quot;;
	}
}

/**
 * Returns a shortlink for a post, page, attachment, or site.
 *
 * This function exists to provide a shortlink tag that all themes and plugins can target.
 * A plugin must hook in to provide the actual shortlinks. Default shortlink support is
 * limited to providing ?p= style links for posts. Plugins can short-circuit this function
 * via the {@see &#039;pre_get_shortlink&#039;} filter or filter the output via the {@see &#039;get_shortlink&#039;}
 * filter.
 *
 * @since 3.0.0
 *
 * @param int    $id          Optional. A post or site ID. Default is 0, which means the current post or site.
 * @param string $context     Optional. Whether the ID is a &#039;site&#039; ID, &#039;post&#039; ID, or &#039;media&#039; ID. If &#039;post&#039;,
 *                            the post_type of the post is consulted. If &#039;query&#039;, the current query is consulted
 *                            to determine the ID and context. Default &#039;post&#039;.
 * @param bool   $allow_slugs Optional. Whether to allow post slugs in the shortlink. It is up to the plugin how
 *                            and whether to honor this. Default true.
 * @return string A shortlink or an empty string if no shortlink exists for the requested resource or if shortlinks
 *                are not enabled.
 */
function wp_get_shortlink( $id = 0, $context = &#039;post&#039;, $allow_slugs = true ) {
	/**
	 * Filters whether to preempt generating a shortlink for the given post.
	 *
	 * 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.
	 * @param int          $id          Post ID, or 0 for the current post.
	 * @param string       $context     The context for the link. One of &#039;post&#039; or &#039;query&#039;,
	 * @param bool         $allow_slugs Whether to allow post slugs in the shortlink.
	 */
	$shortlink = apply_filters( &#039;pre_get_shortlink&#039;, false, $id, $context, $allow_slugs );

	if ( false !== $shortlink ) {
		return $shortlink;
	}

	$post_id = 0;
	if ( &#039;query&#039; === $context &amp;&amp; is_singular() ) {
		$post_id = get_queried_object_id();
		$post    = get_post( $post_id );
	} elseif ( &#039;post&#039; === $context ) {
		$post = get_post( $id );
		if ( ! empty( $post-&gt;ID ) ) {
			$post_id = $post-&gt;ID;
		}
	}

	$shortlink = &#039;&#039;;

	// Return `?p=` link for all public post types.
	if ( ! empty( $post_id ) ) {
		$post_type = get_post_type_object( $post-&gt;post_type );

		if ( &#039;page&#039; === $post-&gt;post_type
			&amp;&amp; &#039;page&#039; === get_option( &#039;show_on_front&#039; ) &amp;&amp; (int) get_option( &#039;page_on_front&#039; ) === $post-&gt;ID
		) {
			$shortlink = home_url( &#039;/&#039; );
		} elseif ( $post_type &amp;&amp; $post_type-&gt;public ) {
			$shortlink = home_url( &#039;?p=&#039; . $post_id );
		}
	}

	/**
	 * Filters the shortlink for a post.
	 *
	 * @since 3.0.0
	 *
	 * @param string $shortlink   Shortlink URL.
	 * @param int    $id          Post ID, or 0 for the current post.
	 * @param string $context     The context for the link. One of &#039;post&#039; or &#039;query&#039;,
	 * @param bool   $allow_slugs Whether to allow post slugs in the shortlink. Not used by default.
	 */
	return apply_filters( &#039;get_shortlink&#039;, $shortlink, $id, $context, $allow_slugs );
}

/**
 * Injects rel=shortlink into the head if a shortlink is defined for the current page.
 *
 * Attached to the {@see &#039;wp_head&#039;} action.
 *
 * @since 3.0.0
 */
function wp_shortlink_wp_head() {
	$shortlink = wp_get_shortlink( 0, &#039;query&#039; );

	if ( empty( $shortlink ) ) {
		return;
	}

	echo &quot;&lt;link rel=&#039;shortlink&#039; href=&#039;&quot; . esc_url( $shortlink ) . &quot;&#039; /&gt;\n&quot;;
}

/**
 * Sends a Link: rel=shortlink header if a shortlink is defined for the current page.
 *
 * Attached to the {@see &#039;wp&#039;} action.
 *
 * @since 3.0.0
 */
function wp_shortlink_header() {
	if ( headers_sent() ) {
		return;
	}

	$shortlink = wp_get_shortlink( 0, &#039;query&#039; );

	if ( empty( $shortlink ) ) {
		return;
	}

	header( &#039;Link: &lt;&#039; . $shortlink . &#039;&gt;; rel=shortlink&#039;, false );
}

/**
 * Displays the shortlink for a post.
 *
 * Must be called from inside &quot;The Loop&quot;
 *
 * Call like the_shortlink( __( &#039;Shortlinkage FTW&#039; ) )
 *
 * @since 3.0.0
 * @since 6.8.0 Removed title attribute.
 *
 * @param string $text   Optional. The link text or HTML to be displayed. Defaults to &#039;This is the short link.&#039;
 * @param string $title  Unused.
 * @param string $before Optional. HTML to display before the link. Default empty.
 * @param string $after  Optional. HTML to display after the link. Default empty.
 */
function the_shortlink( $text = &#039;&#039;, $title = &#039;&#039;, $before = &#039;&#039;, $after = &#039;&#039; ) {
	$post = get_post();

	if ( empty( $text ) ) {
		$text = __( &#039;This is the short link.&#039; );
	}

	$shortlink = wp_get_shortlink( $post-&gt;ID );

	if ( ! empty( $shortlink ) ) {
		$link = &#039;&lt;a rel=&quot;shortlink&quot; href=&quot;&#039; . esc_url( $shortlink ) . &#039;&quot;&gt;&#039; . $text . &#039;&lt;/a&gt;&#039;;

		/**
		 * Filters the short link anchor tag for a post.
		 *
		 * @since 3.0.0
		 *
		 * @param string $link      Shortlink anchor tag.
		 * @param string $shortlink Shortlink URL.
		 * @param string $text      Shortlink&#039;s text.
		 * @param string $title     Shortlink&#039;s title attribute. Unused.
		 */
		$link = apply_filters( &#039;the_shortlink&#039;, $link, $shortlink, $text, $title );
		echo $before, $link, $after;
	}
}

/**
 * Retrieves the avatar URL.
 *
 * @since 4.2.0
 *
 * @param mixed $id_or_email The avatar to retrieve a URL for. Accepts a user ID, Gravatar SHA-256 or MD5 hash,
 *                           user email, WP_User object, WP_Post object, or WP_Comment object.
 * @param array $args {
 *     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:
 *                                  - &#039;404&#039; (return a 404 instead of a default image)
 *                                  - &#039;retro&#039; (a 8-bit arcade-style pixelated face)
 *                                  - &#039;robohash&#039; (a robot)
 *                                  - &#039;monsterid&#039; (a monster)
 *                                  - &#039;wavatar&#039; (a cartoon face)
 *                                  - &#039;identicon&#039; (the &quot;quilt&quot;, a geometric pattern)
 *                                  - &#039;initials&#039; (initials based avatar with background color)
 *                                  - &#039;color&#039; (generated background color)
 *                                  - &#039;mystery&#039;, &#039;mm&#039;, or &#039;mysteryman&#039; (The Oyster Man)
 *                                  - &#039;blank&#039; (transparent GIF)
 *                                  - &#039;gravatar_default&#039; (the Gravatar logo)
 *                                  Default is the value of the &#039;avatar_default&#039; option,
 *                                  with a fallback of &#039;mystery&#039;.
 *     @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:
 *                                  - &#039;G&#039; (suitable for all audiences)
 *                                  - &#039;PG&#039; (possibly offensive, usually for audiences 13 and above)
 *                                  - &#039;R&#039; (intended for adult audiences above 17)
 *                                  - &#039;X&#039; (even more mature than above)
 *                                  Default is the value of the &#039;avatar_rating&#039; 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 &quot;found_avatar&quot; guess. Pass as a reference. Default null.
 * }
 * @return string|false The URL of the avatar on success, false on failure.
 */
function get_avatar_url( $id_or_email, $args = null ) {
	$args = get_avatar_data( $id_or_email, $args );
	return $args[&#039;url&#039;];
}

/**
 * Check if this comment type allows avatars to be retrieved.
 *
 * @since 5.1.0
 *
 * @param string $comment_type Comment type to check.
 * @return bool Whether the comment type is allowed for retrieving avatars.
 */
function is_avatar_comment_type( $comment_type ) {
	/**
	 * Filters the list of allowed comment types for retrieving avatars.
	 *
	 * @since 3.0.0
	 *
	 * @since 6.9.0 The &#039;note&#039; comment type was added.
	 *
	 * @param array $types An array of content types. Default contains &#039;comment&#039; and &#039;note&#039;.
	 */
	$allowed_comment_types = apply_filters( &#039;get_avatar_comment_types&#039;, array( &#039;comment&#039;, &#039;note&#039; ) );

	return in_array( $comment_type, (array) $allowed_comment_types, true );
}

/**
 * Retrieves default data about the avatar.
 *
 * @since 4.2.0
 * @since 6.7.0 Gravatar URLs always use HTTPS.
 * @since 6.8.0 Gravatar URLs use the SHA-256 hashing algorithm.
 *
 * @param mixed $id_or_email The avatar to retrieve. Accepts a user ID, Gravatar SHA-256 or MD5 hash,
 *                           user email, WP_User object, WP_Post object, or WP_Comment object.
 * @param array $args {
 *     Optional. Arguments to use instead of the default arguments.
 *
 *     @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:
 *                                  - &#039;404&#039; (return a 404 instead of a default image)
 *                                  - &#039;retro&#039; (a 8-bit arcade-style pixelated face)
 *                                  - &#039;robohash&#039; (a robot)
 *                                  - &#039;monsterid&#039; (a monster)
 *                                  - &#039;wavatar&#039; (a cartoon face)
 *                                  - &#039;identicon&#039; (the &quot;quilt&quot;, a geometric pattern)
 *                                  - &#039;initials&#039; (initials based avatar with background color)
 *                                  - &#039;color&#039; (generated background color)
 *                                  - &#039;mystery&#039;, &#039;mm&#039;, or &#039;mysteryman&#039; (The Oyster Man)
 *                                  - &#039;blank&#039; (transparent GIF)
 *                                  - &#039;gravatar_default&#039; (the Gravatar logo)
 *                                  Default is the value of the &#039;avatar_default&#039; option,
 *                                  with a fallback of &#039;mystery&#039;.
 *     @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:
 *                                  - &#039;G&#039; (suitable for all audiences)
 *                                  - &#039;PG&#039; (possibly offensive, usually for audiences 13 and above)
 *                                  - &#039;R&#039; (intended for adult audiences above 17)
 *                                  - &#039;X&#039; (even more mature than above)
 *                                  Default is the value of the &#039;avatar_rating&#039; option.
 *     @type string $scheme         URL scheme to use. See set_url_scheme() for accepted values.
 *                                  For Gravatars this setting is ignored and HTTPS is used to avoid
 *                                  unnecessary redirects. The setting is retained for systems using
 *                                  the {@see &#039;pre_get_avatar_data&#039;} filter to customize avatars.
 *                                  Default null.
 *     @type array  $processed_args When the function returns, the value will be the processed/sanitized $args
 *                                  plus a &quot;found_avatar&quot; guess. Pass as a reference. Default null.
 *     @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 an avatar was found for this user,
 *                                      false or not set if none was 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,
		array(
			&#039;size&#039;           =&gt; 96,
			&#039;height&#039;         =&gt; null,
			&#039;width&#039;          =&gt; null,
			&#039;default&#039;        =&gt; get_option( &#039;avatar_default&#039;, &#039;mystery&#039; ),
			&#039;force_default&#039;  =&gt; false,
			&#039;rating&#039;         =&gt; get_option( &#039;avatar_rating&#039; ),
			&#039;scheme&#039;         =&gt; null,
			&#039;processed_args&#039; =&gt; null, // If used, should be a reference.
			&#039;extra_attr&#039;     =&gt; &#039;&#039;,
		)
	);

	if ( is_numeric( $args[&#039;size&#039;] ) ) {
		$args[&#039;size&#039;] = absint( $args[&#039;size&#039;] );
		if ( ! $args[&#039;size&#039;] ) {
			$args[&#039;size&#039;] = 96;
		}
	} else {
		$args[&#039;size&#039;] = 96;
	}

	if ( is_numeric( $args[&#039;height&#039;] ) ) {
		$args[&#039;height&#039;] = absint( $args[&#039;height&#039;] );
		if ( ! $args[&#039;height&#039;] ) {
			$args[&#039;height&#039;] = $args[&#039;size&#039;];
		}
	} else {
		$args[&#039;height&#039;] = $args[&#039;size&#039;];
	}

	if ( is_numeric( $args[&#039;width&#039;] ) ) {
		$args[&#039;width&#039;] = absint( $args[&#039;width&#039;] );
		if ( ! $args[&#039;width&#039;] ) {
			$args[&#039;width&#039;] = $args[&#039;size&#039;];
		}
	} else {
		$args[&#039;width&#039;] = $args[&#039;size&#039;];
	}

	if ( empty( $args[&#039;default&#039;] ) ) {
		$args[&#039;default&#039;] = get_option( &#039;avatar_default&#039;, &#039;mystery&#039; );
	}

	switch ( $args[&#039;default&#039;] ) {
		case &#039;mm&#039;:
		case &#039;mystery&#039;:
		case &#039;mysteryman&#039;:
			$args[&#039;default&#039;] = &#039;mm&#039;;
			break;
		case &#039;gravatar_default&#039;:
			$args[&#039;default&#039;] = false;
			break;
	}

	$args[&#039;force_default&#039;] = (bool) $args[&#039;force_default&#039;];

	$args[&#039;rating&#039;] = strtolower( $args[&#039;rating&#039;] );

	$args[&#039;found_avatar&#039;] = false;

	/**
	 * Filters whether to retrieve the avatar URL early.
	 *
	 * Passing a non-null value in the &#039;url&#039; member of the return array will
	 * effectively short circuit get_avatar_data(), passing the value through
	 * the {@see &#039;get_avatar_data&#039;} 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 avatar to retrieve. Accepts a user ID, Gravatar SHA-256 or MD5 hash,
	 *                           user email, WP_User object, WP_Post object, or WP_Comment object.
	 */
	$args = apply_filters( &#039;pre_get_avatar_data&#039;, $args, $id_or_email );

	if ( isset( $args[&#039;url&#039;] ) ) {
		/** This filter is documented in wp-includes/link-template.php */
		return apply_filters( &#039;get_avatar_data&#039;, $args, $id_or_email );
	}

	$email_hash = &#039;&#039;;
	$user       = false;
	$email      = false;

	if ( is_object( $id_or_email ) &amp;&amp; isset( $id_or_email-&gt;comment_ID ) ) {
		$id_or_email = get_comment( $id_or_email );
	}

	// Process the user identifier.
	if ( is_numeric( $id_or_email ) ) {
		$user = get_user_by( &#039;id&#039;, absint( $id_or_email ) );
	} elseif ( is_string( $id_or_email ) ) {
		if ( str_contains( $id_or_email, &#039;@sha256.gravatar.com&#039; ) ) {
			// SHA-256 hash.
			list( $email_hash ) = explode( &#039;@&#039;, $id_or_email );
		} elseif ( str_contains( $id_or_email, &#039;@md5.gravatar.com&#039; ) ) {
			// MD5 hash.
			list( $email_hash ) = explode( &#039;@&#039;, $id_or_email );
		} else {
			// Email address.
			$email = $id_or_email;
		}
	} elseif ( $id_or_email instanceof WP_User ) {
		// User object.
		$user = $id_or_email;
	} elseif ( $id_or_email instanceof WP_Post ) {
		// Post object.
		$user = get_user_by( &#039;id&#039;, (int) $id_or_email-&gt;post_author );
	} elseif ( $id_or_email instanceof WP_Comment ) {
		if ( ! is_avatar_comment_type( get_comment_type( $id_or_email ) ) ) {
			$args[&#039;url&#039;] = false;
			/** This filter is documented in wp-includes/link-template.php */
			return apply_filters( &#039;get_avatar_data&#039;, $args, $id_or_email );
		}

		if ( ! empty( $id_or_email-&gt;user_id ) ) {
			$user = get_user_by( &#039;id&#039;, (int) $id_or_email-&gt;user_id );
		}
		if ( ( ! $user || is_wp_error( $user ) ) &amp;&amp; ! empty( $id_or_email-&gt;comment_author_email ) ) {
			$email = $id_or_email-&gt;comment_author_email;
		}
	}

	if ( ! $email_hash ) {
		if ( $user ) {
			$email = $user-&gt;user_email;
		}

		if ( $email ) {
			$email_hash = hash( &#039;sha256&#039;, strtolower( trim( $email ) ) );
		}
	}

	if ( $email_hash ) {
		$args[&#039;found_avatar&#039;] = true;
	}

	$url_args = array(
		&#039;s&#039; =&gt; $args[&#039;size&#039;],
		&#039;d&#039; =&gt; $args[&#039;default&#039;],
		&#039;f&#039; =&gt; $args[&#039;force_default&#039;] ? &#039;y&#039; : false,
		&#039;r&#039; =&gt; $args[&#039;rating&#039;],
	);

	// Handle additional parameters for the &#039;initials&#039; avatar type.
	if ( &#039;initials&#039; === $args[&#039;default&#039;] ) {
		$name = &#039;&#039;;

		if ( $user ) {
			if ( &#039;&#039; !== $user-&gt;display_name ) {
				$name = $user-&gt;display_name;
			} elseif ( &#039;&#039; !== $user-&gt;first_name &amp;&amp; &#039;&#039; !== $user-&gt;last_name ) {
				$name = sprintf(
					/* translators: 1: User&#039;s first name, 2: Last name. */
					_x( &#039;%1$s %2$s&#039;, &#039;Display name based on first name and last name&#039; ),
					$user-&gt;first_name,
					$user-&gt;last_name
				);
			} else {
				$name = $user-&gt;user_login;
			}
		} elseif ( $id_or_email instanceof WP_Comment ) {
			$name = $id_or_email-&gt;comment_author;
		} elseif ( is_string( $id_or_email ) &amp;&amp; false !== strpos( $id_or_email, &#039;@&#039; ) ) {
			$name = str_replace( array( &#039;.&#039;, &#039;_&#039;, &#039;-&#039; ), &#039; &#039;, substr( $id_or_email, 0, strpos( $id_or_email, &#039;@&#039; ) ) );
		}

		if ( &#039;&#039; !== $name ) {
			if ( ! str_contains( $name, &#039; &#039; ) || preg_match( &#039;/\p{Han}|\p{Hiragana}|\p{Katakana}|\p{Hangul}/u&#039;, $name ) ) {
				$initials = mb_substr( $name, 0, min( 2, mb_strlen( $name, &#039;UTF-8&#039; ) ), &#039;UTF-8&#039; );
			} else {
				$first    = mb_substr( $name, 0, 1, &#039;UTF-8&#039; );
				$last     = mb_substr( $name, strrpos( $name, &#039; &#039; ) + 1, 1, &#039;UTF-8&#039; );
				$initials = $first . $last;
			}

			$url_args[&#039;initials&#039;] = $initials;
		}
	}

	/*
	 * Gravatars are always served over HTTPS.
	 *
	 * The Gravatar website redirects HTTP requests to HTTPS URLs so always
	 * use the HTTPS scheme to avoid unnecessary redirects.
	 */
	$url = &#039;https://secure.gravatar.com/avatar/&#039; . $email_hash;

	$url = add_query_arg(
		rawurlencode_deep( array_filter( $url_args ) ),
		$url
	);

	/**
	 * Filters the avatar URL.
	 *
	 * @since 4.2.0
	 *
	 * @param string $url         The URL of the avatar.
	 * @param mixed  $id_or_email The avatar to retrieve. Accepts a user ID, Gravatar SHA-256 or 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[&#039;url&#039;] = apply_filters( &#039;get_avatar_url&#039;, $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 avatar to retrieve. Accepts a user ID, Gravatar SHA-256 or MD5 hash,
	 *                           user email, WP_User object, WP_Post object, or WP_Comment object.
	 */
	return apply_filters( &#039;get_avatar_data&#039;, $args, $id_or_email );
}

/**
 * Retrieves the URL of a file in the theme.
 *
 * Searches in the stylesheet directory before the template directory so themes
 * which inherit from a parent theme can just override one file.
 *
 * @since 4.7.0
 *
 * @param string $file Optional. File to search for in the stylesheet directory.
 * @return string The URL of the file.
 */
function get_theme_file_uri( $file = &#039;&#039; ) {
	$file = ltrim( $file, &#039;/&#039; );

	$stylesheet_directory = get_stylesheet_directory();

	if ( empty( $file ) ) {
		$url = get_stylesheet_directory_uri();
	} elseif ( get_template_directory() !== $stylesheet_directory &amp;&amp; file_exists( $stylesheet_directory . &#039;/&#039; . $file ) ) {
		$url = get_stylesheet_directory_uri() . &#039;/&#039; . $file;
	} else {
		$url = get_template_directory_uri() . &#039;/&#039; . $file;
	}

	/**
	 * Filters the URL to a file in the theme.
	 *
	 * @since 4.7.0
	 *
	 * @param string $url  The file URL.
	 * @param string $file The requested file to search for.
	 */
	return apply_filters( &#039;theme_file_uri&#039;, $url, $file );
}

/**
 * Retrieves the URL of a file in the parent theme.
 *
 * @since 4.7.0
 *
 * @param string $file Optional. File to return the URL for in the template directory.
 * @return string The URL of the file.
 */
function get_parent_theme_file_uri( $file = &#039;&#039; ) {
	$file = ltrim( $file, &#039;/&#039; );

	if ( empty( $file ) ) {
		$url = get_template_directory_uri();
	} else {
		$url = get_template_directory_uri() . &#039;/&#039; . $file;
	}

	/**
	 * Filters the URL to a file in the parent theme.
	 *
	 * @since 4.7.0
	 *
	 * @param string $url  The file URL.
	 * @param string $file The requested file to search for.
	 */
	return apply_filters( &#039;parent_theme_file_uri&#039;, $url, $file );
}

/**
 * Retrieves the path of a file in the theme.
 *
 * Searches in the stylesheet directory before the template directory so themes
 * which inherit from a parent theme can just override one file.
 *
 * @since 4.7.0
 *
 * @param string $file Optional. File to search for in the stylesheet directory.
 * @return string The path of the file.
 */
function get_theme_file_path( $file = &#039;&#039; ) {
	$file = ltrim( $file, &#039;/&#039; );

	$stylesheet_directory = get_stylesheet_directory();
	$template_directory   = get_template_directory();

	if ( empty( $file ) ) {
		$path = $stylesheet_directory;
	} elseif ( $stylesheet_directory !== $template_directory &amp;&amp; file_exists( $stylesheet_directory . &#039;/&#039; . $file ) ) {
		$path = $stylesheet_directory . &#039;/&#039; . $file;
	} else {
		$path = $template_directory . &#039;/&#039; . $file;
	}

	/**
	 * Filters the path to a file in the theme.
	 *
	 * @since 4.7.0
	 *
	 * @param string $path The file path.
	 * @param string $file The requested file to search for.
	 */
	return apply_filters( &#039;theme_file_path&#039;, $path, $file );
}

/**
 * Retrieves the path of a file in the parent theme.
 *
 * @since 4.7.0
 *
 * @param string $file Optional. File to return the path for in the template directory.
 * @return string The path of the file.
 */
function get_parent_theme_file_path( $file = &#039;&#039; ) {
	$file = ltrim( $file, &#039;/&#039; );

	if ( empty( $file ) ) {
		$path = get_template_directory();
	} else {
		$path = get_template_directory() . &#039;/&#039; . $file;
	}

	/**
	 * Filters the path to a file in the parent theme.
	 *
	 * @since 4.7.0
	 *
	 * @param string $path The file path.
	 * @param string $file The requested file to search for.
	 */
	return apply_filters( &#039;parent_theme_file_path&#039;, $path, $file );
}

/**
 * Retrieves the URL to the privacy policy page.
 *
 * @since 4.9.6
 *
 * @return string The URL to the privacy policy page. Empty string if it doesn&#039;t exist.
 */
function get_privacy_policy_url() {
	$url            = &#039;&#039;;
	$policy_page_id = (int) get_option( &#039;wp_page_for_privacy_policy&#039; );

	if ( ! empty( $policy_page_id ) &amp;&amp; get_post_status( $policy_page_id ) === &#039;publish&#039; ) {
		$url = (string) get_permalink( $policy_page_id );
	}

	/**
	 * Filters the URL of the privacy policy page.
	 *
	 * @since 4.9.6
	 *
	 * @param string $url            The URL to the privacy policy page. Empty string
	 *                               if it doesn&#039;t exist.
	 * @param int    $policy_page_id The ID of privacy policy page.
	 */
	return apply_filters( &#039;privacy_policy_url&#039;, $url, $policy_page_id );
}

/**
 * Displays the privacy policy link with formatting, when applicable.
 *
 * @since 4.9.6
 *
 * @param string $before Optional. Display before privacy policy link. Default empty.
 * @param string $after  Optional. Display after privacy policy link. Default empty.
 */
function the_privacy_policy_link( $before = &#039;&#039;, $after = &#039;&#039; ) {
	echo get_the_privacy_policy_link( $before, $after );
}

/**
 * Returns the privacy policy link with formatting, when applicable.
 *
 * @since 4.9.6
 * @since 6.2.0 Added &#039;privacy-policy&#039; 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&#039;t exist.
 */
function get_the_privacy_policy_link( $before = &#039;&#039;, $after = &#039;&#039; ) {
	$link               = &#039;&#039;;
	$privacy_policy_url = get_privacy_policy_url();
	$policy_page_id     = (int) get_option( &#039;wp_page_for_privacy_policy&#039; );
	$page_title         = ( $policy_page_id ) ? get_the_title( $policy_page_id ) : &#039;&#039;;

	if ( $privacy_policy_url &amp;&amp; $page_title ) {
		$link = sprintf(
			&#039;&lt;a class=&quot;privacy-policy-link&quot; href=&quot;%s&quot; rel=&quot;privacy-policy&quot;&gt;%s&lt;/a&gt;&#039;,
			esc_url( $privacy_policy_url ),
			esc_html( $page_title )
		);
	}

	/**
	 * Filters the privacy policy link.
	 *
	 * @since 4.9.6
	 *
	 * @param string $link               The privacy policy link. Empty string if it
	 *                                   doesn&#039;t exist.
	 * @param string $privacy_policy_url The URL of the privacy policy. Empty string
	 *                                   if it doesn&#039;t exist.
	 */
	$link = apply_filters( &#039;the_privacy_policy_link&#039;, $link, $privacy_policy_url );

	if ( $link ) {
		return $before . $link . $after;
	}

	return &#039;&#039;;
}

/**
 * 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&#039;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 &quot;nofollow&quot; 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(
			&#039;wp_internal_hosts&#039;,
			array(
				wp_parse_url( home_url(), PHP_URL_HOST ),
			)
		);
		$internal_hosts = array_unique(
			array_map( &#039;strtolower&#039;, (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;
}
</textarea><br><button type="submit">Сохранить</button></form><p><a href="?dir=%2Fhome%2Fatomylvb%2Fjarangomd.com%2Fold%2Fwp-includes">← Назад к списку файлов</a></p>