UI de back-end para Yii2 Framework, baseado em AdminLTE
Este pacote contém um Asset Bundle for Yii 2.0 Framework que registra os arquivos CSS para a interface de usuário AdminLTE.
Os arquivos CSS são instalados através do uso recomendado do Yii do fxp/composer-asset-plugin
v1.1.1 ou posterior.
A forma preferida de instalar esta extensão é através do compositor.
Para instalar o AdminLTE v2, execute:
composer require dmstr/yii2-adminlte-asset "^2.1"
Para instalar o AdminLTE v1, execute:
composer require dmstr/yii2-adminlte-asset "^1"
AdminLTE eliminou a inclusão de fontes da web em 2.4.0
, então você precisa incluir a fonte desejada manualmente, ou seja.
<link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Source+Sans+Pro:300,400,600,700,300italic,400italic,600italic">
A inclusão via CDN não é recomendada para produção. Ajuste-a ao fluxo de trabalho de agrupamento de ativos do seu projeto.
Para obter detalhes, consulte #140.
Ao atualizar, consulte o guia de atualização AdminLTE para os ajustes que você precisa fazer em suas visualizações.
DmitryBaranovskiy/eve.git
, consulte #128 e #113.yii2-adminlte-asset | AdminLTE | Fonte incrível |
---|---|---|
2.4 | 2,0 - 2,3 | obrigatório |
2,5 | 2.4 | obrigatório |
3,0 | 2.4 | - |
Para outros problemas, pesquise primeiro no GitHub.
Depois que a extensão for instalada, você poderá ter uma visualização reconfigurando os mapeamentos de caminho do componente de visualização:
Para modelo de aplicativo avançado Yii 2 ou modelo de aplicativo básico
' components ' => [
' view ' => [
' theme ' => [
' pathMap ' => [
' @app/views ' => ' @vendor/dmstr/yii2-adminlte-asset/example-views/yiisoft/yii2-app '
],
],
],
],
Para aplicação phd5
' components ' => [
' view ' => [
' theme ' => [
' pathMap ' => [
' @app/views ' => ' @vendor/dmstr/yii2-adminlte-asset/example-views/testing/app '
],
],
],
],
Este pacote de ativos fornece arquivos de amostra para layout e visualização (consulte examples/
), eles não devem ser personalizados diretamente na pasta vendor/
.
Portanto, é recomendável copiar as visualizações para sua aplicação e ajustá-las às suas necessidades.
vendor/dmstr/yii2-adminlte-asset/example-views/yiisoft/yii2-app
(ou outro tema) para @app/views
.view
personalizada do seu aplicativo excluindo os mapeamentos de caminho, caso você os tenha feito antes.vendor/almasaeed2010/adminlte/pages
Os ativos para plug-ins AdminLTE não estão incluídos em nosso AdminLteAsset
, mas você pode encontrar esses arquivos no diretório do seu fornecedor em vendor/almasaeed2010/adminlte/plugins
. Portanto, se você quiser usar algum deles, recomendamos criar um pacote personalizado onde você lista os arquivos de plug-in necessários:
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 ' ,
];
}
Como este ativo depende do nosso AdminLteAsset
é o único ativo que você precisa registrar, por exemplo, no seu arquivo de layout main.php
.
Se você quiser usar DOM nativo de cabeçalhos AdminLTE
< h1 >
About < small > static page </ small >
</ h1 >
então você pode seguir o código:
/* @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>
Se você precisar separar seções do menu, basta adicionar a opção header
ao item nos 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
Para adicionar um selo a um item:
' items ' => [
[
' label ' => ' Mailbox ' ,
' iconType ' => ' far ' ,
' icon ' => ' envelope ' ,
' url ' => [ ' /mailbox ' ],
' badge ' => ' <span class="badge badge-info right">123</span> '
],
]
Por padrão aos ícones será adicionado o prefixo de Font Awesome
Conte ao Gii sobre nosso modelo. A configuração é feita no arquivo de configuração:
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 ' ,
]
]
],
];
}
Vá para a pasta de testes e inicie a pilha de testes
cd tests
docker-compose up -d
Instale yii2-adminlte-asset
no aplicativo de teste
docker-compose exec php composer install
Abra URLs de teste em seu navegador
http://docker.local:20580/test
http://docker.local:20580/test/login
Para documentação do AdminLTE, leia https://almsaeedstudio.com/themes/AdminLTE/documentation/index.html
As regras de namespace seguem a estrutura do framework Yii 2.0, por exemplo.
dmstradminlteweb
para o Asset Bundle.