函数文档

comments_rss()

💡 云策文档标注

概述

comments_rss() 是一个已弃用的 WordPress 函数,用于返回文章评论 RSS 源的链接。自版本 2.2.0 起,建议使用 get_post_comments_feed_link() 替代。

关键要点

  • 函数功能:返回文章评论 RSS 源的链接。
  • 弃用状态:自 WordPress 2.2.0 版本起被弃用,应改用 get_post_comments_feed_link()。
  • 返回值:字符串类型,经过 esc_url() 清理的 URL。
  • 相关函数:内部调用 get_post_comments_feed_link() 和 _deprecated_function()。

代码示例

function comments_rss() {
    _deprecated_function( __FUNCTION__, '2.2.0', 'get_post_comments_feed_link()' );
    return esc_url( get_post_comments_feed_link() );
}

注意事项

  • 在开发新代码时,避免使用此函数,以遵循 WordPress 最佳实践和兼容性。
  • 如果维护旧代码,应考虑迁移到 get_post_comments_feed_link() 以消除弃用警告。

📄 原文内容

Return link to the post RSS feed.

Description

See also

Return

string

Source

function comments_rss() {
	_deprecated_function( __FUNCTION__, '2.2.0', 'get_post_comments_feed_link()' );
	return esc_url( get_post_comments_feed_link() );
}

Changelog

Version Description
2.2.0 Deprecated. Use get_post_comments_feed_link()
1.5.0 Introduced.