wp cap
Додає, видаляє та перераховує можливості ролі користувача.
Дивіться також команду wp role .
Список команд | Опис |
---|---|
wp cap list | Відображає можливості цієї ролі. |
wp cap add | Додає можливості вказаної ролі. Працює на основі WP_Roles::add_cap() . |
wp cap remove | Видаляє можливості у зазначеної ролі. Працює на основі WP_Roles::remove_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 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.