函数文档

user_can_set_post_date()

💡 云策文档标注

概述

user_can_set_post_date() 是一个已弃用的 WordPress 函数,用于检查用户是否有权限设置新文章的日期。自 2.0.0 版本起,建议使用 current_user_can() 替代。

关键要点

  • 函数已弃用:自 WordPress 2.0.0 起,应改用 current_user_can() 进行权限检查。
  • 功能:检查指定用户是否能够设置新文章的发布日期。
  • 参数:接受 $user_id(必需)、$blog_id(可选,默认 1)和 $category_id(必需,但未使用)。
  • 返回值:返回布尔值,表示用户是否有权限。
  • 内部逻辑:基于用户级别大于 4 且用户能创建文章(通过 user_can_create_post())来判断。

代码示例

function user_can_set_post_date($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 > 4) && user_can_create_post($user_id, $blog_id, $category_id));
}

注意事项

  • 此函数已弃用,不建议在新代码中使用,以避免兼容性问题。
  • 参数 $blog_id 和 $category_id 在函数中未实际使用,但需按签名传递。
  • 依赖 user_can_create_post() 和 get_userdata() 函数,确保这些函数可用。

📄 原文内容

Whether user can set new posts’ dates.

Description

See also

Parameters

$user_idintrequired
$blog_idintoptional
Not Used

Default:1

$category_idintrequired
Not Used

Return

bool

Source

function user_can_set_post_date($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 > 4) && user_can_create_post($user_id, $blog_id, $category_id));
}

Changelog

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