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

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

mitisk/yii2-admin
=================

Админка для проектов Yii2

v1.5.2(2mo ago)210MITPHPPHP &gt;=8.1

Since Jan 2Pushed 2mo ago1 watchersCompare

[ Source](https://github.com/Mitisk/yii2-admin)[ Packagist](https://packagist.org/packages/mitisk/yii2-admin)[ RSS](/packages/mitisk-yii2-admin/feed)WikiDiscussions master Synced today

READMEChangelog (7)Dependencies (9)Versions (9)Used By (0)

 [![Logo](assets/img/logo.png)](assets/img/logo.png)

Yii2 Admin Module
=================

[](#yii2-admin-module)

[![Latest Stable Version](https://camo.githubusercontent.com/33e13b812fb77d108dfea486bde58825fd727b74a57ed69fa7d7942ac59cfda6/68747470733a2f2f706f7365722e707567782e6f72672f6d697469736b2f796969322d61646d696e2f762f737461626c65)](https://packagist.org/packages/mitisk/yii2-admin)[![Total Downloads](https://camo.githubusercontent.com/72e86fdda6a958efa2032713eecccff0ebf0499ec114ef1e4b8ca8c680131574/68747470733a2f2f706f7365722e707567782e6f72672f6d697469736b2f796969322d61646d696e2f646f776e6c6f616473)](https://packagist.org/packages/mitisk/yii2-admin)

Модуль административной панели для Yii2 приложений. Предоставляет готовый интерфейс для управления пользователями, настройками, меню и другими аспектами системы.

📋 Основные возможности
----------------------

[](#-основные-возможности)

- **Управление пользователями**: CRUD операции, назначение ролей (RBAC), блокировка/активация.
- **Сброс пароля**: Функционал генерации и отправки нового пароля пользователю на email.
- **Имперсонация**: Возможность входа под другим пользователем ("Login As") для отладки.
- **Управление настройками**: Глобальное хранилище настроек (key-value) с удобным интерфейсом.
- **Email шаблоны**: Управление шаблонами писем с поддержкой плейсхолдеров.
- **SEO-правила**: Динамическое управление мета-тегами по URL-паттернам с поддержкой плейсхолдеров.
- **RBAC**: Для управления ролями и разрешениями.
- **Меню**: Динамическое управление пунктами меню.

---

⚙️ Установка и Настройка
------------------------

[](#️-установка-и-настройка)

Предпочтительный способ установки — через [composer](http://getcomposer.org/download/).

Запустите:

```
composer create-project --prefer-dist yiisoft/yii2-app-basic .
composer require mitisk/yii2-admin
composer require aws/aws-sdk-php //Если планируется использовать S3
```

Отредактируйте db.php. Для создания таблиц в БД выполните команду:

```
php yii migrate --migrationPath=@vendor/mitisk/yii2-admin/migrations
```

> После применения миграций будет создан администратор по умолчанию:
>
> - **Login**: `admin`
> - **Password**: `123456`

### 1. Подключение модуля

[](#1-подключение-модуля)

Добавьте модуль в конфигурацию вашего приложения (`config/web.php` или `common/config/main.php`):

```
'modules' => [
    'admin' => [
        'class' => 'Mitisk\Yii2Admin\Module',
        //'layout' => 'admin', // Используемый лейаут
    ],
    // ...
],
```

### 2. Настройка компонентов

[](#2-настройка-компонентов)

#### Settings Component

[](#settings-component)

Для работы с настройками зарегистрируйте компонент:

```
'components' => [
    'settings' => [
        'class' => 'Mitisk\Yii2Admin\components\SettingsComponent',
    ],
    // ...
],
```

Использование в коде:

```
// Сохранить настройку
Yii::$app->settings->set('Mitisk\Yii2Admin\models\Settings', 'api_key', 'your-key');

// Получить настройку
$apiKey = Yii::$app->settings->get('Mitisk\Yii2Admin\models\Settings', 'api_key');
```

#### Красивые URL

[](#красивые-url)

Пример конфигурации `urlManager`:

```
'components' => [
    'urlManager' => [
        'enablePrettyUrl' => true,
        'showScriptName' => false,
        'suffix' => '/',
        'normalizer' => [
            'class' => 'yii\web\UrlNormalizer',
            'normalizeTrailingSlash' => true,
            'collapseSlashes' => true,
        ],
        'rules' => [
            '/' => 'site/index',
        ]
        //'rules' => require_once(__DIR__ . '\url_rules.php'),
    ],
    // ...
],
```

#### Форматирование

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

Пример конфигурации `formatter`:

```
'components' => [
    'formatter' => [
        'class' => yii\i18n\Formatter::class,
        'locale' => 'ru-RU',
        'timeZone' => 'Europe/Moscow',
        'defaultTimeZone' => 'UTC',
        'dateFormat' => 'php:d MMMM Y',
        'timeFormat' => 'php:H:i:s',
        'datetimeFormat' => 'php:d MMMM Y H:i:s',
        'decimalSeparator' => ',',
        'thousandSeparator' => ' ',
        'currencyCode' => 'RUR',
    ],
    // ...
],
```

#### bootstrap

[](#bootstrap)

Пример конфигурации `bootstrap`:

```
'bootstrap' => ['log', 'admin'],
```

---

🚀 Функционал
------------

[](#-функционал)

### Управление пользователями (`UserController`)

[](#управление-пользователями-usercontroller)

Контроллер предоставляет полный набор действий для администрирования пользователей:

- **Просмотр и поиск**: Фильтрация списка пользователей.
- **Создание и Редактирование**: Управление профилем, аватаром и статусом.
- **Управление ролями**: Назначение и отзыв ролей RBAC прямо в форме редактирования.
- **Отправка нового пароля**:
    - Доступно в форме редактирования пользователя.
    - Генерирует случайный пароль.
    - Отправляет письмо по шаблону `new_user_password`.
    - Требует наличия email и типа авторизации "Пароль" или "Пароль + код".
- **Вход под пользователем**: Действие `login-as` позволяет администратору авторизоваться под любым пользователем.

### Виджет меню (`MenuWidget`)

[](#виджет-меню-menuwidget)

Для добавления пунктов меню в виджет используйте событие:

```
use Mitisk\Yii2Admin\widgets\MenuWidget;

Yii::$app->on(MenuWidget::EVENT_BEFORE_RENDER, function ($event) {
    $event->menuArray[] = [
        'label' => 'Новый пункт',
        'href' => '/new-item',
        'icon' => 'icon-name'
    ];
});
```

### Email Шаблоны

[](#email-шаблоны)

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

- **Модель**: `EmailTemplate`
- **Сервис**: `Mitisk\Yii2Admin\components\MailService`

Пример отправки письма:

```
$mailService = new \Mitisk\Yii2Admin\components\MailService();
$mailService->send('template_slug', 'user@example.com', [
    'PARAM1' => 'Value 1',
    'PARAM2' => 'Value 2',
]);
```

### SEO-правила (`SeoRuleController`)

[](#seo-правила-seorulecontroller)

Модуль динамического управления SEO-мета-тегами. Правила привязываются к URL через регулярные выражения и автоматически применяются на сайте.

**Админка** — раздел доступен по адресу `/admin/seo-rule/`. Позволяет создавать, редактировать, удалять и переключать активность правил.

#### Настройка компонента

[](#настройка-компонента)

Зарегистрируйте компонент `seo` в `config/web.php`:

```
'components' => [
    'seo' => [
        'class' => 'Mitisk\Yii2Admin\components\SeoManager',
    ],
    // ...
],
```

#### Вызов на сайте

[](#вызов-на-сайте)

В layout вашего приложения (или в `beforeAction` контроллера) зарегистрируйте мета-теги:

```
// В layout (например, views/layouts/main.php), перед :
Yii::$app->seo->register();
```

#### Передача динамических переменных

[](#передача-динамических-переменных)

Из контроллера передайте контекстные данные для подстановки в шаблоны:

```
// В экшене контроллера:
Yii::$app->seo->setContext([
    'category_name' => $category->name,
    'count' => $dataProvider->getTotalCount(),
    'brand' => $brand->title,
]);
```

В SEO-правиле используйте плейсхолдеры `{category_name}`, `{count}`, `{brand}`:

ПолеПример значенияURL паттерн`/catalog/.*`Title`{category_name} — купить в интернет-магазине ({count} шт.)`Description`Большой выбор {category_name}. В наличии {count} товаров.`Robots`index, follow`#### Поля SEO-правила

[](#поля-seo-правила)

ПолеОписаниеURL паттернРегулярное выражение для URL. Без разделителей оборачивается в `#...#iu`. С разделителями (`/`, `#`, `~`, `@`) — используется как есть.TitleМета-тег ``. Поддерживает плейсхолдеры.DescriptionМета-тег `description`. Поддерживает плейсхолдеры.KeywordsМета-тег `keywords`. Поддерживает плейсхолдеры.RobotsМета-тег `robots` (например: `index, follow`, `noindex, nofollow`).OG TitleOpen Graph `og:title`. Если пусто — фолбэк на Title.OG DescriptionOpen Graph `og:description`. Если пусто — фолбэк на Description.OG ImageOpen Graph `og:image`. Полный URL изображения.ПриоритетЦелое число. Чем выше — тем раньше проверяется правило. При совпадении нескольких паттернов применяется первый.АктивноВключает/отключает правило без удаления.#### Примеры URL-паттернов

[](#примеры-url-паттернов)

```
/catalog/.*          — все страницы каталога
/news/\d+            — страница новости по ID
^/contacts$          — точное совпадение с /contacts
/blog/(?!rss).*      — все страницы блога, кроме RSS
#^/product/[\w-]+#   — страница товара (с явным разделителем)

```

---

🔒 Права доступа (Permissions)
-----------------------------

[](#-права-доступа-permissions)

Основные разрешения, используемые в модуле:

- `viewUsers` - Просмотр списка пользователей.
- `createUsers` - Создание пользователей.
- `updateUsers` - Редактирование пользователей.
- `deleteUsers` - Удаление пользователей.
- `manageUserRoles` - Управление ролями пользователей.
- `admin` - Доступ к админ-панели и функции имперсонации.

---

📂 Структура
-----------

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

- `controllers/` - Контроллеры (User, Role, Settings, etc.)
- `models/` - Модели данных (AdminUser, Settings, EmailTemplate, etc.)
- `views/` - Представления админ-панели.
- `components/` - Служебные компоненты (MailService, SettingsComponent).
- `widgets/` - Виджеты интерфейса.

###  Health Score

39

—

LowBetter than 84% of packages

Maintenance85

Actively maintained with recent releases

Popularity8

Limited adoption so far

Community7

Small or concentrated contributor base

Maturity49

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 ~14 days

Recently: every ~22 days

Total

8

Last Release

79d ago

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/20151769?v=4)[Mitisk](/maintainers/Mitisk)[@Mitisk](https://github.com/Mitisk)

---

Top Contributors

[![Mitisk](https://avatars.githubusercontent.com/u/20151769?v=4)](https://github.com/Mitisk "Mitisk (73 commits)")

---

Tags

cmsyii2adminpanel

### Embed Badge

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

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

###  Alternatives

[craftcms/cms

Craft CMS

3.6k3.6M3.1k](/packages/craftcms-cms)[serverfireteam/panel

Admin panel for Laravel applications

43032.3k2](/packages/serverfireteam-panel)[luyadev/luya-module-admin

Administration core module for all LUYA admin modules

48182.7k24](/packages/luyadev-luya-module-admin)[fsi/admin-bundle

FSi Admin Bundle. Admin generator for Symfony.

5850.7k8](/packages/fsi-admin-bundle)

PHPackages © 2026

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