Download the PHP package floor12/yii2-module-banner without Composer
On this page you can find all versions of the php package floor12/yii2-module-banner. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Informations about the package yii2-module-banner
yii2-module-banner
Модуль для размещения и управления баннерами и поп-ап на сайте.
На данный момент оперирует со следующими сущностями
- площадками (местами установки баннера на сайте),
- площадками для поп-ап баннеров
- непосредственно баннерами
- pop-up баннерами.
Установка
Добавление модуля в проект
Для добавления модуля выполняем команду
или добавляем в секцию "required" вашего файла composer.json следую строку:
Внимание, для работы модуля необходима библиотека PHP-GD, собранная с поддержкай формата WEBP. Этот формат имеет ряд преимуществ и используется модулем для отображения баннеров для тех браузеров, которые это поддерживают.
Выполнение миграций
Для работы модуль использует модуль для работы с файлами floor12/yii2-module-files, поэтому необходимо применить миграции сразу обоих модулей. Для автоматического применения миграций из установленных в проект модулей рекомендую использовать дополнительный компонент, например fishvision/yii2-migrate.
Выполняем миграции:
Регистрация и конфигурирование модуля
Для дальнейшей работы необходимо зарегистрировать данный и зависимый от него модули в конфиге приложения, в секции modules
. В минимальной конфигурации регистрация модулей выглядит следующим образом:
При этом floor12\banner\Module
имеет дополнительный параметры для конфигурации:
administratorRole
- роль пользователей, которым доступно управление, по умолчанию содержит@
предоставляя доступ всем авторизованным пользователям;adminLayout
- алиас для лейаута админского контроллера, по умолчанию@app/views/layouts/main
;adaptiveBreakpoint
- ширина в пикселях, на которой происходит переключения баннера между мобильной и десктоп-версией, по умолчанию700
;bannersWebPath
- алиас путь к папке для html баннеров для доступа из браузера, по умолчанию@web/banners
;bannersWebRootPath
- алиас путь к папке для html баннеров относительно корня файловой системы, по умолчанию@webroot/banners
;
Последние 2 параметра необходисы только при использовании Rich HTML баннеров, загрузка которых должна происходить в виде zip архива.
Необходимый для работы модуль файлов floor12/yii2-module-files имеет ряд параметров, описанных в его документации.
Использование
Для внедрения в view-файл баннера, вызываем виджет BannerWidget
, который размещает в этом месте площадку, созданную заранее. В баннер необходимо передать place_id
- это id
площадки для размещения.
Если площадка не найдена, или в ней отсутствуют связанные баннеры, то виджет ничего не отобразит.
Если на одну и ту же площадку добавлено более одного активного баннера, то существуют две модели поведения. По умолчанию, баннеры будут рандомно меняться при перезагрузке страницы. Но, если в настройках площадки выбрать "слайдер", то все активные баннеры текущей площадки будут перелистываться, образуя слайдер. В настройках баннера существует атрибут как "вес". Если на данной площадке включен режим слайдера, то этот атрибут отвечает за порядок отображения баннеров в слайдере.
Для отображения pop-up баннеров, необходимо в основной layout вывести PopupWidget
, куда передать place_id
c ID площадки для pop-up
баннеров:
Администрирование
По умолчанию админский контроллер доступен по адресу: