First steps to use Yii2-usuario

After installing the extension and having configured everything, you need setup your application with the all the user related stuff, e.g.

creating first users, roles, permissions, ...
assigning permissions and roles to users
extending your controllers with access restrictions
starting user management

Creating your first user

There are several ways to do that:

using migrations
using the Command line Console Commands

Creating the first Administrator during a migration

This is helpful e.g. when using you Yii2 applicatio with Docker and need to start the Docker Container with basic user settings.

We will create an adminuser with a adminisrator role.

Put this in your migration:

class m... extends Migration
{
    public function safeUp()
    {
        $auth = Yii::$app->authManager;
            
        // create a role named "administrator"
        $administratorRole = $auth->createRole('administrator');
        $administratorRole->description = 'Administrator';
        $auth->add($administratorRole);

        // create user "admin" with password "verysecret"
        $user = new \Da\User\Model\User([
            'scenario' => 'create', 
            'email' => "email@example.com", 
            'username' => "admin", 
            'password' => "verysecret"  // >6 characters!
        ]);
        $user->confirmed_at = time();
        $user->save();
        
        // assign role to our admin-user
        $auth->assign($administratorRole, $user->id);
    }

    public function safeDown()
    {
        $auth = Yii::$app->authManager;

        // delete admin-user and administrator role
        $administratorRole = $auth->getRole("xw-administrator");
        $user = \Da\User\Model\User::findOne(['name'=>"admin"]);
        $auth->revoke($administratorRole, $user->id);
        $user->delete();
    }

User Management

Having setup the admin user you can start using user management at

http://yourapp/index.php?r=user/admin

You should be prompted a login screen and the enter admin/verysecret.

2.5 KiB Raw Blame History

First steps to use Yii2-usuario

Creating your first user

Creating the first Administrator during a migration

User Management

Recommended Reading

2.5 KiB

Raw Blame History