函数文档

the_author_nickname()

💡 云策文档标注

概述

the_author_nickname() 是一个已弃用的 WordPress 函数,用于显示当前文章作者的昵称。自 2.8.0 版本起,建议改用 the_author_meta('nickname') 来实现相同功能。

关键要点

  • the_author_nickname() 函数已弃用,自 WordPress 2.8.0 版本起不推荐使用。
  • 替代方案是使用 the_author_meta('nickname') 来输出作者的昵称。
  • 函数内部调用 _deprecated_function() 来标记弃用状态,并在使用时发出通知。
  • 该函数最初在 0.71 版本引入,相关代码位于 wp-includes/author-template.php。

代码示例

function the_author_nickname() {
    _deprecated_function( __FUNCTION__, '2.8.0', 'the_author_meta('nickname')' );
    the_author_meta('nickname');
}

注意事项

  • 在开发新主题或插件时,应避免使用 the_author_nickname(),改用 the_author_meta('nickname') 以确保兼容性和最佳实践。
  • 如果现有代码中使用了此函数,建议尽快更新以避免未来版本可能出现的兼容性问题。

📄 原文内容

Display the nickname of the author of the current post.

Description

See also

Source

function the_author_nickname() {
	_deprecated_function( __FUNCTION__, '2.8.0', 'the_author_meta('nickname')' );
	the_author_meta('nickname');
}

Changelog

Version Description
2.8.0 Deprecated. Use the_author_meta()
0.71 Introduced.