kuzmiand/yii2-users

Module for manage users and their rights with the support of registration through social services and assigned to each user more than one social service.

Yii2-users

Module for management users and their rights with the support of registration via social services and assigned to each user more than one social service., _(*1)

Abilities

User registration and authorization by e-mail and via social networks with the ability to bind several different social networking accounts to a one account on the your site

, _(*2)

Changing password

, _(*3)

Recovering password

, _(*4)

Changing e-mail. Confirmation will be sent to the old and new address

, _(*5)

Editinig profile

, _(*6)

Administation module for manage users

, _(*7)

Editing RBAC structure and user rights via the GUI

, _(*8)

, _(*9)

Installation

The preferred way to install this extension is through composer., _(*10)

Either run, _(*11)

php composer.phar require --prefer-dist kuzmiand/yii2-users "*"

or add, _(*12)

"kuzmiand/yii2-users": "*"

to the require section of your composer.json file., _(*13)

Config

'user' => [
    'identityClass' => 'kuzmiand\users\models\User',
    'enableAutoLogin' => true,
    'loginUrl' => ['/login'],
],
'authClientCollection' => [
    'class' => 'yii\authclient\Collection',
    'clients' => [
        'vkontakte' => [
            'class' => 'kuzmiand\users\components\oauth\VKontakte',
            'clientId' => 'XXX',
            'clientSecret' => 'XXX',
            'scope' => 'email'
        ],
        'google' => [
            'class' => 'kuzmiand\users\components\oauth\Google',
            'clientId' => 'XXX',
            'clientSecret' => 'XXX',
        ],
        'facebook' => [
            'class' => 'kuzmiand\users\components\oauth\Facebook',
            'clientId' => 'XXX',
            'clientSecret' => 'XXX',
        ],
        'github' => [
            'class' => 'kuzmiand\users\components\oauth\GitHub',
            'clientId' => 'XXX',
            'clientSecret' => 'XXX',
            'scope' => 'user:email, user'
        ],
        'linkedin' => [
            'class' => 'kuzmiand\users\components\oauth\LinkedIn',
            'clientId' => 'XXX',
            'clientSecret' => 'XXX',
        ],
        'live' => [
            'class' => 'kuzmiand\users\components\oauth\Live',
            'clientId' => 'XXX',
            'clientSecret' => 'XXX',
        ],
        'yandex' => [
            'class' => 'kuzmiand\users\components\oauth\Yandex',
            'clientId' => 'XXX',
            'clientSecret' => 'XXX',
        ],
        'twitter' => [
            'class' => 'kuzmiand\users\components\oauth\Twitter',
            'consumerKey' => 'XXX',
            'consumerSecret' => 'XXX',
        ],
    ],
],
'urlManager' => [
    'enablePrettyUrl' => true,
    'showScriptName' => false,
    'rules' => [
        '/signup' => '/user/user/signup',
        '/login' => '/user/user/login',
        '/logout' => '/user/user/logout',
        '/requestPasswordReset' => '/user/user/request-password-reset',
        '/resetPassword' => '/user/user/reset-password',
        '/profile' => '/user/user/profile',
        '/retryConfirmEmail' => '/user/user/retry-confirm-email',
        '/confirmEmail' => '/user/user/confirm-email',
        '/unbind/<id:[\w\-]+>' => '/user/auth/unbind',
        '/oauth/<authclient:[\w\-]+>' => '/user/auth/index'
    ],
],
'authManager' => [
    'class' => 'yii\rbac\DbManager',
],

'modules' => [
    'user' => [
        'class' => 'kuzmiand\users\Module',
        'userPhotoUrl' => 'http://example.com/uploads/user/photo',
        'userPhotoPath' => '@frontend/web/uploads/user/photo'
    ],
],

Instead of XXX, you have to use yours values. To receive them, you must create applications on the social networks., _(*14)

If you are using advanced template and Yandex client, then you have to add authClientCollection in configurations for frontend and backend applications. However Yandex client should be added to only one of the applications. The reason for this is that Yandex one application can work with only one domain, you can not add two different Callback URL on different domains., _(*15)

Not all services returns all user data. Some of the data get the default settings, if the service does not return them., _(*16)

Database migrations

yii migrate/up --migrationPath=@vendor/kuzmiand/yii2-users/migrations, _(*17)

This migration create all necessary for the operation of the module tables and two users:, _(*18)

Usage

in main layout:, _(*19)

use kuzmiand\users\components\AuthorizationWidget;

<?= AuthorizationWidget::widget() ?>

Signup: http://example.com/signup, _(*20)

Profile: http://example.com/profile, _(*21)

Restore password: http://example.com/requestPasswordReset, _(*22)

Manage users: http://example.com/user/admin, _(*23)

Manage RBAC: http://example.com/user/rbac, _(*24)

Custom views and email templates

If you want use custom views and email templates you can override their in config. For example:, _(*25)

'modules' => [
    'user' => [
        'class' => 'kuzmiand\users\Module',
        'customViews' => [
            'login' => '@app/views/site/login'
        ],
        'customMailViews' => [
            'confirmChangeEmail' => '@app/mail/confirmChangeEmail' //in this case you have to create files confirmChangeEmail-html.php and confirmChangeEmail-text.php in mail folder
        ]
    ],
],

You can override all views from vendor\kuzmiand\yii2-users\views\user and vendor\kuzmiand\yii2-users\mail folders., _(*26)