abbosxon / yii2-material-admin
我的第一个仓库
Requires
- yiisoft/yii2: 2.*
- yiisoft/yii2-bootstrap: ~2.0.0
This package is auto-updated.
Last update: 2024-09-09 02:15:32 UTC
README
用于在 Yii2 框架中使用 Material Admin 主题的资产
基于 Material Admin 的 Yii2 框架后端 UI,请注意 Material Admin 模板并非免费,使用前必须购买。
此包包含一个 Yii 2.0 框架资产包,该包注册了 Material Admin 用户界面的 CSS 文件。
CSS 文件通过 Yii 推荐的 fxp/composer-asset-plugin
v1.1.1 或更高版本安装。
安装
安装此扩展的首选方式是通过 composer。
要安装 Material Admin 资产,运行
composer require abbosxon/yii2-material-admin "dev-master"
快速入门
扩展安装完成后,您可以重新配置视图组件的路径映射以进行 预览。
'components' => [ 'view' => [ 'theme' => [ 'pathMap' => [ '@app/views' => '@vendor/abbosxon/yii2-material-admin/example-views/yiisoft/yii2-app' ], ], ], ],
Material Admin 资产使用默认的 sourcePath @templates/materialadmin。但是,如果您想要(或需要)更改,可以按照以下方式重新配置
'components' => [ 'assetManager' => [ 'bundles' => [ 'abbosxon\materialadmin\assets\MaterialAsset' => [ 'sourcePath' => '@app\myfolder' ], ], ], ],
此资产包提供了布局和视图的示例文件(请参阅 examples/
文件夹),它们**不应该直接在 vendor/
文件夹中自定义**。
因此,建议您**将视图复制到您的应用程序中**,并根据您的需求进行调整。
自定义
- 从
vendor/abbosxon/yii2-material-admin/example-views/yiisoft/yii2-app
(或其它主题)复制文件到@app/views
。 - 如果之前已添加,请从您的应用程序中删除自定义
view
配置,即删除路径映射。
Material Admin 插件
Material Admin 插件的资产不包括在我们的 MaterialAdminAsset
中,但您可以在 Material Admin 模板文件夹内的 vendors 文件夹中找到所有文件。因此,如果您想使用它们中的任何一个,我们建议您创建一个自定义包,其中列出您需要的插件文件。
use yii\web\AssetBundle; class MaterialAdminAsset extends AssetBundle { public $sourcePath = '@app/templates/materialadmin'; public $js = [ // more plugin Js here ]; public $css = [ // more plugin CSS here ]; public $depends = [ 'abbosxon\materialadmin\assets\MaterialAsset', ]; }
左侧侧边栏菜单 - Widget Menu
如果您需要向菜单中添加更多项目,可以这样做
'items'=>[ [ 'label' => 'Dashboards Slideshow', 'icon' => 'now-widgets', 'url' => ['/site/about'], 'visible' => true ], [ 'label' => 'Tables', 'icon' => 'view-list', 'url' => ['/site'], 'items' => [ ['label' => 'Normal Tables', 'url' => ['/site/contact'],], ['label' => 'Data Tables', 'url' => ['/site/index'],], ], ], ]
默认情况下,图标将添加 Material Design Icons 的前缀。