PHPackages                             larikmc/yii2-admin - 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. larikmc/yii2-admin

ActiveYii2-extension[Admin Panels](/categories/admin)

larikmc/yii2-admin
==================

Unified admin module for Yii2 backend with dashboard, auth and RBAC

v1.2.3(4w ago)078[1 issues](https://github.com/larikmc/yii2-admin/issues)BSD-3-ClausePHPPHP >=8.1

Since Mar 12Pushed 4w agoCompare

[ Source](https://github.com/larikmc/yii2-admin)[ Packagist](https://packagist.org/packages/larikmc/yii2-admin)[ RSS](/packages/larikmc-yii2-admin/feed)WikiDiscussions master Synced 3w ago

READMEChangelog (10)Dependencies (6)Versions (35)Used By (0)

larikmc/yii2-admin
==================

[](#larikmcyii2-admin)

Готовое расширение для `Yii2 backend`: одна установка, один модуль `admin`, внутри уже есть:

- dashboard и общий layout админки
- авторизация и страница входа
- восстановление пароля для админки
- RBAC: роли, действия и назначения
- одноразовые инвайты для регистрации администратора
- security log
- очистка кеша
- системный bootstrap для `admin`, `adminPanel` и защитных инвариантов root-пользователя `ID=1`

Пакет рассчитан на сценарий, где админка, auth и RBAC живут вместе как единая backend-платформа.

Перед интеграцией UI обязательно прочитайте раздел `UI guide` в этом README.

Связанные документы:

- `AI-INTEGRATION-CHECKLIST.md` (обязательный чеклист для нейросети при интеграции в новый проект)

Требования
----------

[](#требования)

- PHP 8.1+
- Yii2 2.0.x
- `yiisoft/yii2-bootstrap5`
- `authManager` = `yii\rbac\DbManager`

Что дает пакет
--------------

[](#что-дает-пакет)

После подключения у вас есть:

- `/admin`
- `/admin/login`
- `/admin/auth/request-password-reset`
- `/admin/auth/reset-password?token=...`
- `/admin/auth/invite?token=...`
- `/admin/site/ui-kit`
- `/admin/auth/security-log`
- `/admin/rbac`
- `/admin/rbac/user`
- `/admin/rbac/role`
- `/admin/rbac/permission`
- `/admin/rbac/assignment`
- `/admin/rbac/invite`

Внутри RBAC уже поддержана схема:

- `действия -> роли -> пользователи`

То есть:

1. создаете действия
2. включаете действия в роль
3. назначаете роль пользователю

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

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

### Composer

[](#composer)

```
composer require larikmc/yii2-admin
```

### После обновления пакета

[](#после-обновления-пакета)

После `composer update` (или после переключения версии/тега) рекомендуется:

1. очистить опубликованные ассеты Yii (`web/assets/*`)
2. очистить кеш приложения (`php yii cache/flush-all`, если команда доступна)
3. сделать hard refresh в браузере (`Ctrl+F5`)

Это нужно, чтобы сразу подтянулись обновленные `css/js` и новые view-шаблоны расширения.

Для локального path-пакета:

```
{
  "repositories": [
    {
      "type": "path",
      "url": "../yii2-admin",
      "options": {
        "symlink": true,
        "relative": true
      }
    }
  ],
  "require": {
    "larikmc/yii2-admin": "@dev"
  }
}
```

Базовая конфигурация backend
----------------------------

[](#базовая-конфигурация-backend)

Пример для `backend/config/main.php`:

```
'defaultRoute' => 'admin/site/index',
'layout' => '@larikmc/admin/views/layouts/main',
'modules' => [
    'admin' => [
        'class' => larikmc\admin\Module::class,
        'userClass' => common\models\User::class,
        'userModel' => common\models\User::class,
        'userIdField' => 'id',
        'usernameField' => 'username',
        'emailField' => 'email',
        'statusField' => 'status',
        'rbacAccessRoles' => [],

        // Настройки авторизации
        'maxUserAttempts' => 5,
        'captchaAfterAttempts' => 3,
        'lockDuration' => 120,
        'userAttemptsTtl' => 120,
        'maxDelaySeconds' => 10,

        // Необязательно: свой placeholder для lazyload.
        // Если не задано, используется стандартный src/web/img/load.svg из расширения.
        'lazyloadPlaceholderUrl' => null,
    ],
],
'components' => [
    'request' => [
        'baseUrl' => '/admin',
    ],
    'user' => [
        'identityClass' => common\models\User::class,
        'enableAutoLogin' => true,
        'loginUrl' => ['/login'],
    ],
    'authManager' => [
        'class' => yii\rbac\DbManager::class,
    ],
    'urlManager' => [
        'enablePrettyUrl' => true,
        'showScriptName' => false,
        'rules' => [
            '' => 'admin/site/index',
            'admin/error' => 'admin/site/error',
            'login' => 'admin/auth/auth/login',
            'auth/login' => 'admin/auth/auth/login',
            'auth/logout' => 'admin/auth/auth/logout',
            'auth/captcha' => 'admin/auth/auth/captcha',
            'auth/invite' => 'admin/auth/auth/invite',
            'auth/request-password-reset' => 'admin/auth/auth/request-password-reset',
            'auth/reset-password' => 'admin/auth/auth/reset-password',
            'auth/security-log' => 'admin/auth/auth/security-log',
            'auth/clear-security-log' => 'admin/auth/auth/clear-security-log',
            'rbac' => 'admin/rbac/default/index',
            'rbac/' => 'admin/rbac//index',
            'rbac//' => 'admin/rbac//',
            'rbac///' => 'admin/rbac//',
            'rbac///' => 'admin/rbac//',
        ],
    ],
    'errorHandler' => [
        // Обязательно: чтобы 403/404/500 внутри админки рендерились шаблоном расширения.
        'errorAction' => '/admin/site/error',
    ],
],
```

Примечание по `rules`: порядок важен. Сохраняйте этот блок целиком, а project-specific правила добавляйте так, чтобы не ломать маршруты `auth/*` и `rbac/*`.

### Error page (обязательно)

[](#error-page-обязательно)

Чтобы использовался шаблон ошибки из расширения (`@larikmc/admin/views/site/error.php`), в приложении должен быть задан:

```
'components' => [
    'errorHandler' => [
        'errorAction' => '/admin/site/error',
    ],
],
```

Без этого Yii может показывать стандартную страницу ошибки вместо оформленной страницы админки.

### Важные пути для входа (рекомендуемый вариант)

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

Чтобы страница входа открывалась по короткому URL:

- `https://your-domain/admin/login`

используйте такую связку:

1. `request.baseUrl = '/admin'`
2. `user.loginUrl = ['/login']`
3. правило `urlManager`: `'login' => 'admin/auth/auth/login'`
4. правило `urlManager`: `'auth/captcha' => 'admin/auth/auth/captcha'`

Если у вас есть глобальная проверка доступа в `on beforeRequest`, обязательно добавьте в whitelist:

- `login`
- `auth/login`
- `auth/captcha`
- `auth/request-password-reset`
- `auth/reset-password`
- `auth/invite`
- `admin/login`
- `admin/auth/login`
- `admin/auth/captcha`
- `admin/auth/request-password-reset`
- `admin/auth/reset-password`
- `admin/auth/invite`

Иначе можно получить цикл редиректов (`ERR_TOO_MANY_REDIRECTS`) на странице входа.

### Схема доступа

[](#схема-доступа)

Рекомендуемая схема разделения доступа:

- `adminPanel` дает право войти в админку
- `admin` дает доступ к рабочим backend-контроллерам и административным разделам

То есть:

1. пользователь без `adminPanel` не должен попадать в `/admin`
2. пользователь с `adminPanel`, но без `admin`, может пройти только уровень входа в админку
3. backend-контроллеры, dashboard, RBAC и security log должны быть закрыты ролью `admin`

### Security Model

[](#security-model)

Матрица доступа по умолчанию:

- `adminPanel` — право пройти в `/admin`
- `admin` — право работать с backend-контроллерами
- `admin` — право видеть dashboard и внутренние admin-страницы
- `admin` — право работать с RBAC
- `admin` — право просматривать и очищать security log

Коротко:

- `adminPanel` = вход в админку
- `admin` = вся рабочая часть админки

Меню
----

[](#меню)

Основное меню и нижнее меню задаются через:

- `menu`
- `secondaryMenu`

По умолчанию пакет использует схему, совпадающую с текущим UI:

- `menu`: dashboard + dropdown `Администрирование` с `RBAC`, `Инвайт администратора` и `Security Log`
- `secondaryMenu`: только `ADMIN-UI-KIT`

Важно:

- ссылки `На сайт`, `Очистить кеш`, `Выйти` не должны дублироваться в `secondaryMenu`
- эти действия уже встроены в topbar layout и находятся справа в шапке
- если добавить их ещё и в `secondaryMenu`, получится старый дублирующийся sidebar-паттерн, который больше не является эталонным для пакета

Пример:

```
'modules' => [
    'admin' => [
        'class' => larikmc\admin\Module::class,
        'userClass' => common\models\User::class,
        'userModel' => common\models\User::class,
        'menu' => [
            [
                'icon' => 'dashboard',
                'label' => 'Панель управления',
                'url' => ['/admin/site/index'],
            ],
            [
                'icon' => 'admin_panel_settings',
                'label' => 'Администрирование',
                'items' => [
                    ['label' => 'RBAC', 'url' => ['/rbac/default/index']],
                    ['label' => 'Инвайт администратора', 'url' => ['/rbac/invite/index']],
                    ['label' => 'Security Log', 'url' => ['/auth/security-log']],
                ],
            ],
        ],
        'secondaryMenu' => [
            [
                'icon' => 'palette',
                'label' => 'ADMIN-UI-KIT',
                'url' => ['/admin/site/ui-kit'],
            ],
        ],
    ],
],
```

Авторизация
-----------

[](#авторизация)

В пакет уже встроен модуль авторизации:

- форма входа
- встроенное восстановление пароля для админки
- brute-force защита
- CAPTCHA после нескольких попыток
- lock по IP и email
- security log
- регистрация администратора по одноразовой ссылке

Маршруты:

- `GET/POST /admin/auth/login`
- `GET/POST /admin/auth/request-password-reset`
- `GET/POST /admin/auth/reset-password?token=...`
- `GET/POST /admin/auth/invite?token=...`
- `POST /admin/auth/logout`
- `GET /admin/auth/captcha`
- `GET /admin/auth/security-log`
- `POST /admin/auth/clear-security-log`

Внутри пакета используются короткие маршруты `/auth/*`, поэтому их нужно пробросить через `urlManager`.

### Восстановление пароля

[](#восстановление-пароля)

В странице входа уже встроена ссылка `Забыли пароль?`.

Сценарий работы:

1. пользователь открывает `/admin/auth/request-password-reset`
2. вводит email
3. интерфейс всегда показывает одинаковое нейтральное success-состояние
4. письмо реально отправляется только если пользователь существует, имеет доступ `adminPanel`, модель поддерживает reset-token и в приложении настроен `mailer`

Это сделано специально, чтобы не раскрывать, какие email существуют в админке.

После успешной отправки форма скрывается, а на странице остается только сообщение и ссылка возврата ко входу.

### Инвайт администратора

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

В пакет встроен сценарий регистрации нового администратора по одноразовой ссылке.

Сценарий работы:

1. администратор открывает `/admin/rbac/invite`
2. генерирует ссылку приглашения
3. ссылка автоматически копируется в буфер обмена
4. приглашенный пользователь открывает `/admin/auth/invite?token=...`
5. проходит регистрацию
6. после регистрации автоматически получает роль `admin` и попадает в админку

Ограничения:

- генерация invite-ссылки доступна пользователям с ролью `admin`
- invite одноразовый
- системные ограничения для `ID=1` относятся к защите root-администратора (роль `admin` не снимается), а не к генерации invite

Совместимость с моделью пользователя:

- если в проекте нет колонки `username`, задайте `usernameField = 'email'`
- invite-регистрация автоматически подстроится и не будет выполнять SQL по `username`
- если `username` есть как отдельное поле, форма invite продолжает работать в классическом режиме (логин + email + пароль)

RBAC
----

[](#rbac)

В пакет уже встроен RBAC-раздел:

- роли
- действия
- назначения ролей пользователям
- генерация одноразовых invite-ссылок для новых администраторов

Маршруты:

- `/admin/rbac`
- `/admin/rbac/user`
- `/admin/rbac/role`
- `/admin/rbac/permission`
- `/admin/rbac/assignment`
- `/admin/rbac/invite`

### Системные элементы

[](#системные-элементы)

При установке RBAC автоматически создаются:

- роль `admin`
- действие `adminPanel`
- связь `admin -> adminPanel`
- назначение роли `admin` пользователю `ID=1`

Системные инварианты:

- пользователь с `ID=1` является системным администратором и не может быть лишен роли `admin`
- роль `admin` является системной и не может быть удалена
- действие `adminPanel` является системным и не может быть удалено
- связь `admin -> adminPanel` должна существовать всегда
- у пользователя с `ID=1` роль `admin` должна сохраняться всегда
- генерация invite-ссылок доступна пользователям с ролью `admin`

Связь системных прав:

- `adminPanel` считается системным permission для входа в админку
- роль `admin` должна включать `adminPanel`
- назначение только `adminPanel` без роли `admin` можно использовать как технический допуск на уровень входа, но не как доступ к backend-разделам

Troubleshooting
---------------

[](#troubleshooting)

### Показывается дефолтная страница ошибки Yii вместо админской

[](#показывается-дефолтная-страница-ошибки-yii-вместо-админской)

Проверьте, что в конфиге приложения задано:

```
'errorHandler' => [
    'errorAction' => '/admin/site/error',
],
```

Также проверьте rule:

```
'admin/error' => 'admin/site/error',
```

### Пропали стили в админке или отображается "голый" UI

[](#пропали-стили-в-админке-или-отображается-голый-ui)

Обычно это кеш опубликованных ассетов. Выполните:

1. очистку `web/assets/*`
2. очистку кеша приложения
3. `Ctrl+F5` в браузере

### Циклический редирект на странице логина

[](#циклический-редирект-на-странице-логина)

Проверьте связку:

- `request.baseUrl = '/admin'`
- `user.loginUrl = ['/login']`
- правило `'login' => 'admin/auth/auth/login'`
- whitelist маршрутов входа/капчи/reset/invite в `beforeRequest`-guard

### 403 на `/admin/rbac/invite`

[](#403-на-adminrbacinvite)

Генерация инвайтов доступна роли `admin`. Проверьте, что у пользователя назначена роль `admin` в RBAC.

Общий контейнер страниц
-----------------------

[](#общий-контейнер-страниц)

В пакет встроен виджет:

```
larikmc\admin\widgets\AdminPage
```

Он нужен для единообразных внутренних страниц модулей. Его можно использовать и в собственных admin-разделах.

Пример:

```
echo \larikmc\admin\widgets\AdminPage::widget([
    'title' => 'Моя страница',
    'subtitle' => 'Короткое описание раздела',
    'actions' => [
        \yii\bootstrap5\Html::a('Создать', ['create'], ['class' => 'btn btn-success']),
    ],
    'content' => 'Контент страницы',
]);
```

### sz-panel

[](#sz-panel)

Базовый визуальный контейнер админки:

```
.sz-panel
```

Он задает:

- белый фон
- внутренние отступы
- скругление
- тень карточки

Используйте его для списков, форм, таблиц и detail-экранов, если нужен единый стиль панели.

Важно: не генерируйте для этого расширения лишнюю разметку (включая собственные breadcrumbs, дополнительные обертки под стили и отдельные UI-каркасы), если используете штатный layout админки. Виджет `AdminPage`, меню и базовые стили уже встроены и подключаются самим пакетом.

Пример ручного использования:

```

```

Или для формы:

```

```

Если страница строится через `AdminPage`, панель можно получить автоматически:

```
echo \larikmc\admin\widgets\AdminPage::widget([
    'title' => 'Список товаров',
    'content' => \yii\grid\GridView::widget([...]),
]);
```

По умолчанию `AdminPage` оборачивает контент в `.sz-panel`.

Если панель нужна вручную в самом шаблоне, отключите автообертку:

```
echo \larikmc\admin\widgets\AdminPage::widget([
    'title' => 'Журнал безопасности',
    'boxed' => false,
    'content' => '...',
]);
```

Плоский вариант без карточки:

```
.sz-panel--flat
```

Важно:

- `sz-panel` это базовый surface-контейнер для внутренних блоков админки
- таблицы, формы, detail-view и типовые контентные секции должны жить внутри `sz-panel`, если не нужен осознанно плоский вариант
- для ручных alert-блоков не нужно возвращаться к bootstrap-default рамкам и фонам, если экран уже собирается из `sz-panel` и toast-паттернов

Lazyload и popup для изображений
--------------------------------

[](#lazyload-и-popup-для-изображений)

В расширение уже встроены:

- lazyload для изображений: `src/web/js/lazyloader.js`
- popup-просмотрщик оригинала: `src/web/js/image-viewer-admin.js`
- стили popup: `src/web/css/image-viewer-admin.css`

Все эти файлы подключаются через `larikmc\admin\assets\AppAsset`, поэтому при штатном layout `@larikmc/admin/views/layouts/main` ничего отдельно регистрировать не нужно.

Стандартный placeholder для lazyload уже лежит в расширении:

- `src/web/img/load.svg`

По умолчанию используется именно он. Если нужен свой placeholder, задайте его в конфиге модуля:

```
'modules' => [
    'admin' => [
        'class' => larikmc\admin\Module::class,
        'lazyloadPlaceholderUrl' => '@web/img/load.svg',
    ],
],
```

В view URL placeholder лучше получать через модуль:

```
$placeholder = Yii::$app->getModule('admin')->getLazyloadPlaceholderUrl($this);
```

### Базовый пример

[](#базовый-пример)

Миниатюра грузится лениво из `data-src`, а по клику открывается оригинал из `data-image-full`:

```
use yii\bootstrap5\Html;

$placeholder = Yii::$app->getModule('admin')->getLazyloadPlaceholderUrl($this);

echo Html::a(
    Html::img($placeholder, [
        'data-src' => '/uploads/images/thumbs/item-123.webp',
        'class' => 'sz-thumb__img',
        'alt' => 'Изображение #123',
        'loading' => 'lazy',
        'decoding' => 'async',
    ]),
    '/uploads/images/original/item-123.jpg',
    [
        'data-pjax' => '0',
        'data-image-viewer' => true,
        'data-image-full' => '/uploads/images/original/item-123.jpg',
        'data-image-title' => 'Изображение #123',
        'class' => 'sz-thumb',
        'style' => 'width:100px;height:72px;',
    ]
);
```

Что здесь важно:

- `img[data-src]` — URL миниатюры, которую нужно показать в таблице или списке
- `img[src]` — placeholder, по умолчанию стандартный `load.svg` из расширения
- `a[data-image-full]` — URL полного изображения для popup
- `a[href]` — fallback для popup и обычная ссылка, если JS не загрузился
- `a.sz-thumb` — готовый контейнер, который центрирует placeholder и миниатюру, но не диктует размер
- `img.sz-thumb__img` — картинка внутри контейнера, вписывается без растягивания
- `data-pjax="0"` — желательно для ссылок внутри `GridView`/PJAX, чтобы клик не перехватывался PJAX

Размер задаётся проектом:

```
['class' => 'sz-thumb', 'style' => 'width:100px;height:72px;']
```

Или готовым модификатором для типовых случаев:

- `sz-thumb sz-thumb--sm` — 72x56
- `sz-thumb sz-thumb--lg` — 140x96
- `sz-thumb sz-thumb--cover` — изображение заполняет контейнер через `object-fit: cover`

### Если миниатюра и оригинал совпадают

[](#если-миниатюра-и-оригинал-совпадают)

Можно не указывать `data-image-full`: popup возьмёт URL из `href`.

```
$placeholder = Yii::$app->getModule('admin')->getLazyloadPlaceholderUrl($this);

echo Html::a(
    Html::img($placeholder, [
        'data-src' => '/uploads/images/item-123.jpg',
        'class' => 'sz-thumb__img',
        'alt' => 'Изображение #123',
    ]),
    '/uploads/images/item-123.jpg',
    [
        'data-pjax' => '0',
        'data-image-viewer' => true,
        'data-image-title' => 'Изображение #123',
        'class' => 'sz-thumb',
        'style' => 'width:100px;height:72px;',
    ]
);
```

### Пример для GridView

[](#пример-для-gridview)

```
$placeholder = Yii::$app->getModule('admin')->getLazyloadPlaceholderUrl($this);

[
    'attribute' => 'image',
    'format' => 'raw',
    'value' => static function ($model) use ($placeholder) {
        $thumb = '/uploads/images/items/thumbs/' . $model->image . '.webp';
        $original = '/uploads/images/items/original/' . $model->image . '.jpg';

        return \yii\bootstrap5\Html::a(
            \yii\bootstrap5\Html::img($placeholder, [
                'data-src' => $thumb,
                'class' => 'sz-thumb__img',
                'alt' => '',
                'loading' => 'lazy',
                'decoding' => 'async',
            ]),
            $original,
            [
                'data-pjax' => '0',
                'data-image-viewer' => true,
                'data-image-full' => $original,
                'data-image-title' => 'Изображение #' . $model->id,
                'class' => 'sz-thumb',
                'style' => 'width:100px;height:72px;',
            ]
        );
    },
]
```

### Legacy-вариант с onclick

[](#legacy-вариант-с-onclick)

Старый backend-паттерн тоже поддерживается:

```
$placeholder = Yii::$app->getModule('admin')->getLazyloadPlaceholderUrl($this);

echo '' .
    '' .
    '';
```

Новый вариант без inline `onclick` предпочтительнее: достаточно атрибута `data-image-viewer`.

### Поддерживаемые атрибуты

[](#поддерживаемые-атрибуты)

- `data-src` на `img` — лениво подставляется в `src`
- `data-srcset` на `img` — лениво подставляется в `srcset`
- `data-no-placeholder` на `img` — не добавлять класс `lazy-img`
- `data-image-viewer` на ссылке — включает popup по клику
- `data-image-full` на ссылке — оригинал для popup
- `data-image-title` на ссылке — подпись под изображением
- `title` на ссылке — fallback для подписи
- `href` на ссылке — fallback для оригинала

### Где должен лежать placeholder

[](#где-должен-лежать-placeholder)

Если вы ничего не настраиваете, placeholder берётся из расширения:

```
src/web/img/load.svg

```

После публикации Yii asset'ов он будет доступен по URL опубликованного `AppAsset`.

Если в конкретном проекте нужен другой spinner/placeholder, положите его в web-root проекта, например:

```
backend/web/img/load.svg

```

и укажите:

```
'lazyloadPlaceholderUrl' => '@web/img/load.svg',
```

Можно указать и абсолютный URL:

```
'lazyloadPlaceholderUrl' => 'https://cdn.example.com/admin/load.svg',
```

### Обновление после AJAX/PJAX

[](#обновление-после-ajaxpjax)

При обычной загрузке страницы lazyload стартует сам. Если контент добавлен динамически, можно переинициализировать изображения внутри контейнера:

```
lazyloader.init(document.querySelector('#pjax-container'));
```

Если используется Yii PJAX:

```
document.addEventListener('pjax:end', function (event) {
    if (window.lazyloader) {
        window.lazyloader.init(event.target);
    }
});
```

Popup использует делегирование клика на `document`, поэтому для новых ссылок с `data-image-viewer` повторная инициализация не нужна.

UI и grouped action-кнопки
--------------------------

[](#ui-и-grouped-action-кнопки)

В расширение уже встроены:

- общий layout админки
- базовые UI-стили
- переопределённые bootstrap-кнопки `.btn-*`
- стилизованные bootstrap-badges `.badge.text-bg-*`
- стили таблиц
- grouped action-кнопки в `GridView`
- showcase-страница `ADMIN-UI-KIT`

### Bootstrap-кнопки

[](#bootstrap-кнопки)

Расширение не требует заводить отдельные "новые" классы для основных кнопок.

Вместо этого переопределяются стандартные bootstrap-классы:

- `.btn-primary`
- `.btn-secondary`
- `.btn-success`
- `.btn-danger`
- `.btn-warning`
- `.btn-info`
- `.btn-light`
- `.btn-outline-*`

Это сделано специально, чтобы существующие view на `Yii2 + Bootstrap 5` автоматически подхватывали новый стиль без массового переименования классов.

### Bootstrap badges

[](#bootstrap-badges)

Аналогично, для статусов и коротких меток используется стандартный bootstrap-формат:

- `.badge`
- `.text-bg-primary`
- `.text-bg-secondary`
- `.text-bg-success`
- `.text-bg-danger`
- `.text-bg-warning`
- `.text-bg-info`
- `.text-bg-light`
- `.text-bg-dark`

То есть статусы и label-метки теперь лучше строить именно через bootstrap badges, а не через отдельные кастомные status-компоненты.

### ADMIN-UI-KIT

[](#admin-ui-kit)

Внутри пакета есть отдельная служебная страница:

- `/admin/site/ui-kit`

Она нужна как showcase текущего визуального языка:

- solid buttons
- outline buttons
- badges
- metric card
- grouped action-column buttons

Удобно использовать её как reference, когда нужно повторить стиль в собственных backend-разделах.

То есть такие кнопки, как `view/edit/delete`, уже оформлены внутри пакета и не требуют ручного копирования CSS в проект, если используется штатный layout и asset bundle расширения.

Topbar и H1
-----------

[](#topbar-и-h1)

В текущем layout заголовок страницы показывается в topbar автоматически через `$this->title`.

Это значит:

- topbar `H1` приходит не из `AdminPage`, а из layout `src/views/layouts/main.php`
- параметр `showHeader` в `AdminPage` управляет только внутренним заголовком внутри контента страницы
- `showHeader => false` нужен как раз для того, чтобы не дублировать один и тот же заголовок и subtitle под topbar
- для RBAC, security log и типовых CRUD-экранов `showHeader => false` является нормальным сценарием, если `title` уже выведен в topbar

Важно:

- в пакете нет рабочего параметра `showTopbarTitle`
- попытка "чинить" отсутствие заголовка через `$this->params['showTopbarTitle'] = true` является неправильной, потому что layout этот параметр не использует
- если topbar `H1` пропал, нужно проверять `layout`, `$this->title`, переопределённые view и фактическую версию пакета, а не размазывать по vendor-view несуществующий флаг

Важно понимать:

- если в другом проекте grouped-кнопки "не получились", это обычно не значит, что нужно просто вручную вставить CSS из README
- чаще причина в одном из пунктов:
    - не подключился asset bundle расширения
    - в `ActionColumn` другой `template`
    - не проставлен класс `action-column`
    - не проставлен класс `sz-row-action`
    - не подключены `Material Symbols`

Подробная техническая шпаргалка по этим кнопкам описана в разделе `UI guide` ниже.

UI guide
--------

[](#ui-guide)

Этот раздел описывает текущий UI-слой админки `larikmc/yii2-admin`.

### Где находится UI

[](#где-находится-ui)

- Layout: `src/views/layouts/main.php`
- Базовые стили: `src/web/css/style.css`
- Сайдбар: `src/web/css/dashboard.css`
- Главная dashboard-страница: `src/views/site/index.php`
- Стили dashboard-страницы: `src/web/css/home.css`
- JS для sidebar / dropdown / toast: `src/web/js/dashboard.js`
- Asset bundle: `src/assets/AppAsset.php`

### Как устроен текущий дизайн

[](#как-устроен-текущий-дизайн)

- Основа интерфейса: светлый glass/panel стиль на cold blue/slate палитре.
- Сайдбар: тёмный, глубокий, с мягкой подсветкой и active-state у текущего пункта.
- Верхняя шапка: compact topbar с breadcrumbs и заголовком слева, utility-кнопками и аккаунтом справа.
- Карточки: крупные радиусы, мягкие границы, лёгкие градиенты, без тяжёлых bootstrap-рамок.
- Таблицы: стандартный Yii `GridView`, но actions и часть UI переоформлены вручную.

### Текущие UI-правила

[](#текущие-ui-правила)

- Не возвращать стандартные bootstrap alert'ы. Вместо них используются toast-уведомления справа сверху.
- Не дублировать один и тот же смысл в topbar и в контенте страницы.
- Для CRUD-страниц используется схема:
- topbar: breadcrumbs + title
- ниже отдельная actions-bar с кнопками
- ниже основной контент
- Для dashboard используется тот же compact topbar, что и для внутренних разделов.
- Кнопки действий в таблицах должны оставаться grouped, иконки в одной группе, без промежутков между сегментами.
- Аккаунт справа открывает dropdown только с logout-действием.

### Быстрые действия в topbar

[](#быстрые-действия-в-topbar)

Справа в шапке сейчас есть:

- переход на сайт
- очистка кеша
- аккаунт с dropdown

Все три элемента должны выглядеть как единый набор: одинаковая высота, близкие радиусы, одна визуальная система.

### Dashboard

[](#dashboard)

Главная страница строится из двух зон:

- верхний hero-инфоблок
- сетка status-карточек

Текущее правило для hero:

- заголовок приветствия находится в topbar, а не внутри hero
- внутри hero остаётся только красиво оформленная системная информация

### Табличные action-кнопки

[](#табличные-action-кнопки)

Текущая реализация:

- используются `Material Symbols`
- ссылки имеют класс `sz-row-action`
- в `ActionColumn` кнопки должны быть сгруппированы визуально как единая button-group
- hover без подъёма

Если править таблицы, лучше не полагаться только на `.action-column a`, а оставлять явный класс `sz-row-action`.

### Что важно не сломать

[](#что-важно-не-сломать)

- `appendTimestamp` и `forceCopy` уже включались в приложении, чтобы assets обновлялись корректно
- layout и стили правятся в локальном пакете `d:\OpenServer6.5.0\home\yii2-admin`, а не только в приложении
- для CRUD-страниц часть view лежит уже в самом проекте `backend/views/...`
- для RBAC часть view лежит внутри пакета `src/rbac/views/...`

### Если нужно продолжать развитие UI

[](#если-нужно-продолжать-развитие-ui)

Предпочтительные направления:

- унифицировать все `GridView` фильтры и toolbar
- держать одинаковую высоту topbar во всех разделах
- не добавлять лишний текст в hero и header
- сохранять холодную slate/blue палитру без слишком ярких кислотных акцентов
- новые элементы делать в том же стиле: мягкий border, glass-light background, крупный radius

### Перед правками полезно проверить

[](#перед-правками-полезно-проверить)

- `src/views/layouts/main.php`
- `src/web/css/style.css`
- `src/web/css/home.css`
- конкретную view проекта, если страница переопределена в `backend/views/...`

### После правок

[](#после-правок)

- использовать жёсткое обновление страницы: `Ctrl+F5`
- при сомнениях проверять опубликованные assets Yii
- для PHP view-файлов полезно гонять `php -l`

Структура пакета
----------------

[](#структура-пакета)

```
yii2-admin/
├─ src/
│  ├─ assets/
│  ├─ auth/
│  ├─ config/
│  ├─ controllers/
│  ├─ rbac/
│  ├─ views/
│  ├─ web/
│  ├─ widgets/
│  └─ Module.php
├─ composer.json
└─ README.md

```

Идея пакета
-----------

[](#идея-пакета)

Это не набор из трех независимых расширений, а одна backend-платформа:

- `admin shell`
- `auth`
- `rbac`

Именно поэтому пакет удобнее ставить и поддерживать как одно расширение.

Лицензия
--------

[](#лицензия)

BSD-3-Clause

###  Health Score

44

—

FairBetter than 91% of packages

Maintenance94

Actively maintained with recent releases

Popularity12

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity54

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% 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 ~2 days

Total

33

Last Release

28d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/d03ff5526e05d1e701ec823faaa49134255a290c743fbccf0aed8395ad22cac1?d=identicon)[larikmc](/maintainers/larikmc)

---

Top Contributors

[![larikmc](https://avatars.githubusercontent.com/u/24361208?v=4)](https://github.com/larikmc "larikmc (39 commits)")

### Embed Badge

![Health badge](/badges/larikmc-yii2-admin/health.svg)

```
[![Health](https://phpackages.com/badges/larikmc-yii2-admin/health.svg)](https://phpackages.com/packages/larikmc-yii2-admin)
```

###  Alternatives

[craftcms/cms

Craft CMS

3.6k3.6M2.9k](/packages/craftcms-cms)[fancyecommerce/fec_admin

fancy ecommerce

6312.2k1](/packages/fancyecommerce-fec-admin)[dmstr/yii2-backend-module

Admin Dashboard

1974.1k3](/packages/dmstr-yii2-backend-module)

PHPackages © 2026

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