README

简短介绍和俄语教程

Bridge提供了一个简单的内容管理系统，它利用了经过最佳生产测试的组件和插件，为Yii2提供支持。

安装

通过运行以下命令将其添加为Composer依赖项：

$ composer require yii2-bridge/core

 在运行迁移之前，请确保已配置模块（以下说明）。

配置

将模块声明添加到您的web配置文件中

<?php

return [
    // ... your config
    'modules' => [
        'admin' => [
            'class' => '\Bridge\Core\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
    ]
];

并且对于控制台配置，以便运行迁移

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

设置

安装和配置设置（包括数据库）后，您应该在vendor文件夹中找到安装可执行文件。您可以使用单个命令运行所有必需的迁移

$ ./vendor/bin/bridge-install

警告！此命令使用--interactive=0标志，这意味着它不会请求确认。

用法

运行上述每一步后，您应该能在/admin路由上运行您的管理面板。剩下的事情只是运行创建用户的命令。

创建第一个用户

运行以下命令以生成用户

$ php yii user/create EMAIL USERNAME PASSWORD ROLE 

因此，为管理面板创建具有管理员角色的用户的正确命令应该是

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

Gii

与Bridge一起提供的Gii在基本gii的基础上进行了改进。当生成以image或file结尾的数据库字段模型时，它将自动添加相应的上传行为。您可以通过在生成器界面中点击复选框来关闭这些行为。

它还包含Bridge CRUD生成器，它将生成必要的字段输入并优雅地显示在索引表中。

开发和测试

配置您的.env（参阅.env.example）。使用以下命令运行迁移：

$ ./bin/bridge-install-dev

Bridge附带一个位于bin文件夹中的控制台应用程序，用于开发和测试目的。您可以通过以下方式简单执行它：

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

使用以下命令测试包

$ ./vendor/bin/phpunit