carono/yii2-metronic

Metronic v9 Tailwind admin theme for Yii2 — layouts, widgets and assets (demo3 sidebar + demo9 topnav)

dev-main 2026-06-06 07:44 UTC

Requires

• php: >=8.1
• carono/yii2-bower-asset: ~1.0
• npm-asset/apexcharts: ^3.45 || ^4.0
• npm-asset/canvas-confetti: ^1.9
• npm-asset/clipboard: ^2.0
• npm-asset/jquery: ^3.7
• yiisoft/yii2: ~2.0.45

Suggests

• npm-asset/--fullcalendar--core: FullCalendar widget
• npm-asset/datatables.net: Advanced data tables
• npm-asset/dropzone: Drag-and-drop file upload widget
• npm-asset/leaflet: Map widget
• npm-asset/prismjs: Code syntax highlighting
• npm-asset/tinymce: WYSIWYG editor widget

proprietary

• carono

• admin
• theme
• yii2
• metronic
• tailwind

README

Metronic v9 (Tailwind CSS) admin theme для Yii2. Пакет даёт два layout-а (demo3 — sidebar, demo9 — sticky topnav), готовые виджеты в стилистике KTUI и опубликованные через AssetBundle ассеты Metronic.

Установка

composer require carono/yii2-metronic

Для тяжёлых vendor-зависимостей (apexcharts, jquery и т.п.) пакет использует asset-packagist. Подключение через carono/yii2-bower-asset происходит автоматически.

Установка ассетов Metronic (обязательный шаг)

В репозитории не лежат лицензионные файлы Metronic (KTUI, Keenicons, скомпилированный Tailwind CSS, медиафайлы — всё это интеллектуальная собственность Keenthemes). Их нужно распаковать вручную в vendor/carono/yii2-metronic/src/web/metronic/ из официальной поставки.

1. Купите/получите Metronic v9 (Tailwind) на keenthemes.com.

2. Возьмите папку demo3/assets/ (или demo9/assets/ — содержимое одинаковое) из архива.

3. Скопируйте её целиком в пакет как metronic/:

   cp -r metronic-tailwind-html/demo3/assets vendor/carono/yii2-metronic/src/web/metronic

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

   src/web/metronic/
   ├── css/         (styles.css, core.bundle.css)
   ├── js/          (core.bundle.js, widgets/, layouts/)
   ├── vendors/     (ktui/, keenicons/)
   └── media/       (app/, avatars/, brand-logos/, flags/, illustrations/, …)
   

4. Сбросьте кэш опубликованных ассетов:

   rm -rf web/assets/*

Подробнее — vendor/carono/yii2-metronic/src/web/README.md.

Layouts

Подключаются как layout-файл в контроллере / приложении:

public $layout = '@vendor/carono/yii2-metronic/src/views/layouts/demo3';
// или
public $layout = '@vendor/carono/yii2-metronic/src/views/layouts/demo9';

Параметры меню/бренда — через Yii::$app->params:

'metronic.brand'       => 'My App',
'metronic.sidebar'     => [['label' => 'Dashboard', 'icon' => 'ki-filled ki-chart-line-star', 'url' => ['site/index']], ...],
'metronic.navbar'      => [...],
'metronic.topnav'      => [...],
'metronic.userMenu'    => [...],
'metronic.accountMenu' => [...],
'metronic.footerLinks' => [...],

Виджеты

carono\metronic\widgets\:

• Layout-составляющие — Header, Sidebar, Navbar, TopNav, Footer, Menu, Breadcrumbs
• Контейнеры — Card, Modal, Drawer, Tabs
• Списки/таблицы — GridView, ListView, ItemList, DetailView, MetronicLinkPager
• Атомы — Avatar, Badge, Alert, ActiveForm, ActiveField

carono\metronic\helpers\:

• Btn — kt-btn хелпер (variant/size/iconOnly)
• Media — URL картинок Metronic через AssetBundle

AssetBundles

carono\metronic\assets\:

• MetronicAsset — базовый (styles.css, keenicons, core.bundle.js, ktui.min.js, YiiAsset)
• ApexChartsAsset, JqueryAsset, ClipboardAsset, ConfettiAsset — npm-vendors через carono\yii2bower\NpmAsset
• GeneralWidgetsAsset — JS-виджеты главной страницы (карта, графики)

Готовый skeleton

Если нужен готовый Yii2-проект с этим шаблоном — используйте carono/yii2-metronic-basic:

composer create-project carono/yii2-metronic-basic myapp

Лицензия

Шаблон Metronic — проприетарный (см. лицензию Keenthemes). PHP-обёртки этого пакета — proprietary.