Download the PHP package max-dreamsoft/yii2-admin without Composer

RBAC Manager for Yii 2

Documentation

Important: If you install version 3.x, please see this readme.

• Change Log.
• Authorization Guide. Important, read this first before you continue.
• Basic Usage.
• Using Menu.
• Api.

Installation

Install With Composer

The preferred way to install this extension is through composer.

Either run

or for the dev-master

Or, you may add

to the require section of your composer.json file and execute php composer.phar update.

Install From the Archive

Download the latest release from here releases, then extract it to your project. In your application config, add the path alias for this extension.

Usage

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

See Yii RBAC for more detail. You can then access Auth manager through the following URL:

To use the menu manager (optional), execute the migration here:

If you use database (class 'yii\rbac\DbManager') to save rbac data, execute the migration here:

Customizing Assignment Controller

Assignment controller properties may need to be adjusted to the User model of your app. To do that, change them via controllerMap property. For example:

• Required properties
  • userClassName Fully qualified class name of your User model
    Usually you don't need to specify it explicitly, since the module will detect it automatically
  • idField ID field of your User model
    The field that corresponds to Yii::$app->user->id.
    The default value is 'id'.
  • usernameField User name field of your User model
    The default value is 'username'.
• Optional properties
  • fullnameField The field that specifies the full name of the user used in "view" page.
    This can either be a field of the user model or of a related model (e.g. profile model).
    When the field is of a related model, the name should be specified with a dot-separated notation (e.g. 'profile.full_name').
    The default value is null.
  • extraColumns The definition of the extra columns used in the "index" page
    This should be an array of the definitions of the grid view columns.
    You may include the attributes of the related models as you see in the example above.
    The default value is an empty array.
  • searchClass Fully qualified class name of your model for searching the user model
    You have to supply the proper search model in order to enable the filtering and the sorting by the extra columns.
    The default value is null.

Customizing Layout

By default, the admin module will use the layout specified in the application level. In that case you have to write the menu for this module on your own.

By specifying the layout property, you can use one of the built-in layouts of the module: 'left-menu', 'right-menu' or 'top-menu', all equipped with the menu for this module.

If you use one of them, you can also customize the menu. You can change menu label or disable it.

While using a dedicated layout of the module, you may still want to have it wrapped in your application's main layout that has your application's nav bar and your brand logo on it. You can do it by specifying the mainLayout property with the application's main layout. For example:

screenshots