wp cap

Додає, видаляє та перераховує можливості ролі користувача.

Приклади

# Додати можливість 'spectate' ролі 'author'.
$ wp cap add author spectate
Success: Added 1 capability to 'author' role.

# Add all caps from 'editor' role to 'author' role.
$ wp cap list editor | xargs wp cap add author
Success: Added 24 capabilities to 'author' role.

# Remove all caps from 'editor' role that also appear in 'author' role.
$ wp cap list 'author' | xargs wp cap remove 'editor'
Success: Removed 34 capabilities з 'editor' role.

Вихідний код команд

• wp-cli/role-command
  • Capabilities_Command.php

wp cap list

Відображає можливості цієї ролі.

Використання

wp cap list {role} [--format={format}] [--show-grant]

{role}

Назва ролі, наприклад,
administrator .

[–format={format}]

У якому форматі вивести дані?

Може приймати значення
list ,
table ,
csv ,
json ,
count ,
yaml .

Типово: list

[–show-grant]

Відображати додатково інформацію про те, чи дозволено ролі виконувати ту чи іншу можливість.

Типово: false

Приклади

# Відобразимо перелік можливостей ролі contributor (учасника).
$ wp cap list 'contributor'
/*
edit_posts
read
level_1
level_0
delete_posts
read_blocks
*/

# Теж саме, але з параметром show-grant
$ wp cap list 'contributor' --show-grant=true
/*
edit_posts,true
read,true
level_1,true
level_0,true
delete_posts,true
read_blocks,true
*/

# Теж саме, плюс формат відображення table (таблиця)
$ wp cap list 'contributor' --format=table --show-grant=true
/*
+--------------+-------+
| name | grant |
+--------------+-------+
| edit_posts | true |
| read | true |
| level_1 | true |
| level_0 | true |
| delete_posts | true |
| read_blocks | true |
+--------------+-------+
*/

# Відобразимо можливості неіснуючої ролі my_unknown_role
$wp cap list 'my_unknown_role'
/*
Error: 'my_unknown_role' role not found.
*/

wp cap add

Додає можливості вказаної ролі. Працює на основі WP_Roles::add_cap() .

Використання

wp cap add {role} {cap}... [--grant]

{role}

Ключ ролі, наприклад
administrator ,
editor ,
author ,
contributor ,
subscriber і так далі.

{cap}…

Назва однієї можливості або кількох через пробіл.
Таблиця з ролями та їх можливостями за умовчанням .

[–grant]

Чи може ця роль користуватися зазначеною можливістю. Тобто. дозволити виконувати цю можливість (true) чи навпаки заборонити (false).

Типово: true

Приклади

# Додамо можливість 'my_cap_1' для ролі 'author'.
$ wp cap add author my_cap_1
Success: Added 1 capability to 'author' role.

# Повторимо операцію і отримаємо у відповідь у лічильнику нуль, оскільки така роль вже була додана раніше.
$ wp cap add author my_cap_1
Success: Added 0 capability to 'author' role.

# Додамо кілька можливостей для ролі 'administrator'.
$ wp cap add administrator my_cap_1 my_cap_2 my_cap_3
Success: Added 3 capability to 'administrator' role.

# Спробуємо додати неіснуючої ролі нову можливість
$ wp cap add aut111hor my_cap_1
Error: 'aut111hor' role not found.

wp cap remove

Видаляє можливості у зазначеної ролі. Працює на основі WP_Roles::remove_cap() .

Використання

wp cap remove {role} {cap}...

{role}

Ключ ролі, наприклад
administrator ,
editor ,
author ,
contributor ,
subscriber і так далі.

{cap}…

Назва однієї можливості або кількох через пробіл.
Таблиця з ролями та їх можливостями за умовчанням .

Приклади

# Нехай у ролі 'author' є можливість 'my_cap_1'. Видалимо її.
$ wp cap remove author my_cap_1
Success: Removed 1 capability від 'author' role.

Теж саме, але якщо треба було б видалити кілька можливостей.
$ wp cap remove author my_cap_1 my_cap_2 my_cap_3
Success: Removed 3 capability from 'author' role.

# Повторимо попередню операцію.
$ wp cap remove author my_cap_1 my_cap_2 my_cap_3
Success: Removed 0 capability from 'author' role.

# Спробуємо видалити у ролі 'author' неіснуючу можливість 'my_cap_777'
$ wp cap remove author my_cap_777
Success: Removed 0 capability from 'author' role.

# Спробуємо видалити у неіснуючої ролі можливість my_cap_1 (або іншу).
$ wp cap remove aut111hor my_cap_1
Error: 'aut111hor' role not found.