README

Yii2框架中使用Material Admin主题的资产

基于 Material Admin 的 Yii2 框架后端 UI，该模板不是免费的，使用前必须购买。

此包包含一个 Yii 2.0 框架资产包，用于注册 Material Admin 用户界面的 CSS 文件。

CSS 文件通过 Yii 推荐的 fxp/composer-asset-plugin v1.1.1 或更高版本安装。

安装

安装此扩展的首选方式是通过 composer。

要安装 Material Admin Asset，请运行

composer require rrmontuan/yii2-materialadmin-asset "^1.0"

快速开始

扩展安装完成后，您可以通过重新配置视图组件的路径映射来预览

对于 Yii 2 高级应用程序模板 或 基本应用程序模板

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

Material Admin Asset 使用默认的源路径 @templates/materialadmin。但是，如果您想（或需要）更改源路径，可以按照以下方式重新配置

'components' => [
	'assetManager' => [
		'bundles' => [
			'rrmontuan\web\MaterialAdminAsset' => [
    			'sourcePath' => '@app\myfolder'
			],
		],
	],
],

此资产包提供布局和视图的示例文件（请参阅 examples/ 文件夹），它们**不是直接在 vendor/ 文件夹中自定义的**。

因此，建议您**将视图复制到您的应用程序中**，并根据您的需要进行调整。

自定义

• 从 vendor/rrmontuan/yii2-materialadmin-asset/example-views/yiisoft/yii2-app（或其他主题）复制文件到 @app/views。
• 如果您之前已经添加了自定义 view 配置，请通过删除路径映射来从您的应用程序中删除自定义 view 配置。

Material Admin 插件

Material Admin 插件的资产不包括在我们的 MaterialAdminAsset 中，但您可以在 Material Admin 模板文件夹的 vendors 文件夹中找到所有文件。因此，如果您想使用它们中的任何一个，我们建议您创建一个自定义包，其中列出您需要的插件文件。

use yii\web\AssetBundle;
class MaterialAdminPluginAsset extends AssetBundle
{
    public $sourcePath = '@app/templates/materialadmin';
    public $js = [
        // more plugin Js here
    ];
    public $css = [
        // more plugin CSS here
    ];
    public $depends = [
        'rrmontuan\web\MaterialAdminAsset',
    ];
}

由于此资产依赖于我们的 AdminLteAsset，因此您只需注册一个资产，例如在您的 main.php 布局文件中。

左侧侧边栏菜单 - 小部件菜单

如果您需要向菜单中添加更多项，可以这样做

'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 图标 的前缀

Gii CRUD 生成器的模板

告诉 Gii 关于我们的模板。设置在配置文件中完成

if (YII_ENV_DEV) {    
    $config['modules']['gii'] = [
        'class' => 'yii\gii\Module',      
        'allowedIPs' => ['127.0.0.1', '::1', '192.168.0.*', '192.168.178.20'],  
        'generators' => [ //here
            'crud' => [
                'class' => 'yii\gii\generators\crud\Generator',
                'templates' => [
                    'materialadmin' => '@vendor/rrmontuan/yii2-materialadmin-asset/gii/templates/crud/simple',
                ]
            ]
        ],
    ];
}