专注国内外云服务器
分享建站技术教程

WordPress功能函数add_role()

立即购买

阿里云服务器 ¥102元/年 云数据库37.5元/年 限时

个人、企业均可购买 | 更多配置0.8折特惠

吾上云WORDPRESS教程最新“WordPress功能函数add_role()”

WordPress功能函数add_role(),如果角色不存在,请添加角色。

参数:

$role

(string) (必需) 角色的名字。

$display_name

(string) (必需) 显示角色的名称。

$capabilities

(bool[]) (可选) 按能力名称键的能力列表,例如array(‘edit_posts’ => true, ‘delete_posts’ => false)。

默认值: array()

返回

(WP_Role|null) 如果添加了role,则为WP_Role对象,如果已经存在,则为空。

来源:

文件: wp-includes/capabilities.php

function add_role( $role, $display_name, $capabilities = array() ) {

if ( empty( $role ) ) {

return;

}

return wp_roles()->add_role( $role, $display_name, $capabilities );

}

更新日志:

用户贡献的笔记

(由Roger Theriault贡献- 2年前)

请确保仅在激活钩子或条件块中使用此函数(和类似的角色函数)。不需要在每次加载页面时都执行它,并且每次调用它时都会更新数据库。

例如,这将存储一个选项来跟踪自定义角色的版本,并且只更新一次数据库:

function xx__update_custom_roles() {

if ( get_option( ‘custom_roles_version’ )

add_role( ‘custom_role’, ‘Custom Subscriber’, array( ‘read’ => true, ‘level_0’ => true ) );

update_option( ‘custom_roles_version’, 1 );

}

}

add_action( ‘init’, ‘xx__update_custom_roles’ );

  (由Jules Colle于1年前贡献)

您还可以根据现有的用户角色轻松地创建新的用户角色。

(等同于WP CLI: WP role create ——clone=)

示例:创建具有Administrator权限的角色“supervisor”

add_role( ‘superintendent’, ‘Superintendent’, get_role( ‘administrator’ )->capabilities );

  (由Codex – 5年前贡献)

当一个插件被激活时,创建一个新的角色

看到register_activation_hook。

function add_roles_on_plugin_activation() {

add_role( ‘custom_role’, ‘Custom Subscriber’, array( ‘read’ => true, ‘level_0’ => true ) );

}

register_activation_hook( __FILE__, ‘add_roles_on_plugin_activation’ );

  (由Codex – 5年前贡献)

例子

创建一个新的“客座作者”角色。

$result = add_role(

‘guest_author’,

__( ‘Guest Author’, ‘testdomain’ ),

array(

‘read’ => true, // true allows this capability

‘edit_posts’ => true,

‘delete_posts’ => false, // Use false to explicitly deny

)

);

if ( null !== $result ) {

echo “Success: {$result->name} user role created.”;

}

else {

echo ‘Failure: user role already exists.’;

}

  (由Codex – 5年前贡献)

注意:什么时候打电话

在尝试添加或修改角色之前,请确保全局$wp_roles可用。最佳实践是使用一个插件(或主题)激活钩子来更改角色(因为您只希望这样做一次!)

mu-plugins加载得太早了,所以如果你在mu-plugin的上下文中这样做的话,可以使用一个action钩子(比如’init’)来封装你的add_role()调用。
  
  (由Codex – 5年前贡献)

备注:删除已存在的角色

不能使用add_role()更改现有角色的功能。这个函数将停止执行,如果指定的角色名已经存在,则返回null。

可以通过使用remove_role(),然后使用add_role()来更改用户角色的功能(或显示名称)。

这只是为了发展。一旦确定了功能列表,就不需要保留remove_role()代码。

  (由Codex – 5年前贡献)

使用

文章来源于互联网WORDPRESS教程:WordPress功能函数add_role(),
阿里云服务器89元起,点击购买
腾讯云服务器95元/年起 点击购买

相关推荐: 初学者如何搭建一个网站(2021建站入门指南)

不要误以为需要成为网站设计师或开发人员才能搭建一个网站。有许多工具在您无编写任何代码能力下也能够帮助您快速建站。 在本教程中,我们将会简单地说明,在2021年我们可以选择哪些方式建站,作为初学者的一个入门指南。 使用Website Builder建站 许多初学…

赞(0)
未经允许不得转载:吾上云 » WordPress功能函数add_role()
分享到: 更多 (0)
  • 阿里云
    基础型云服务器

    1核CPU

    2G内存

    40G硬盘

    1M带宽

    独立IP

    分布式存储

    适合企业官网、个人站长类网站

    ¥89/1年 原价¥903.40

  • 阿里云
    超值型云服务器

    2核CPU

    4G内存

    40G硬盘

    3M带宽

    独立IP

    分布式存储

    适合企业官网、行业门户类网站

    ¥899/3年 原价¥8281

  • 阿里云
    高性能云服务器

    2核CPU

    8G内存

    40G硬盘

    5M带宽

    独立IP

    分布式存储

    适合电商、数据库等企业级应用

    ¥1399/3年¥14765

  • 腾讯云
    基础型云服务器

    1核CPU

    2G内存

    50G硬盘

    1M带宽

    独立IP

    分布式存储

    适合企业官网、个人站长类网站

    ¥95/1年 原价¥834

  • 腾讯云
    超值型云服务器

    1核CPU

    2G内存

    50G硬盘

    1M带宽

    独立IP

    分布式存储

    适合企业官网、行业门户类网站

    ¥288/3年 原价¥2502

  • 腾讯云
    高性能云服务器

    4核CPU

    8G内存

    50G硬盘

    5M带宽

    独立IP

    分布式存储

    适合电商、数据库等企业级应用

    ¥2188/3年¥13986

  • 阿里云
    基础型云服务器

    1核CPU

    2G内存

    40G硬盘

    1M带宽

    独立IP

    分布式存储

    适合企业官网、个人站长类网站

    ¥89/1年 原价¥903.40

  • 阿里云
    超值型云服务器

    2核CPU

    4G内存

    40G硬盘

    3M带宽

    独立IP

    分布式存储

    适合企业官网、行业门户类网站

    ¥899/3年 原价¥8281

  • 阿里云
    高性能云服务器

    2核CPU

    8G内存

    40G硬盘

    5M带宽

    独立IP

    分布式存储

    适合电商、数据库等企业级应用

    ¥1399/3年¥14765

  • 腾讯云
    基础型云服务器

    1核CPU

    2G内存

    50G硬盘

    1M带宽

    独立IP

    分布式存储

    适合企业官网、个人站长类网站

    ¥95/1年 原价¥834

  • 腾讯云
    超值型云服务器

    1核CPU

    2G内存

    50G硬盘

    1M带宽

    独立IP

    分布式存储

    适合企业官网、行业门户类网站

    ¥288/3年 原价¥2502

  • 腾讯云
    高性能云服务器

    4核CPU

    8G内存

    50G硬盘

    5M带宽

    独立IP

    分布式存储

    适合电商、数据库等企业级应用

    ¥2188/3年¥13986

评论 抢沙发

评论前必须登录!

 

吾上云 专注服务器选购

购买云服务器联系我们