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
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. |
Skip to note 2 content
Steven Lin
Example from the legacy Codex:
<p>Trackback URL for this post: </p>