naffiq/yii2-bridge

Simple admin panel for enthusiasts

Thursday, June 7, 2018
by naffiq
Repository
2 Watchers
3 Stars
953 Installations

PHP
1 Dependents
0 Suggesters
3 Forks
9 Open issues
52 Versions
16 % Grown

The README.md

Yii2 Bridge

Yet another admin panel , _(*1)

Краткое введение и туториал на русском

Bridge delivers you simple content management system that utilizes best production-tested components and plugins for Yii2., _(*2)

Installation

Add it as Composer dependency by running, _(*3)

$ composer require naffiq/yii2-bridge

Be sure to configure module (instructions below), before running migrations.

Configuration

Add module declaration to your config file for web config:, _(*4)

<?php

return [
    // ... your config
    'modules' => [
        'admin' => [
            'class' => '\naffiq\bridge\BridgeModule',
            // Add your projects modules here to keep right routing.
            'modules' => [
                'customModule' => ['class' => '\app\modules\your\CustomModule']
            ],
            // Add menu item of your content management module to menu
            'menu' => [
                [
                    'title' => 'Content',
                    'url' => ['/admin/content/default/index'],
                    'active' => ['module' => 'content'],
                    'icon' => 'list'
                ]
            ],
            // Alternatively you can define different menu items for different
            // roles. In that case it will override default menu items, such as
            // settings, users and dashboard
            'composeMenu' => function ($user, $roles, $authManager) {
                 /**
                  * @var \yii\web\User $user 
                  * @var \Da\User\Model\Role[] $roles
                  * @var \Da\User\Component\AuthDbManagerComponent $authManager 
                  */
                 if (isset($roles['admin'])) {
                     return require __DIR__ . '/menu-admin.php';
                 }
                 if ($user->can('editor')) {
                     return require __DIR__ . '/menu-editor.php';
                 }
                 if (in_array($user->id, $authManager->getUserIdsByRole('manager'))) {
                     return require __DIR__ . '/menu-manager.php';
                 }
                 // Or any other available method

                 return __DIR__ . '/menu-default.php';
            }
        ]
    ],
    'bootstrap' => [        
        'admin' // add module id to bootstrap for proper aliases and url routes binding
    ]
];

And for console config, in order to run migrations:, _(*5)

<?php
return [
    // ... your config
    'modules' => [
        'admin' => ['class' => '\naffiq\bridge\BridgeModule']
    ],
    'bootstrap' => [        
        'admin' // add module id to bootstrap for proper aliases and url routes binding
    ]
];

Setup

After installing and config setup (including database), you should have installation executable in your vendor folder. You can run all the migrations required with single command:, _(*6)

$ ./vendor/bin/bridge-install

Warning! This command is running with --interactive=0 flag, which means it will not ask confirmation for it., _(*7)

Usage

After running every step above you should have your admin panel running on /admin route. The only thing left is to run command to create users., _(*8)

Creating first user

Run following command to generate users:, _(*9)

$ php yii user/create EMAIL USERNAME PASSWORD ROLE

So the correct command to create user with admin role for admin panel would be:, _(*10)

$ php yii user/create admin@sitename.kz admin PASSWORD admin

Gii

Gii that is provided with bridge is packed with some improvements to basic gii. When generating model with db fields ending by image or file, it would automatically add corresponding upload behavior. You can turn this behaviors off by clicking on checkbox in generator interface., _(*11)

And also it has Bridge CRUD generator, which will generate necessary fields inputs and display it nicely to the index table., _(*12)

Development and testing

Configure your .env (refer to .env.example). Run migrations with:, _(*13)

$ ./bin/bridge-install-dev

Bridge comes with console app for development and testing purposes, located in bin folder. You can simply execute it with, _(*14)

$ php bin/yii.php CONTROLLER/ACTION [params]

Test package with, _(*15)

$ ./vendor/bin/phpunit

The Versions

07/06 2018

dev-master

9999999-dev

Simple admin panel for enthusiasts

project yii2-bridge

Simple admin panel for enthusiasts

naffiq/yii2-bridge

The README.md

Yii2 Bridge

Краткое введение и туториал на русском

Installation

Be sure to configure module (instructions below), before running migrations.

Configuration

Setup

Usage

Creating first user

Gii

Development and testing

The Versions

dev-master

The Requires

The Development Requires

by naffiq

dev-naffiq-patch-1

The Requires

The Development Requires

by naffiq

v0.9.0

The Requires

The Development Requires

by naffiq

dev-settings-groups

The Requires

The Development Requires

by naffiq

v0.8.4

The Requires

The Development Requires

by naffiq

v0.8.3

The Requires

The Development Requires

by naffiq

dev-i18n-fixes

The Requires

The Development Requires

by naffiq

V0.8.2

The Requires

The Development Requires

by naffiq

v0.8.0-rc

The Requires

The Development Requires

by naffiq

v0.8.1

The Requires

The Development Requires

by naffiq

v0.8.0

The Requires

The Development Requires

by naffiq

v0.7.1

The Requires

The Development Requires

by naffiq

v0.7.0

The Requires

The Development Requires

by naffiq

v0.6.4

The Requires

The Development Requires

by naffiq

dev-phpunit

The Requires

The Development Requires

by naffiq

v0.6.3

The Requires

The Development Requires

by naffiq

v0.6.2