函数文档

user_can_edit_post_comments()

💡 云策文档标注

概述

user_can_edit_post_comments() 是一个已弃用的 WordPress 函数,用于检查指定用户是否可以编辑特定文章的评论。它已被 current_user_can() 替代,内部调用 user_can_edit_post() 实现功能。

关键要点

  • 函数已弃用:自 WordPress 2.0.0 起,建议使用 current_user_can() 替代。
  • 功能逻辑:如果用户能编辑文章,则默认可以编辑该文章的评论。
  • 参数:接受 $user_id(必需)、$post_id(必需)和 $blog_id(可选,默认 1)。
  • 返回值:布尔值,表示用户是否有编辑评论的权限。

代码示例

function user_can_edit_post_comments($user_id, $post_id, $blog_id = 1) {
    _deprecated_function( __FUNCTION__, '2.0.0', 'current_user_can()' );
    return user_can_edit_post($user_id, $post_id, $blog_id);
}

注意事项

  • 此函数标记为弃用,使用时会触发 _deprecated_function() 警告。
  • 相关函数:user_can_edit_post() 和 user_can_delete_post_comments() 也位于 deprecated.php 文件中。

📄 原文内容

Whether user can delete a post.

Description

See also

Parameters

$user_idintrequired
$post_idintrequired
$blog_idintoptional
Not Used

Default:1

Return

bool returns true if $user_id can edit $post_id’s comments

Source

function user_can_edit_post_comments($user_id, $post_id, $blog_id = 1) {
	_deprecated_function( __FUNCTION__, '2.0.0', 'current_user_can()' );

	// Right now if one can edit a post, one can edit comments made on it.
	return user_can_edit_post($user_id, $post_id, $blog_id);
}

Changelog

Version Description
2.0.0 Deprecated. Use current_user_can()
1.5.0 Introduced.