README

Yii2 用户模块

用户管理模块

此模块是 Butterfly.СMS 内容管理系统的一个组成部分，但也可以作为独立的扩展使用。

版权所有 (c) 2019-2023 W.D.M.Group, Ukraine

要求

• PHP 5.6 或更高版本
• Yii2 v.2.0.40 和最新版本
• Yii2 Base 模块（必需）

安装

要在控制台中安装模块，请运行以下命令

$ composer require "wdmg/yii2-users"

配置数据库连接后，在控制台中运行以下命令

$ php yii users/init

然后选择您要执行的操作

1. 应用所有模块迁移
2. 撤销所有模块迁移
3. 批量插入演示数据^*

* - 演示数据库包含6个演示用户

迁移

无论如何，您都可以执行迁移并创建初始数据，在控制台中运行以下命令

$ php yii migrate --migrationPath=@vendor/wdmg/yii2-users/migrations

配置

要将模块添加到项目中，请在配置文件中添加以下数据

'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',
            ],
        ],
        'multiSignIn' => true,
        'sessionTimeout' => 0, // where `0` is unlimited
    ],
    ...
],

使用方法

有关更多详细信息，请参阅 USECASES.md

路由

使用模块的 Module::dashboardNavItems() 方法生成导航项列表，例如

<?php
    echo Nav::widget([
    'options' => ['class' => 'navbar-nav navbar-right'],
        'label' => 'Modules',
        'items' => [
            Yii::$app->getModule('users')->dashboardNavItems(),
            ...
        ]
    ]);
?>

状态和版本 [准备就绪]

• v.1.2.7 - 修复了身份验证，增加了用户选项
• v.1.2.6 - 修复了版权和 getUserId()
• v.1.2.5 - 修复：语法错误，未预期的 '::' (T_PAAMAYIM_NEKUDOTAYIM)
• v.1.2.4 - 多次登录和注销由会话超时引起