PHPackages                             shurper/yii2-module-banner - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Admin Panels](/categories/admin)
4. /
5. shurper/yii2-module-banner

ActiveLibrary[Admin Panels](/categories/admin)

shurper/yii2-module-banner
==========================

Advanced yii2 module for banners management.

1.2.18(5y ago)066MITJavaScriptPHP >=7.0.0

Since Jun 21Pushed 2y agoCompare

[ Source](https://github.com/shurper/yii2-module-banner)[ Packagist](https://packagist.org/packages/shurper/yii2-module-banner)[ RSS](/packages/shurper-yii2-module-banner/feed)WikiDiscussions master Synced 3d ago

READMEChangelogDependencies (6)Versions (32)Used By (0)

yii2-module-banner
==================

[](#yii2-module-banner)

[![Latest Stable Version](https://camo.githubusercontent.com/98edc24aff28f60a722db2ed291769edfdb5da0d09c91b476005698868776f63/68747470733a2f2f706f7365722e707567782e6f72672f736875727065722f796969322d6d6f64756c652d62616e6e65722f762f737461626c65)](https://packagist.org/packages/shurper/yii2-module-banner)[![Latest Unstable Version](https://camo.githubusercontent.com/143fcc6c00df87969f308ac5dceb6d704507e136fe0595f864b9c5d9cda14549/68747470733a2f2f706f7365722e707567782e6f72672f736875727065722f796969322d6d6f64756c652d62616e6e65722f762f756e737461626c65)](https://packagist.org/packages/shurper/yii2-module-banner)[![Total Downloads](https://camo.githubusercontent.com/92418a3be0b924777604c7df810a22557ff9b8f6fd804770138efcc96291010a/68747470733a2f2f706f7365722e707567782e6f72672f736875727065722f796969322d6d6f64756c652d62616e6e65722f646f776e6c6f616473)](https://packagist.org/packages/shurper/yii2-module-banner)[![License](https://camo.githubusercontent.com/1fcdc9072a572229904080059253261d0e0c8953167b75f6e8e55b1783d91a7a/68747470733a2f2f706f7365722e707567782e6f72672f736875727065722f796969322d6d6f64756c652d62616e6e65722f6c6963656e7365)](https://packagist.org/packages/shurper/yii2-module-banner)
Внимание! Вместо этого расширения используйте floor12/yii2-module-banner
ВЛАДЕЛЕЦ ДАННОГО РЕПОЗИТОРИЯ НЕ ЯВЛЯЕТСЯ АВТОРОМ ТЕКСТА, ПРЕДСТАВЛЕННОГО НИЖЕ:

Модуль для размещения и управления баннерами и поп-ап на сайте.

На данный момент оперирует со следующими сущностями

- площадками (местами установки баннера на сайте),
- площадками для поп-ап баннеров
- непосредственно баннерами
- pop-up баннерами.

Установка
---------

[](#установка)

### Добавление модуля в проект

[](#добавление-модуля-в-проект)

Для добавления модуля выполняем команду

```
$ composer require shurper/yii2-module-banner
```

или добавляем в секцию "required" вашего файла composer.json следую строку:

```
"shurper/yii2-module-banner": "dev-master"
```

Внимание, для работы модуля необходима библиотека [PHP-GD](https://www.php.net/manual/ru/book.image.php), собранная с поддержкай формата WEBP. Этот формат имеет ряд преимуществ и используется модулем для отображения баннеров для тех браузеров, [которые это поддерживают](https://caniuse.com/#feat=webp).

### Выполнение миграций

[](#выполнение-миграций)

Для работы модуль использует модуль для работы с файлами [floor12/yii2-module-files](https://github.com/floor12/yii2-module-files), поэтому необходимо применить миграции сразу обоих модулей. Для автоматического применения миграций из установленных в проект модулей рекомендую использовать дополнительный компонент, например [fishvision/yii2-migrate](https://github.com/fishvision/yii2-migrate).

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

```
$ ./yii migrate --migrationPath=@vendor/shurper/yii2-module-banner/src/migrations
$ ./yii migrate --migrationPath=@vendor/floor12/yii2-module-files/src/migrations
```

### Регистрация и конфигурирование модуля

[](#регистрация-и-конфигурирование-модуля)

Для дальнейшей работы необходимо зарегистрировать данный и зависимый от него модули в конфиге приложения, в секции `modules `. В минимальной конфигурации регистрация модулей выглядит следующим образом:

```
'modules' => [
    'modules' => [
        'banner' => [
            'class' => 'shurper\banner\Module',
        ],
        'files' => [
            'class' => 'floor12\files\Module',
        ],
    ],
    ]
    ...
```

При этом `shurper\banner\Module` имеет дополнительный параметры для конфигурации:

1. `administratorRole ` - роль пользователей, которым доступно управление, по умолчанию содержит `@` предоставляя доступ всем авторизованным пользователям;
2. `adminLayout` - алиас для лейаута админского контроллера, по умолчанию `@app/views/layouts/main`;
3. `adaptiveBreakpoint ` - ширина в пикселях, на которой происходит переключения баннера между мобильной и десктоп-версией, по умолчанию `700`;
4. `bannersWebPath` - алиас путь к папке для html баннеров для доступа из браузера, по умолчанию `@web/banners`;
5. `bannersWebRootPath` - алиас путь к папке для html баннеров относительно корня файловой системы, по умолчанию `@webroot/banners`;

Последние 2 параметра необходисы только при использовании Rich HTML баннеров, загрузка которых должна происходить в виде zip архива.

Необходимый для работы модуль файлов [shurper/yii2-module-files](https://github.com/shurper/yii2-module-files) имеет ряд параметров, описанных [в его документации](https://github.com/shurper/yii2-module-files/blob/master/README_RU.md).

Использование
-------------

[](#использование)

Для внедрения в view-файл баннера, вызываем виджет `BannerWidget `, который размещает в этом месте площадку, созданную заранее. В баннер необходимо передать `place_id` - это id площадки для размещения.

```

```

Если площадка не найдена, или в ней отсутствуют связанные баннеры, то виджет ничего не отобразит.

Если на одну и ту же площадку добавлено более одного активного баннера, то существуют две модели поведения. По умолчанию, баннеры будут рандомно меняться при перезагрузке страницы. Но, если в настройках площадки выбрать "слайдер", то все активные баннеры текущей площадки будут перелистываться, образуя слайдер. В настройках баннера существует атрибут как "вес". Если на данной площадке включен режим слайдера, то этот атрибут отвечает за порядок отображения баннеров в слайдере.

Для отображения pop-up баннеров, необходимо в основной layout вывести `PopupWidget`, куда передать `place_id` c ID площадки для pop-up баннеров:

```

```

### Администрирование

[](#администрирование)

По умолчанию админский контроллер доступен по адресу:

```
http://your-domain.com/banner/admin

```

###  Health Score

29

—

LowBetter than 60% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity8

Limited adoption so far

Community9

Small or concentrated contributor base

Maturity69

Established project with proven stability

 Bus Factor1

Top contributor holds 84.8% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~26 days

Total

31

Last Release

2086d ago

Major Versions

0.1.0 → 1.0.02018-07-10

### Community

Maintainers

![](https://www.gravatar.com/avatar/6bd9eef7127abbd0a5fe44bf497bf8e9b5e5dcfaa304a1647a2884654fcfc386?d=identicon)[shurper](/maintainers/shurper)

---

Top Contributors

[![floor12](https://avatars.githubusercontent.com/u/8406969?v=4)](https://github.com/floor12 "floor12 (67 commits)")[![echosayhi](https://avatars.githubusercontent.com/u/139587230?v=4)](https://github.com/echosayhi "echosayhi (11 commits)")[![zertex](https://avatars.githubusercontent.com/u/6353201?v=4)](https://github.com/zertex "zertex (1 commits)")

---

Tags

yii2yiipopupyii 2bannerfloor12yii2 module

### Embed Badge

![Health badge](/badges/shurper-yii2-module-banner/health.svg)

```
[![Health](https://phpackages.com/badges/shurper-yii2-module-banner/health.svg)](https://phpackages.com/packages/shurper-yii2-module-banner)
```

###  Alternatives

[mootensai/yii2-enhanced-gii

Generate Relational (hasMany, hasOne, belongsTo, & nested) Models & CRUD.

202174.6k5](/packages/mootensai-yii2-enhanced-gii)[floor12/yii2-module-files

Yii2 module to upload and manage files to your models.

1612.4k6](/packages/floor12-yii2-module-files)[skeeks/cms

SkeekS CMS — control panel and tools based on php framework Yii2

13825.6k47](/packages/skeeks-cms)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)