函数文档

trackback_url()

💡 云策文档标注

概述

trackback_url() 函数用于显示当前文章的 trackback URL。它已过时,建议使用 get_trackback_url() 替代。

关键要点

  • 函数功能:显示当前文章的 trackback URL,主要用于输出而非返回值。
  • 参数说明:$deprecated_echo 参数已过时,默认值为 true,用于控制是否直接输出 URL。
  • 返回值:当 $deprecated_echo 为 true 时输出 URL,为 false 时返回 URL 字符串,但此用法已不推荐。
  • 替代函数:推荐使用 get_trackback_url() 来获取 trackback URL,以避免过时警告。
  • 版本历史:自 WordPress 0.71 版本引入,$deprecated_echo 参数在 2.5.0 版本被标记为过时。

代码示例

function trackback_url( $deprecated_echo = true ) {
    if ( true !== $deprecated_echo ) {
        _deprecated_argument(
            __FUNCTION__,
            '2.5.0',
            sprintf(
                __( 'Use %s instead if you do not want the value echoed.' ),
                'get_trackback_url()'
            )
        );
    }

    if ( $deprecated_echo ) {
        echo get_trackback_url();
    } else {
        return get_trackback_url();
    }
}

注意事项

  • 此函数已过时,新代码应使用 get_trackback_url() 来获取 trackback URL。
  • 如果设置 $deprecated_echo 为 false,会触发过时警告,建议避免此用法。
  • 函数主要用于输出场景,返回值功能已不推荐。

📄 原文内容

Displays the current post’s trackback URL.

Parameters

$deprecated_echobooloptional
Not used.

Default:true

Return

void|string Should only be used to echo the trackback URL, use get_trackback_url() for the result instead.

Source

function trackback_url( $deprecated_echo = true ) {
	if ( true !== $deprecated_echo ) {
		_deprecated_argument(
			__FUNCTION__,
			'2.5.0',
			sprintf(
				/* translators: %s: get_trackback_url() */
				__( 'Use %s instead if you do not want the value echoed.' ),
				'<code>get_trackback_url()</code>'
			)
		);
	}

	if ( $deprecated_echo ) {
		echo get_trackback_url();
	} else {
		return get_trackback_url();
	}
}

Changelog

Version Description
0.71 Introduced.

User Contributed Notes