Interface utilisateur backend pour Yii2 Framework, basée sur AdminLTE
Ce package contient un Asset Bundle pour Yii 2.0 Framework qui enregistre les fichiers CSS pour l'interface utilisateur AdminLTE.
Les fichiers CSS sont installés via l'utilisation recommandée par Yii du fxp/composer-asset-plugin
v1.1.1 ou version ultérieure.
La méthode préférée pour installer cette extension est via composer.
Pour installer AdminLTE v2, exécutez :
composer require dmstr/yii2-adminlte-asset "^2.1"
Pour installer AdminLTE v1, exécutez :
composer require dmstr/yii2-adminlte-asset "^1"
AdminLTE a abandonné l'inclusion des polices Web dans 2.4.0
, vous devez donc inclure la police souhaitée manuellement, c'est-à-dire.
<link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Source+Sans+Pro:300,400,600,700,300italic,400italic,600italic">
L'inclusion via CDN n'est pas recommandée pour la production, veuillez l'ajuster au flux de travail de regroupement d'actifs de votre projet.
Pour plus de détails, voir #140.
Lors de la mise à niveau, veuillez consulter le guide de mise à niveau AdminLTE pour connaître les ajustements que vous devez effectuer dans vos vues.
DmitryBaranovskiy/eve.git
, veuillez consulter #128 et #113.yii2-adminlte-asset | AdministrateurLTE | Police géniale |
---|---|---|
2.4 | 2,0 - 2,3 | requis |
2.5 | 2.4 | requis |
3.0 | 2.4 | - |
Pour d’autres problèmes, veuillez d’abord effectuer une recherche sur GitHub.
Une fois l'extension installée, vous pouvez avoir un aperçu en reconfigurant les mappages de chemins du composant view :
Pour le modèle d'application avancé Yii 2 ou le modèle d'application de base
' components ' => [
' view ' => [
' theme ' => [
' pathMap ' => [
' @app/views ' => ' @vendor/dmstr/yii2-adminlte-asset/example-views/yiisoft/yii2-app '
],
],
],
],
Pour candidature en doctorat 5
' components ' => [
' view ' => [
' theme ' => [
' pathMap ' => [
' @app/views ' => ' @vendor/dmstr/yii2-adminlte-asset/example-views/testing/app '
],
],
],
],
Cet ensemble d'actifs fournit des exemples de fichiers pour la mise en page et l'affichage (voir le dossier examples/
), ils ne sont pas destinés à être personnalisés directement dans le dossier vendor/
.
Il est donc recommandé de copier les vues dans votre application et de les ajuster à vos besoins.
vendor/dmstr/yii2-adminlte-asset/example-views/yiisoft/yii2-app
(ou un autre thème) vers @app/views
.view
personnalisée de votre application en supprimant les mappages de chemin, si vous les avez déjà effectués.vendor/almasaeed2010/adminlte/pages
Les actifs pour les plugins AdminLTE ne sont pas inclus dans notre AdminLteAsset
mais vous pouvez trouver ces fichiers dans votre répertoire fournisseur sous vendor/almasaeed2010/adminlte/plugins
. Donc, si vous souhaitez utiliser l'un d'entre eux, nous vous recommandons de créer un bundle personnalisé dans lequel vous répertoriez les fichiers de plugin dont vous avez besoin :
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 ' ,
];
}
Comme cet actif dépend de notre AdminLteAsset
c'est le seul actif que vous devez enregistrer, par exemple dans votre fichier de mise en page main.php
.
Si vous souhaitez utiliser le DOM natif des en-têtes AdminLTE
< h1 >
About < small > static page </ small >
</ h1 >
alors vous pouvez suivre le code :
/* @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>
Si vous devez séparer les sections du menu, ajoutez simplement l'option header
à l'élément dans 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
Pour ajouter un badge pour un article :
' items ' => [
[
' label ' => ' Mailbox ' ,
' iconType ' => ' far ' ,
' icon ' => ' envelope ' ,
' url ' => [ ' /mailbox ' ],
' badge ' => ' <span class="badge badge-info right">123</span> '
],
]
Par défaut, le préfixe Font Awesome sera ajouté aux icônes.
Parlez à Gii de notre modèle. Le paramétrage se fait dans le fichier de config :
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 ' ,
]
]
],
];
}
Accédez au dossier tests et démarrez la pile de tests
cd tests
docker-compose up -d
Installez yii2-adminlte-asset
dans l'application de test
docker-compose exec php composer install
Ouvrez les URL de test dans votre navigateur
http://docker.local:20580/test
http://docker.local:20580/test/login
Pour la documentation AdminLTE, veuillez lire https://almsaeedstudio.com/themes/AdminLTE/documentation/index.html
Les règles d'espacement de noms suivent la structure du framework Yii 2.0, par exemple.
dmstradminlteweb
pour le bundle d'actifs.