README

Особенности (Features)

(RU)

Лимит показов не по дате, а по количеству
Рекламные зоны отдельны для мобильной и десктопа
Расчитано на работу в MySql v.5+ из-за on-duplicate-key-update для ускорения статистики

(EN)

Impression limit by quantity, not by date
Advert zones divided to mobile & desktop
Work on MySql v.5+ because of on-duplicate-key-update to speed-up stat counters

Требования (Requipments)

PHP v7+ (v5.6 - не тестировал (not tested))
MySql v5.6 (другое не тестировал (other not tested))
JQuery v3+ (другое не тестировал (other not tested))
Yii CSRF-Tokens (без них не тестировал (not tested without))

Установка (Installation)

composer require lg-xenos/yii2-banner-system

Или добавить в composer.json (or add to composer.json)

"lg-xenos/yii2-banner-system": "*"

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

(in English below)

Добавляем данные строчки в 2 места файла конфигурации приложения (например frontend/config/main.php)

	/* ... */
	'bootstrap'           => [ /* ... */ 'adwert' /* ... */ ],
	/* ... */
	'modules'             => [
		/* ... */
		'adwert'   => [
			'class'          => lgxenos\yii2\banner\BannerModule::class,
			'frontPrettyUrl' => '/asd/',
            //
			// ОПЦИОНАЛЬНЫЕ НАСТРОЙКИ. ТОЛЬКО ЕСЛИ ВАМ НАДО ЧТО-ТО МЕНЯТЬ
            // module settings
			'uploadPath'     => '@frontend/upload/banners/%USER_ID%/',
			'uploadWebPath'  => '/upload/banners/%USER_ID%/',
			'userModel'      => \common\models\User::class,
			'userModelName'  => 'username',
			'mobileWidth'    => 768,
			// yii settings
			'layout'         => '@frontend/modules/yiiAdmin/views/layouts/main.php',
		],
		/* ... */
	],

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

yii migrate --migrationPath=@vendor/lgxenos/yii2-banner-system/src/migrations

Теперь нужно

открыть главную страницу по ссылке: http://localhost/adwert
создать зону
создать баннер
вставить в view-файл код: \lgxenos\yii2\banner\BannerModule::setArea(AREA_ID);

English version

Let 's add into 2 places of your app-config (for example frontend/config/main.php)

	/* ... */
	'bootstrap'           => [ /* ... */ 'adwert' /* ... */ ],
	/* ... */
	'modules'             => [
		/* ... */
		'adwert'   => [
			'class'          => lgxenos\yii2\banner\BannerModule::class,
			'frontPrettyUrl' => '/asd/',
            //
			// OPTIONAL SETTINGS. IF YOU NEED CHANGE SOMETHING ONLY
            // module settings
			'uploadPath'     => '@frontend/upload/banners/%USER_ID%/',
			'uploadWebPath'  => '/upload/banners/%USER_ID%/',
			'userModel'      => \common\models\User::class,
			'userModelName'  => 'username',
			'mobileWidth'    => 768,
			// yii settings
			'layout'         => '@frontend/modules/yiiAdmin/views/layouts/main.php',
		],
		/* ... */
	],

Execute migrations:

yii migrate --migrationPath=@vendor/lgxenos/yii2-banner-system/src/migrations

Now we need

open system by link http://localhost/adwert
create zone
create banner
insert into view-file code: \lgxenos\yii2\banner\BannerModule::setArea(AREA_ID);

lg-xenos / yii2-banner-system

Maintainers

Details