yii2-gambit/yii2-banner

Вывод баннеров в случайном порядке Yii, MySQL

Ротатор баннеров

Task description:, _(*1)

Требуется написать систему вывода рекламы. Класс, либо расширение для Yii, _(*2)

Имеется множество шаблонов html/js, _(*3)

Возьмем для примера superbanner.php с текстом:, _(*4)

, _(*5)

, _(*6)

Требования к приложению:, _(*7)

• Приложение должно уметь подключать подобные шаблоны без указания типа файла, а только его имени, т.е "superbanner" ( возвращается код файла ), _(*8)

• Возможность задавать количество возвращаемых кодов ( подключаю "superbanner" 3 раза и т.д ), _(*9)

• Должен быть конфиг приложения для возможности задать кол-во возвращаемых кодов по умолчанию, _(*10)

• Возможность задавать процентное отображение количества кодов. Например в конфиге для баннера "superbanner" указано по умолчанию 50 шт. Вызывая приложение мы сообщаем что нам нужно 50% от указанного количества в конфиге и нам возвращается 25 кодов. При этом запоминается для этого типа остаточное число баннеров. Забрали 25. Осталось 25. При следующем запросе в % или кол-ве приложение уже будет расчитывать из остатка кодов. Т.е вызов на странице что то типа, _(*11)

echo Banners::get("superbanner", '50%') // вернулось 25 кодов, _(*12)

// вызываем второй раз на странице, _(*13)

echo Banners::get("superbanner", '20%') // вернулось 5 кодов и еще осталось 20, _(*14)

====================== Вывод баннеров с учетом ограничения по количеству, _(*15)

Installation

The preferred way to install this extension is through composer., _(*16)

Either run, _(*17)

php composer.phar require --prefer-dist yii2-gambit/yii2-banner "*"

or add, _(*18)

"yii2-gambit/yii2-banner": "*"

to the require section of your composer.json file., _(*19)

Usage

Once the extension is installed, simply use it in your code by :, _(*20)

$config = [
    'superbanner' => [
        'default' => 10,
        'banner' => [
            'file' => '@app/web/img/banners/superbanner/superbanner_1.php',
            'id' => '54447',
            'url' => 'http://yandex.ru',
        ],
    ],
    'superbanner2' => [
        'default' => 5,
        'banner' => [
            'file' => '@app/web/img/banners/superbanner2/superbanner2_1.js',
            'id' => '54454',
            'url' => 'http://wordstat.yandex.ru',
        ],
    ],
    'superbanner3' => [
        'default' => 50,
        'banner' => [
            'file' => '@app/web/img/banners/superbanner3/superbanner.html',
            'id' => '54461',
            'url' => 'http://wordstat.yandex.ru',
        ],
    ],
];

=               
        \gambit\banner\rotator\ShowBanner::widget([
            'name' => 'superbanner',
            'config' => \Yii::getAlias('@frontend') . '/config/banners.php',
            'count' => '5%',
            'default' => '50',
        ]); 
?>```

file log example record 
{"superbanner":{"value":5}}
{"superbanner2":{"value":12}}

```php

    Переопределяемые свойства 

    /**
     * Наименование группы баннеров
     */
    public $name;

    /**
     * Переопределение значения опции 'default' в конфигурационном файле баннеров
     * @var integer
     */
    public $default;

    /**
     * Structure elements 
     *      [
     *           'file' => '@app/web/img/banners/superbanner/superbanner_1.php',
     *           'url' => 'http://yandex.ru',
     *           'id' => '54447',
     *      ],
     * @var array
     */
    public $banner;

    /**
     * Путь к конфигу
     * @var string
     */
    public $configPath = '@app/config/banners.php';

    /**
     * @var конфигурация баннеров
     */
    public $config = [];

    /**
     * @var integer
     */
    public $count = 0;

    /**
     * Рассчитанное ротатором кол-во
     * @var integer 
     */
    public $counterRotate;
    public $logPath = '@app/runtime/';

    /**
     * class path rotator
     */
    public $classPathRotator = '\gambit\banner\rotator\Rotator';

    /**
     * @var object Rotator
     */
    public $rotate = null;

    /**
     * Html attributes 
     * @var array
     */
    public $option = [];

    /**
     * Баннеры
     * @var array
     */
    public $items = [];

    /**
     * наименование view (шаблона)
     * @var array
     */
    public $viewName = 'show_banner';