apply_filters( ‘editable_roles’, array[] $all_roles )

User Contributed Notes

1. Skip to note 3 content

   Steven Lin 4 years ago

   You must log in to vote on the helpfulness of this noteVote results for this note: 0You must log in to vote on the helpfulness of this note

   Example migrated from Codex:

   Filter out roles with levels higher than the current user’s:

   add_filter('editable_roles', 'remove_higher_levels');
   
   <?php
   function remove_higher_levels($all_roles) {
       $user = wp_get_current_user();
       $next_level = 'level_' . ($user->user_level + 1);
   
       foreach ( $all_roles as $name => $role ) {
           if (isset($role['capabilities'][$next_level])) {
               unset($all_roles[$name]);
           }
       }
   
       return $all_roles;
   }
2. Skip to note 4 content

   Steven Lin 4 years ago

   You must log in to vote on the helpfulness of this noteVote results for this note: 0You must log in to vote on the helpfulness of this note

   Example migrated from Codex:

   Add a “No role” option that sets users’ roles to nothing on pages other than the user profile screen (where it already exists):

   add_filter('editable_roles', 'add_empty_editable_role');
   
   <?php
   function add_empty_editable_role($all_roles) {
       $screen = get_current_screen();
   
       if (! (isset($all_roles['']) || 'user-edit' == $screen->id)) {
           $all_roles[''] = array(
               'name' => __('— No role for this site —'),
               'capabilities' => array(),
               );
       }
   
       return $all_roles;
   }