云策 WordPress 开发者社区

函数文档

wp_shortlink_wp_head()

查看官方原文 ↗
💡 云策文档标注

概述

wp_shortlink_wp_head() 是一个 WordPress 函数，用于在页面头部注入 rel=shortlink 标签，前提是当前页面已定义短链接。它作为 'wp_head' 动作的钩子函数。

关键要点

  • 函数通过 wp_get_shortlink() 获取当前页面的短链接，如果不存在则直接返回。
  • 在 'wp_head' 动作中调用，确保短链接标签正确输出到 HTML 头部。
  • 自 WordPress 3.0.0 版本引入，是处理短链接输出的核心函数。

代码示例

function wp_shortlink_wp_head() {
    $shortlink = wp_get_shortlink( 0, 'query' );

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

    echo "<link rel='shortlink' href='" . esc_url( $shortlink ) . "'>n";
}

注意事项

  • 确保短链接已通过 wp_get_shortlink() 定义，否则函数不会输出任何内容。
  • 输出时使用 esc_url() 清理 URL，以提高安全性。
📄 原文内容

Injects rel=shortlink into the head if a shortlink is defined for the current page.

Description

Attached to the ‘wp_head’ action.

Source

function wp_shortlink_wp_head() {
	$shortlink = wp_get_shortlink( 0, 'query' );

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

	echo "<link rel='shortlink' href='" . esc_url( $shortlink ) . "' />n";
}

View all references View on Trac View on GitHub

Uses Description
wp_get_shortlink()wp-includes/link-template.php

Returns a shortlink for a post, page, attachment, or site.
esc_url()wp-includes/formatting.php

Checks and cleans a URL.

Changelog

Version Description
3.0.0 Introduced.