Cotonti — Banners

Cotonti — Banners

Модуль предназначен для показа рекламных баннеров на сайте (т.н. «баннерокрутилка»).
тип: модуль
Версия плагина: 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) невозможно.

 

Хостинг без головной боли

Тариф "Старт" - оптимально, не дорого, полностью готовый и проверенный хостинг для установки такого сайта, - сборка фриланс биржи и маркетплейс услуг, продукции, цифровых товаров.

1 месяц на тест бесплатно + сервисный домен
(свой домен прикрепить и протестирвать можно даже на бесплатном тестовом периоде хостинга)

Оставьте комментарий

Прокрутить вверх