README

此扩展可以帮助您在网站页面上放置横幅并管理它们。

安装

安装此扩展的首选方法是通过 composer。

运行以下命令之一

php composer.phar require prokhonenkov/yii2-banners-system

或者

"prokhonenkov/yii2-banners-system": "*"

将其添加到您的 composer.json 文件的 require 部分。

迁移

运行以下命令

php yii migrate --migrationPath=@prokhonenkov/bannerssystem/migrations --interactive=0

配置

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

<?php

return [
    // ... your config
    'modules' => [
        'bannersSystem' => [
            'class' => \prokhonenkov\bannerssystem\BannersSystem::class,
            'administratorPermissionName' => 'admin', //admin role
            'uploadDir' => '@webroot/media/banners-system',
            'uploadUrl' => '@web/media/banners-system',
        ],
    ],
    'bootstrap' => [        
        'bannersSystem' // add module id to bootstrap for proper aliases and url routes binding
    ]
];

此外，您还可以覆盖布局和视图文件

<?php

return [
    // ... your config
    'modules' => [
        'bannersSystem' => [
            'class' => \prokhonenkov\bannerssystem\BannersSystem::class,
            'administratorPermissionName' => 'admin', //admin role
            'uploadDir' => '@webroot/media/banners-system',
            'uploadUrl' => '@web/media/banners-system',
            
            'layout' => '@alias/views/layouts/main',
            'views' => [
                'banner' => [
                    'index' => '@path/index',
                    'update' => '@path/update',
                    'create' => '@path/create',
                    'view' => '@path/view',
                ],
                'area' => [
                    'index' => '@path/index',
                    'update' => '@path/update',
                    'create' => '@path/create',
                    'view' => '@path/view',
                ]
            ],
        ],
    ],
];

用法

将此代码放入您希望使用的控制器中

public function behaviors()
{
    return [
        'banner-system' => [
            'class' => \prokhonenkov\bannerssystem\behaviors\BannerSystemBehavior::class
        ]
    ];
}

然后，在管理面板中创建横幅区域和横幅。

将此代码放入您希望使用的视图文件中的相应位置

<?= \prokhonenkov\bannerssystem\BannerZone::getInstance()->setZoneById(BANNER_ZONE_ID);?>