WP_User::add_role() – Adds role to user.

You appear to be a bot. Output may be restricted

Description

Adds role to user.

Updates the user's meta data option with capabilities and roles.

Usage

WP_User::add_role( $role );

Parameters

$role
( string ) required – Role name.

Returns

void

Source

File name: wordpress/wp-includes/class-wp-user.php
Lines:

1 to 24 of 24
  public function add_role( $role ) {
    if ( empty( $role ) ) {
      return;
    }

    if ( in_array( $role, $this->roles, true ) ) {
      return;
    }

    $this->caps[ $role ] = true;
    update_user_meta( $this->ID, $this->cap_key, $this->caps );
    $this->WP_User::get_role_caps();
    $this->WP_User::update_user_level_from_caps();

    
/**
 * Fires immediately after the user has been given a new role.
 *
 * @since 4.3.0
 *
 * @param int    $user_id The user ID.
 * @param string $role    The new role.
 */
    do_action( 'add_user_role', $this->ID, $role );
  }
 

 View on GitHub View on Trac