Освоение ролей и возможностей WordPress

 add_action('init', function() { if (current_user_can('install_plugins')) { echo 'you can install plugins'; } else { echo 'You cannot install plugins'; } }); 

WP_User :: has_cap

Проверяет, принадлежит ли конкретный пользователь возможности.

 add_action('init', function() { $user = get_user_by('slug', 'admin'); if ($user->has_cap('install_plugins')) { echo 'Admin can install plugins'; } else { echo 'Admin cannot install plugins'; } }); 

Мы можем заметить, что current_user_can использует эту функцию.

get_editable_roles ()

Возвращает доступные роли.

 add_action('admin_init', function() { $roles = get_editable_roles(); var_dump($roles); }); 

Список может быть переопределен фильтром editable_roles , поэтому мы не должны полагаться на эту функцию для получения полного списка ролей на веб-сайте.

Обратите внимание на использование admin_init , так как функция еще не загружена в init .

get_role ()

Получает объект WP_Role из его слаг.

 add_action('init', function() { $role = get_role('administrator'); var_dump($role); }); // This will print: // WP_Role Object // ( // [name] => administrator // [capabilities] => Array // ( // [switch_themes] => 1 // [edit_themes] => 1 // [activate_plugins] => 1 // [edit_plugins] => 1 // [...] 

WP_Role :: has_cap ()

Проверяет, обладает ли роль необходимыми возможностями.

 add_action('init', function() { $role = get_role('administrator'); var_dump($role->has_cap('install_plugins')); // Prints TRUE }); 

Настройка API

WordPress также предлагает полный API для настройки ролей и их возможностей.

add_role ()

Регистрирует новую роль в базе данных.

 add_action('init', function() { add_role('plugins_manager', 'Plugins Manager', array( 'install_plugins', 'activate_plugins', 'edit_plugins' )); }); 

remove_role ()

Удаляет требуемую роль из базы данных, если она существует.

 add_action('init', function() { remove_role('plugins_manager'); }); 

WP_Role :: add_cap ()

Добавляет возможность к роли.

 add_action('init', function() { $role = get_role('contributor'); $role->add_cap('install_plugins'); }); 

Это может быть базовая возможность ( install_plugins , edit_posts ,…) или любая пользовательская строка ( my_awesome_plugin_cap ).

Это позволяет нам регистрировать столько пользовательских возможностей, сколько нам нужно для наших плагинов.

 add_action('init', function() { $role = get_role('contributor'); $role->remove_cap('install_plugins'); }); 

 add_action('init', function() { $user = get_user_by('slug', 'admin'); $user->add_role('contributor'); }); 

 add_action('init', function() { $user = get_user_by('slug', 'admin'); $user->remove_role('administrator'); }); 

 add_action('init', function() { $user = get_user_by('slug', 'admin'); $user->add_cap('my_custom_cap'); }); 

 add_action('init', function() { $user = get_user_by('slug', 'admin'); $user->remove_cap('my_custom_cap'); }); 

 add_action('init', function() { add_role('plugins_manager', 'Plugins Manager', array()); }); 

 public function add_role( $role, $display_name, $capabilities = array() ) { if ( isset( $this->roles[$role] ) ) return; 

 add_action('init', function() { $role = get_role('plugins_manager'); $role->add_cap('install_plugins'); }); 

 public function add_cap( $role, $cap, $grant = true ) { if ( ! isset( $this->roles[$role] ) ) return; $this->roles[$role]['capabilities'][$cap] = $grant; if ( $this->use_db ) update_option( $this->role_key, $this->roles ); } 

 /* Plugin Name: Our sample role plugin */ register_activation_hook(__FILE__, function() { $role = add_role('plugins_manager', 'Plugins Manager', array()); $role->add_cap('install_plugins'); }); 

 protected function _init() { global $wpdb, $wp_user_roles; $this->role_key = $wpdb->get_blog_prefix() . 'user_roles'; if ( ! empty( $wp_user_roles ) ) { $this->roles = $wp_user_roles; $this->use_db = false; } else { $this->roles = get_option( $this->role_key ); } 

 /* Plugin Name: Our sample role plugin */ $GLOBALS['wp_user_roles'] = array( 'administrator' => array( 'name' => 'Administrator', 'capabilities' => array( 'activate_plugins' => true, 'read' => true, ) ) );