yii2 adminlte asset

Пакет ресурсов AdminLTE

Внутренний интерфейс для Yii2 Framework, основанный на AdminLTE.

Этот пакет содержит пакет ресурсов для Yii 2.0 Framework, который регистрирует файлы CSS для пользовательского интерфейса AdminLTE.

Файлы CSS устанавливаются с помощью рекомендуемого Yii использования плагина fxp/composer-asset-plugin v1.1.1 или более поздней версии.

Установка

Предпочтительный способ установки этого расширения — через композитор.

Чтобы установить AdminLTE v2, выполните:

 composer require dmstr/yii2-adminlte-asset "^2.1"

Чтобы установить AdminLTE v1, выполните:

 composer require dmstr/yii2-adminlte-asset "^1"

Часто задаваемые вопросы

Использование веб-шрифтов

AdminLTE отказался от включения веб-шрифтов в 2.4.0 , поэтому вам нужно включить нужный шрифт вручную, т.е.

 <link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Source+Sans+Pro:300,400,600,700,300italic,400italic,600italic">

Включение через CDN не рекомендуется для рабочей среды. Приспособьте это к рабочему процессу объединения ресурсов вашего проекта.

Подробности см. в № 140.

Обновление

При обновлении ознакомьтесь с руководством по обновлению AdminLTE, чтобы узнать, какие изменения необходимо внести в представления.

Установка композитора

• По вопросам, связанным с DmitryBaranovskiy/eve.git , смотрите #128 и #113.

Матрица совместимости

yii2-adminlte-актив	АдминистраторLTE	Шрифт Awesome
2.4	2,0 - 2,3	необходимый
2,5	2.4	необходимый
3.0	2.4	-

При возникновении других проблем сначала выполните поиск на GitHub.

Быстрый старт

После установки расширения вы можете получить предварительный просмотр , перенастроив сопоставления путей компонента представления:

Для расширенного шаблона приложения Yii 2 или базового шаблона приложения

 ' components ' => [
    ' view ' => [
         ' theme ' => [
             ' pathMap ' => [
                ' @app/views ' => ' @vendor/dmstr/yii2-adminlte-asset/example-views/yiisoft/yii2-app '
             ],
         ],
    ],
],

Для приложения phd5

 ' components ' => [
    ' view ' => [
        ' theme ' => [
            ' pathMap ' => [
                ' @app/views ' => ' @vendor/dmstr/yii2-adminlte-asset/example-views/testing/app '
            ],
        ],
    ],
],

Этот пакет ресурсов предоставляет образцы файлов для макета и просмотра (см. папку examples/ ), они не предназначены для настройки непосредственно в папке vendor/ .

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

Кастомизация

• Скопируйте файлы из vendor/dmstr/yii2-adminlte-asset/example-views/yiisoft/yii2-app (или другой темы) в @app/views .
• Удалите конфигурацию пользовательского view из вашего приложения, удалив сопоставления путей, если вы сделали их ранее.
• Отредактируйте свои представления, придерживаясь HTML- vendor/almasaeed2010/adminlte/pages

Административные плагиныLTE

Ресурсы для плагинов AdminLTE не включены в наш AdminLteAsset но вы можете найти эти файлы в каталоге вашего поставщика в vendor/almasaeed2010/adminlte/plugins . Поэтому, если вы хотите использовать любой из них, мы рекомендуем создать собственный пакет, в котором вы перечислите необходимые вам файлы плагина:

 use yii  web  AssetBundle ;
class AdminLtePluginAsset extends AssetBundle
{
    public $ sourcePath = ' @vendor/almasaeed2010/adminlte/plugins ' ;
    public $ css = [
        ' chart.js/Chart.min.css ' ,
        // more plugin CSS here
    ];
    public $ js = [
        ' chart.js/Chart.bundle.min.js '
        // more plugin Js here
    ];
    public $ depends = [
        ' dmstradminltewebAdminLteAsset ' ,
    ];
}

Поскольку этот ресурс зависит от нашего AdminLteAsset это единственный актив, который вам необходимо зарегистрировать, например, в файле макета main.php .

Пользовательский заголовок контента

Если вы хотите использовать собственный DOM заголовков AdminLTE

 < h1 >
    About < small > static page </ small >
</ h1 >

то вы можете следовать коду:

 /* @var yiiwebView $this */

$ this -> params [ ' breadcrumbs ' ][] = ' About ' ;

$ this -> beginBlock ( ' content-header ' ); ?>
About <small>static page</small>
<?php $ this -> endBlock (); ?>

<div class="site-about">
    <p> This is the About page. You may modify the following file to customize its content: </p>
    <code> <?= __FILE__ ?> </code>
</div>

Меню левой боковой панели — Меню виджетов

Если вам нужно разделить разделы меню, просто добавьте опцию header к элементу в items

    ' items ' => [
        [ ' label ' => ' Gii ' , ' iconType ' => ' far ' 'icon' => 'file-code', ' url ' => [ ' /gii ' ]],
        [ ' label ' => ' Debug ' , ' icon ' => ' dashboard-alt ' , ' url ' => [ ' /debug ' ]],
        [ ' label ' => ' MAIN NAVIGATION ' , ' header ' => true ], // here
        // ... a group items
        [ ' label ' => '' , ' header ' => true ],
        // ... a group items
        [ ' label ' => '' , ' header ' => true ],
        // ... a group items

Чтобы добавить значок для предмета:

 ' items ' => [
    [
        ' label ' => ' Mailbox ' ,
        ' iconType ' => ' far ' ,
        ' icon ' => ' envelope ' ,
        ' url ' => [ ' /mailbox ' ],
        ' badge ' => ' <span class="badge badge-info right">123</span> '
    ],
]

По умолчанию к иконкам будет добавлен префикс Font Awesome.

Шаблон для генератора Gii CRUD

Расскажите Gii о нашем шаблоне. Настройка производится в конфигурационном файле:

 if ( YII_ENV_DEV ) {
    $ config [ ' modules ' ][ ' gii ' ] = [
        ' class ' => ' yiigiiModule ' ,
        ' generators ' => [ // HERE
            ' crud ' => [
                ' class ' => ' yiigiigeneratorscrudGenerator ' ,
                ' templates ' => [
                    ' adminlte ' => ' @vendor/dmstr/yii2-adminlte-asset/gii/templates/crud/simple ' ,
                ]
            ]
        ],
    ];
}

Тестирование

Перейдите в папку тестов и запустите стек тестирования.

 cd tests
docker-compose up -d

Установите yii2-adminlte-asset в тестовом приложении.

 docker-compose exec php composer install

Откройте URL-адреса тестирования в своем браузере

 http://docker.local:20580/test
http://docker.local:20580/test/login    

Дополнительная информация

Документацию по AdminLTE можно найти по адресу https://almsaeedstudio.com/themes/AdminLTE/documentation/index.html.

Правила пространства имен соответствуют структуре структуры Yii 2.0, например. dmstradminlteweb для пакета ресурсов.