函数文档

parent_post_rel_link()

💡 云策文档标注

概述

parent_post_rel_link() 是一个已弃用的 WordPress 函数,用于显示父文章的关联链接。它已被标记为弃用,建议开发者使用替代函数。

关键要点

  • 函数 parent_post_rel_link() 在 WordPress 3.3.0 版本中被弃用,不应在新代码中使用。
  • 它接受一个可选参数 $title,用于指定链接标题格式,默认值为 '%title'。
  • 该函数内部调用 get_parent_post_rel_link() 来获取链接并输出,但已通过 _deprecated_function() 标记为弃用。
  • 相关函数包括 get_parent_post_rel_link() 和 _deprecated_function(),分别用于获取父文章链接和标记弃用。

注意事项

  • 自 WordPress 3.3.0 起,此函数已被弃用,开发者应改用 get_parent_post_rel_link() 或其他现代方法。
  • 使用弃用函数可能导致兼容性问题或未来版本中移除,建议更新代码以避免潜在风险。

📄 原文内容

Display relational link for parent item

Parameters

$titlestringoptional
Link title format. Default '%title'.

Source

function parent_post_rel_link( $title = '%title' ) {
	_deprecated_function( __FUNCTION__, '3.3.0' );

	echo get_parent_post_rel_link($title);
}

Changelog

Version Description
3.3.0 Deprecated.
2.8.0 Introduced.