Модуль предназначен для показа рекламных баннеров на сайте (т.н. "баннерокрутилка").
тип: модуль
Версия плагина: 2.0.1
Совместимость: Siena
GitHub: brs Системные требования и ограничения:
- Наличие на Вашем сайте установленной библиотеки Cotonti Lib не ниже версии 2.0
- Административная часть плагина расчитана на альтернативную тему панели управления cpanel
- В качестве шаблонизатора используется View
Описание:
Баннеры разделяются по категориям и в каждую рекламную позицию на сайте можно вывести баннеры из одной или нескольких категорий. Вывод баннеров, ротация, осуществляется по порядку или случайным образом.
Для каждого баннера ведется статистика показов и кликов. Возможно ведение почасовой статистики, но это вызовет дополнительную нагрузку на сервер.
Поддерживаются изображения и флеш. Так же есть возможность установки произвольного кода баннера, например со сторонней рекламной системы.
Для удобства ведения рекламных кампаний, баннеры можно разбивать по клиентам. Это позволяет получать статистику показов и кликов по баннеру для каждого клиента.
Возможности:
- отображение и автоматическая ротация баннеров на вашем сайте
- упорядоченная или случайная ротация баннеров
- поддерживаемые форматы: jpeg, png, gif, bmp и swf
- возможность установки произвольного кода баннера
- неограниченное количество категорий (баннерных позиций)
- неограниченное количество баннеров в категрии и в целом
- статистика показов и кликов
- почасовая статистика показов и кликов
- отчет о показах и кликах с фильтрами по периоду, категориям и клиентам
- привязка баннеров к клиентам
Установка:
- Скопировать модуль на сервер в папку
modules/brs
- В папке
datas cоздать папку
brs и установить на нее права на запись
- Установить
плагин в панели управления
- Создать нужные категории и баннеры
- В нужное место файла шаблона добавить вызов виджета:
<?=brs_controller_Widget::banner('category', 2)?> (параметры см. ниже)
Параметры виджета:
Виджет вызывается со следующими параметрами
brs_controller_Widget::banner($cat, $cnt = 1, $tpl = 'brs.banner', $order = 'order', $client = false, $subcats = false)
где:
$cat - категория баннеров или список категорий, разделенный символом ';'
Остальные параметры не обязательные
$cnt - количество выводимых баннеров. При выводе нескольких баннеров подряд, следует использовать этот параметр вместо нескольких вывозовов этой функции, т.к. каждый отдельный вывозов совершает обращения в базе данных
$tpl = tpl - файл
$order - порядок показа. Допустимые значения
'order' - по порядку,
'rand' - случайно
$client - данный параметр пока не используется
$subcats - выводить баннеры из вложенных категорий
Однако, в отличие от шаблонизатора
View, встроенный шаблонизатор
CoTemplate не умеет работать с объектами (как ни странно). Для использования в
tpl-шаблонах пользуйтесь call-back функцией:
banner_widget($cat, $cnt = 1, $tpl = 'banners', $order = 'order', $client = false, $subcats = false)
Она является оберткой для
brs_controller_Widget::banner.
Встроенный шаблонизатор Cotonti не позволяет так просто использовать PHP-код в TPL-файлах. По этому нужно использовать Call-back функцию banner_widget() которая является оберткой для вызова brs_controller_Widget::banner().
В TPL-файл нужно вставить код:
{PHP|banner_widget('gl1', 2)}
В шаблонизаторе
View вполне можно использовать и
<?=brs_controller_Widget::banner('gl1', 2)?>
Будет работать.
API категорий един для всех модулей. Эти поля означают тоже самое, что и для любых других категорий:
код - уникальный цифровой или цифро-буквенный код категории. Slug или как его еще называют alias.
путь используется для построения дерева категорий. Уровни вложенности разделяются точками. При создании вложенных категорий, родительские категории уже должны существовать.
Заголовок - название категории.
Описание и иконка - соответственно описание и иконка для категории. Они необязательные и на вывод особо никак не влияют, но Вы можете использовать их в своих шаблонах.
История изменений:
Версия v2.0.1
- Совместимость с Cotonti Lib v2.0.
Версия v2.0.0
- Расширение теперь полноценный модуль. Раньше оно было плагином.
- Переход на Cotonti Lib. Это дало унификацию API и повышение производительности.
- Изменен код расширения и название папки на сервере. ADBlocker'ы не любили название banners :)
Обратите внимание! Автоматическое обновление плагина (версии 1) до модуля (версии 2) невозможно.
