删除一次性URL参数并基于新URL创建规范链接。

原型

wp_admin_canonical_url()

描述

从URL中删除特定查询字符串参数,创建规范链接,将其放在管理标头中,并更改当前URL以匹配。

源文件

路径:wp-admin/includes/misc.php

<?php
...
function wp_admin_canonical_url() {
	$removable_query_args = wp_removable_query_args();
	if ( empty( $removable_query_args ) ) {
		return;
	}
	// Ensure we're using an absolute URL.
	$current_url  = set_url_scheme( 'http://' . $_SERVER['HTTP_HOST'] . $_SERVER['REQUEST_URI'] );
	$filtered_url = remove_query_arg( $removable_query_args, $current_url );
	?>
	<link id="wp-admin-canonical" rel="canonical" href="<?php echo esc_url( $filtered_url ); ?>" />
	<script>
		if ( window.history.replaceState ) {
			window.history.replaceState( null, null, document.getElementById( 'wp-admin-canonical' ).href + window.location.hash );
		}
	</script>
<?php
}
...
?>

其他

英文文档:https://developer.wordpress.org/reference/functions/wp_admin_canonical_url/