- Change Log.
- Authorization Guide. Important, read this first before continue.
- Basic Usage.
- Using Menu.
- Api
The preferred way to install this extension is through composer.
Either run
php composer.phar require mdmsoft/yii2-admin "~1.0"
for dev-master
php composer.phar require mdmsoft/yii2-admin "dev-master"
or add
"mdmsoft/yii2-admin": "~1.0"
to the require section of your composer.json file.
Download latest release from here releases then extract to your project. In your application config, add path alias for this extension.
return [
...
'aliases' => [
'@mdm/admin' => 'path/to/your/extracted',
...
]
];Once the extension is installed, simply modify your application configuration as follows:
return [
'modules' => [
'admin' => [
'class' => 'mdm\admin\Module',
...
]
...
],
...
'components' => [
....
'authManager' => [
'class' => 'yii\rbac\PhpManager', // or use 'yii\rbac\DbManager'
]
],
'as access' => [
'class' => 'mdm\admin\components\AccessControl',
'allowActions' => [
'admin/*', // add or remove allowed actions to this list
]
],
];See Yii RBAC for more detail. You can then access Auth manager through the following URL:
http://localhost/path/to/index.php?r=admin
http://localhost/path/to/index.php?r=admin/route
http://localhost/path/to/index.php?r=admin/permission
http://localhost/path/to/index.php?r=admin/menu
http://localhost/path/to/index.php?r=admin/role
http://localhost/path/to/index.php?r=admin/assignment
To use menu manager (optional). Execute yii migration here:
yii migrate --migrationPath=@mdm/admin/migrations
If You use database (class 'yii\rbac\DbManager') to save rbac data. Execute yii migration here:
yii migrate --migrationPath=@yii/rbac/migrations
Some controller property maybe need to change. To do that, change it via controllerMap property.
'modules' => [
'admin' => [
...,
'controllerMap' => [
'assignment' => [
'class' => 'mdm\admin\controllers\AssignmentController',
'userClassName' => 'path\to\models\User',
'idField' => 'user_id', // id field of model User
]
],
...
]
...
],As default, module using application layout as template. To change it, you have to set layout property.
This extension come with three layout that can be used, there are 'left-menu', 'right-menu' and 'top-menu'.
'modules' => [
'admin' => [
...,
'layout' => 'left-menu', // default null. other avaliable value 'right-menu' and 'top-menu'
],
...
],If you use one of them, you can also customize the menu. You can change menu label or disable it.
'modules' => [
'admin' => [
...,
'layout' => 'left-menu', // default null. other avaliable value 'right-menu' and 'top-menu'
'menus' => [
'assignment' => [
'label' => 'Grand Access' // change label
],
'route' => null, // disable menu
],
],
...
],
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent