Users management module
This module is an integral part of the Butterfly.СMS content management system, but can also be used as an standalone extension.
Copyrights (c) 2019-2020 W.D.M.Group, Ukraine
- PHP 5.6 or higher
- Yii2 v.2.0.35 and newest
- Yii2 Base module (required)
To install the module, run the following command in the console:
$ composer require "wdmg/yii2-users"
After configure db connection, run the following command in the console:
$ php yii users/init
And select the operation you want to perform:
- Apply all module migrations
- Revert all 866E module migrations
- Batch insert demo data*
* - The demo database contains 6 demo user`s with:
| ID | Username | Password | Status | |
|---|---|---|---|---|
| 100 | admin | admin | admin@example.com | active |
| 101 | demo | demo | demo@example.com | inactive |
| 102 | alice | alice | alice@example.com | inactive |
| 103 | bob | bob | bob@example.com | inactive |
| 104 | johndoe | johndoe | johndoe@example.com | inactive |
| 105 | janedoe | janedoe | janedoe@example.com | inactive |
In any case, you can execute the migration and create the initial data, run the following command in the console:
$ php yii migrate --migrationPath=@vendor/wdmg/yii2-users/migrations
To add a module to the project, add the following data in your configuration file:
'components' => [
'user' => [
'identityClass' => 'wdmg\users\models\Users',
],
...
],
'modules' => [
'users' => [
'class' => 'wdmg\users\Module',
'routePrefix' => 'admin',
'rememberDuration' => (3600 * 24 * 30),
'signupConfirmation' => [
'needConfirmation' => false,
'checkTokenRoute' => 'site/signup-confirm',
'supportEmail' => 'noreply@example.com',
'emailViewPath' => [
'html' => '@vendor/wdmg/yii2-users/mail/signupConfirmation-html',
'text' => '@vendor/wdmg/yii2-users/mail/signupConfirmation-text',
],
],
'passwordReset' => [
'resetTokenExpire' => 3600,
'checkTokenRoute' => 'site/reset-password',
'supportEmail' => 'noreply@example.com',
'emailViewPath' => [
'html' => '@vendor/wdmg/yii2-users/mail/passwordReset-html',
'text' => '@vendor/wdmg/yii2-users/mail/passwordReset-text',
],
],
],
...
],
See the USECASES.md for more details.
Use the Module::dashboardNavItems() method of the module to generate a navigation items list for NavBar, like this:
<?php
echo Nav::widget([
'options' => ['class' => 'navbar-nav navbar-right'],
'label' => 'Modules',
'items' => [
Yii::$app->getModule('users')->dashboardNavItems(),
...
]
]);
?>
- v.1.2.2 - Bugfix when RestAPI request
- v.1.2.1 - Bugfix when save user password
- v.1.2.0 - Users online, filter by role, assign/revoke user role, add/update user info
- v.1.1.8 - Added pagination, up to date dependencies
- v.1.1.7 - Fixed deprecated class declaration
- v.1.1.6 - Added extra options to composer.json and navbar menu icon
- v.1.1.5 - Added choice param for non interactive mode