函数文档

user_can_create_draft()

💡 云策文档标注

概述

user_can_create_draft() 是一个已弃用的 WordPress 函数,用于检查指定用户是否有权限创建草稿文章。自 2.0.0 版本起,建议使用 current_user_can() 替代。

关键要点

  • 函数已弃用:自 WordPress 2.0.0 起,应改用 current_user_can() 进行权限检查。
  • 参数说明:接受 $user_id(必需)、$blog_id(可选,默认 1,未使用)和 $category_id(必需,未使用)。
  • 返回值:返回布尔值,基于用户级别(user_level >= 1)判断是否有创建权限。
  • 相关函数:涉及 get_userdata() 获取用户信息和 _deprecated_function() 标记弃用。

代码示例

function user_can_create_draft($user_id, $blog_id = 1, $category_id = 'None') {
    _deprecated_function( __FUNCTION__, '2.0.0', 'current_user_can()' );
    $author_data = get_userdata($user_id);
    return ($author_data->user_level >= 1);
}

注意事项

  • 此函数已弃用,新代码中应避免使用,改用 current_user_can() 以确保兼容性和最佳实践。
  • 参数 $blog_id 和 $category_id 在函数中未实际使用,仅保留为历史兼容性。

📄 原文内容

Whether user can create a post.

Description

See also

Parameters

$user_idintrequired
$blog_idintoptional
Not Used

Default:1

$category_idintrequired
Not Used

Return

bool

Source

function user_can_create_draft($user_id, $blog_id = 1, $category_id = 'None') {
	_deprecated_function( __FUNCTION__, '2.0.0', 'current_user_can()' );

	$author_data = get_userdata($user_id);
	return ($author_data->user_level >= 1);
}

Changelog

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