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
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. |