floor12/yii2-module-banner

Advanced yii2 module for banners management.

yii2-module-banner

, _(*1)

Модуль для размещения и управления баннерами и поп-ап на сайте., _(*2)

На данный момент оперирует со следующими сущностями, _(*3)

• площадками (местами установки баннера на сайте),
• площадками для поп-ап баннеров
• непосредственно баннерами
• pop-up баннерами.

Установка

Добавление модуля в проект

Для добавления модуля выполняем команду, _(*4)

$ composer require floor12/yii2-module-banner

или добавляем в секцию "required" вашего файла composer.json следую строку:, _(*5)

"floor12/yii2-module-banner": "dev-master"

Внимание, для работы модуля необходима библиотека PHP-GD, собранная с поддержкай формата WEBP. Этот формат имеет ряд преимуществ и используется модулем для отображения баннеров для тех браузеров, которые это поддерживают., _(*6)

Выполнение миграций

Для работы модуль использует модуль для работы с файлами floor12/yii2-module-files, поэтому необходимо применить миграции сразу обоих модулей. Для автоматического применения миграций из установленных в проект модулей рекомендую использовать дополнительный компонент, например fishvision/yii2-migrate., _(*7)

Выполняем миграции:, _(*8)

$ ./yii migrate --migrationPath=@vendor/floor12/yii2-module-banner/src/migrations
$ ./yii migrate --migrationPath=@vendor/floor12/yii2-module-files/src/migrations

Регистрация и конфигурирование модуля

Для дальнейшей работы необходимо зарегистрировать данный и зависимый от него модули в конфиге приложения, в секции modules. В минимальной конфигурации регистрация модулей выглядит следующим образом:, _(*9)

'modules' => [
    'modules' => [
        'banner' => [
            'class' => 'floor12\banner\Module',
        ],
        'files' => [
            'class' => 'floor12\files\Module',
        ],
    ],
    ]
    ...

При этом floor12\banner\Module имеет дополнительный параметры для конфигурации:, _(*10)

1. administratorRole - роль пользователей, которым доступно управление, по умолчанию содержит @ предоставляя доступ всем авторизованным пользователям;
2. adminLayout - алиас для лейаута админского контроллера, по умолчанию @app/views/layouts/main;
3. adaptiveBreakpoint - ширина в пикселях, на которой происходит переключения баннера между мобильной и десктоп-версией, по умолчанию 700;
4. bannersWebPath - алиас путь к папке для html баннеров для доступа из браузера, по умолчанию @web/banners;
5. bannersWebRootPath - алиас путь к папке для html баннеров относительно корня файловой системы, по умолчанию @webroot/banners;

Последние 2 параметра необходисы только при использовании Rich HTML баннеров, загрузка которых должна происходить в виде zip архива., _(*11)

Необходимый для работы модуль файлов floor12/yii2-module-files имеет ряд параметров, описанных в его документации., _(*12)

Использование

Для внедрения в view-файл баннера, вызываем виджет BannerWidget, который размещает в этом месте площадку, созданную заранее. В баннер необходимо передать place_id - это id площадки для размещения., _(*13)

<?= floor12\banner\widgets\BannerWidget::widget(['place_id' => 1]) ?>

Если площадка не найдена, или в ней отсутствуют связанные баннеры, то виджет ничего не отобразит., _(*14)

Если на одну и ту же площадку добавлено более одного активного баннера, то существуют две модели поведения. По умолчанию, баннеры будут рандомно меняться при перезагрузке страницы. Но, если в настройках площадки выбрать "слайдер", то все активные баннеры текущей площадки будут перелистываться, образуя слайдер. В настройках баннера существует атрибут как "вес". Если на данной площадке включен режим слайдера, то этот атрибут отвечает за порядок отображения баннеров в слайдере., _(*15)

Для отображения pop-up баннеров, необходимо в основной layout вывести PopupWidget, куда передать place_id c ID площадки для pop-up баннеров:, _(*16)

<?php
    $this->beginBody();
    echo PopupWidget::widget(['place_id' => 1]);
?>

Администрирование

По умолчанию админский контроллер доступен по адресу:, _(*17)

http://your-domain.com/banner/admin