gudezi / yii2-adminlte-asset
基于 Yii 2.0 框架的 AdminLTE 后端主题资源包
Requires
- cebe/yii2-gravatar: 1.*
- gudezi/adminlte: *
- rmrevin/yii2-fontawesome: ~2.9
- yiisoft/yii2: 2.*
- yiisoft/yii2-bootstrap: 2.*
This package is not auto-updated.
Last update: 2024-09-28 20:03:37 UTC
README
基于 AdminLTE 的 Yii2 框架后端 UI
本包包含一个Yii 2.0 框架资源包,用于注册 AdminLTE 用户界面的 CSS 文件。
CSS 文件通过 Yii 推荐的 fxp/composer-asset-plugin
v1.1.1 或更高版本安装。
安装
安装此扩展的首选方式是通过 composer。
要安装 AdminLTE v2,请运行
php composer.phar require gudezi/yii2-adminlte-asset "*"
快速开始
一旦安装了扩展,您可以通过重新配置视图组件的路径映射来预览
'components' => [ 'view' => [ 'theme' => [ 'pathMap' => [ '@app/views' => '@vendor/gudezi/yii2-adminlte-asset/example-views/yiisoft/yii2-app' ], ], ], ],
对于 Phundament 4
'components' => [ 'view' => [ 'theme' => [ 'pathMap' => [ '@app/views' => '@vendor/gudezi/yii2-adminlte-asset/example-views/phundament/app' ], ], ], ],
此资源包提供了布局和视图的示例文件(请参阅 examples/
文件夹),它们不是直接在 vendor/
文件夹中修改的。
因此,建议您将视图复制到您的应用程序中,并根据您的需求进行调整。
自定义
- 将
vendor/gudezi/yii2-adminlte-asset/example-views/yiisoft/yii2-app
(或其它主题)中的文件复制到@app/views
。 - 如果您之前已添加自定义
view
配置,请通过删除路径映射来删除它。 - 根据
vendor/gudezi/adminlte/pages
中的 html 标记编辑您的视图
皮肤
默认情况下,扩展使用蓝色皮肤。您可以在配置文件中更改它。
'components' => [ 'assetManager' => [ 'bundles' => [ 'gudezi\web\AdminLteAsset' => [ 'skin' => 'skin-black', ], ], ], ],
然后只需替换 body 的 class 为 skin-blue
。如果您不想在更改皮肤颜色时更改每个视图文件,可以使用 AdminLteHelper::skinClass()
。
<body class="<?= \gudezi\helpers\AdminLteHelper::skinClass() ?>">
注意:仅在通过配置覆盖皮肤时使用 AdminLteHelper::skinClass()
。否则,您将不会获得 body 的正确 css 类。
以下是可用的皮肤列表
"skin-blue",
"skin-black",
"skin-red",
"skin-yellow",
"skin-purple",
"skin-green",
"skin-blue-light",
"skin-black-light",
"skin-red-light",
"skin-yellow-light",
"skin-purple-light",
"skin-green-light"
如果您想使用 AdminLTE 标题的本地 DOM
<h1> About <small>static page</small> </h1>
然后可以按照以下代码进行
/* @var $this yii\web\View */ $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>
左侧菜单栏 - Widget Menu
如果您需要将菜单的某些部分分开,只需将 li.header
项目添加到 items
'items' => [ ['label' => 'Gii', 'icon' => 'fa fa-file-code-o', 'url' => ['/gii']], ['label' => 'Debug', 'icon' => 'fa fa-dashboard', 'url' => ['/debug']], ['label' => 'MAIN NAVIGATION', 'options' => ['class' => 'header']], // here // ... a group items ['label' => '', 'options' => ['class' => 'header']], // ... a group items ['label' => '', 'options' => ['class' => 'header']], // ... a group items
为项目添加标签
'items' => [ [ 'label' => '<span>Mailbox</span><span class="pull-right-container"><small class="label pull-right bg-yellow">' . $mailCount . '</small></span>', 'icon' => 'fa fa fa-envelope-o', 'url' => ['/mailbox'], 'encode' => false, ],
更多信息
有关 AdminLTE 文档,请参阅 https://almsaeedstudio.com/themes/AdminLTE/documentation/index.html
命名空间规则遵循 Yii 2.0 框架结构,例如,Asset Bundle 使用
gudezi\web
。