apaoww/yii2-admin-oci8

Auth manager for Yii2 Oracle Oci8

dev-master / 1.0.x-dev 2023-09-14 02:00 UTC

Requires

• apaoww/yii2-dbmanager-oci8: dev-master
• apaoww/yii2-oci8: >=2.0.2
• yiisoft/yii2: ~2.0
• yiisoft/yii2-jui: ~2.0

BSD-3-Clause

• Apa Oww

• admin
• auth
• yii

README

Documentation

• Change Log.
• Basic Usage.
• Using Menu.
• Api

Installation

Install With Composer

The preferred way to install this extension is through composer.

Either run

php composer.phar require apaoww/yii2-admin-oci8 "dev-master"

for dev-master

php composer.phar require apaoww/yii2-admin-oci8 "dev-master"

or add

"apaoww/yii2-admin-oci8": "dev-master"

to the require section of your composer.json file.

Install From Archive

return [
    ...
    'aliases' => [
        '@apaoww/AdminOci8' => 'path/to/your/extracted',
        ...
    ]
];

Usage

Once the extension is installed, simply modify your application configuration as follows:

return [
	'modules' => [
		'admin' => [
			'class' => 'apaoww\AdminOci8\Module',
            ...
		]
		...
	],
	...
	'components' => [
		....
		'authManager' => [
			'class' => 'yii\rbac\PhpManager', // or use 'yii\rbac\DbManager'
		]
	],
    'as access' => [
        'class' => 'apaoww\AdminOci8\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

Customizing Controller

Some controller property maybe need to change. To do that, change it via controllerMap property.

	'modules' => [
		'admin' => [
			...,
            'controllerMap' => [
                 'assignment' => [
                    'class' => 'apaoww\AdminOci8\controllers\AssignmentController',
                    'userClassName' => 'path\to\models\User',
                    'idField' => 'user_id', // id field of model User
                ]
            ],
            ...
		]
		...
	],

Customizing Layout

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
            ],
        ],
        ...
    ],

screenshots