WP_Role::add_cap( string $cap, bool $grant = true )

User Contributed Notes

1. Skip to note 3 content

   Codex 10 years ago

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

   Example

   function add_theme_caps() {
   	// gets the author role
   	$role = get_role( 'author' );
   
   	// This only works, because it accesses the class instance.
   	// would allow the author to edit others' posts for current theme only
   	$role->add_cap( 'edit_others_posts' ); 
   }
   add_action( 'admin_init', 'add_theme_caps');

   NB: This setting is saved to the database, so it might be better to run this on theme/plugin activation

   function add_theme_caps(){
   	 global $pagenow;
   
   	 if ( 'themes.php' == $pagenow && isset( $_GET['activated'] ) ){ // Test if theme is active
   		 // Theme is active
   		 // gets the author role
   		 $role = get_role( 'author' );
   
   		 // This only works, because it accesses the class instance.
   		 // would allow the author to edit others' posts for current theme only
   		 $role->add_cap( 'edit_others_posts' ); 
   	 } else {
   		 // Theme is deactivated
   		 // Remove the capacity when theme is deactivate
   		 $role->remove_cap( 'edit_others_posts' ); 
   	 }
   }
   add_action( 'load-themes.php', 'add_theme_caps' );

   To add capability to specific user :

   $user = new WP_User( $user_id );
   $user->add_cap( 'can_edit_posts' );
2. Skip to note 4 content

   Will Skora 5 years ago

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

   Note that add_cap only accept one string; you cannot add multiple using a single add_cap call; you need to make multiple add_cap calls like the following:

   
$your_var -> add_cap( 'edit_others_posts' );
$your_var -> add_cap( 'upload_files' );