云策 WordPress 开发者社区

函数文档

trackback_rdf()

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

概述

trackback_rdf() 函数用于生成并显示当前文章的 trackback 信息的 RDF 格式。该函数在 WordPress 3.0.0 中被弃用，但在 3.0.1 中恢复。

关键要点

  • 函数功能：生成并输出当前文章的 trackback RDF 数据。
  • 弃用历史：在 WordPress 3.0.0 版本中被弃用，但在 3.0.1 版本中恢复使用。
  • 参数说明：接受一个已弃用的参数 $deprecated（类型为 int 或 string），但实际未使用，原用于时区设置。
  • 代码行为：如果检测到用户代理为 W3C 验证器，则直接返回，不输出 RDF。
  • 相关函数：包括 wptexturize()、the_permalink()、get_the_title()、get_trackback_url() 和 _deprecated_argument() 等。

代码示例

function trackback_rdf( $deprecated = '' ) {
	if ( ! empty( $deprecated ) ) {
		_deprecated_argument( __FUNCTION__, '2.5.0' );
	}

	if ( isset( $_SERVER['HTTP_USER_AGENT'] ) && false !== stripos( $_SERVER['HTTP_USER_AGENT'], 'W3C_Validator' ) ) {
		return;
	}

	echo '<rdf:RDF xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"
		xmlns:dc="http://purl.org/dc/elements/1.1/"
		xmlns:trackback="http://madskills.com/public/xml/rss/module/trackback/">
	<rdf:Description rdf:about="' . get_trackback_url() . '"
		dc:identifier="' . get_trackback_url() . '"
		dc:title="' . get_the_title() . '"
		trackback:ping="' . get_trackback_url() . '" />
</rdf:RDF>';
}

注意事项

该函数主要用于 trackback 功能，在现代 WordPress 开发中可能较少使用，开发者应关注其弃用状态和相关替代方案。

📄 原文内容

Generates and displays the RDF for the trackback information of current post.

Description

Deprecated in 3.0.0, and restored in 3.0.1.

Parameters

$deprecatedint|stringrequired
Not used (Was $timezone = 0).

Source

function trackback_rdf( $deprecated = '' ) {
	if ( ! empty( $deprecated ) ) {
		_deprecated_argument( __FUNCTION__, '2.5.0' );
	}

	if ( isset( $_SERVER['HTTP_USER_AGENT'] ) && false !== stripos( $_SERVER['HTTP_USER_AGENT'], 'W3C_Validator' ) ) {
		return;
	}

	echo '<rdf:RDF xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"
			xmlns:dc="http://purl.org/dc/elements/1.1/"
			xmlns:trackback="http://madskills.com/public/xml/rss/module/trackback/">
		<rdf:Description rdf:about="';
	the_permalink();
	echo '"' . "n";
	echo '    dc:identifier="';
	the_permalink();
	echo '"' . "n";
	echo '    dc:title="' . str_replace( '--', '--', wptexturize( strip_tags( get_the_title() ) ) ) . '"' . "n";
	echo '    trackback:ping="' . get_trackback_url() . '"' . " />n";
	echo '</rdf:rdf>';
}

View all references View on Trac View on GitHub

Uses Description
wptexturize()wp-includes/formatting.php

Replaces common plain text characters with formatted entities.
the_permalink()wp-includes/link-template.php

Displays the permalink for the current post.
get_the_title()wp-includes/post-template.php

Retrieves the post title.
get_trackback_url()wp-includes/comment-template.php

Retrieves the current post’s trackback URL.
_deprecated_argument()wp-includes/functions.php

Marks a function argument as deprecated and inform when it has been used.

Show 1 moreShow less

Changelog

Version Description
0.71 Introduced.