exocet / yii2-bootstrap-material-design
Composer package for implementing MDB in Yii2.
Installs: 6 475
Dependents: 0
Suggesters: 0
Security: 0
Stars: 6
Watchers: 2
Forks: 2
Open Issues: 0
Type:yii2-extension
Requires
- npm-asset/mdb-ui-kit: ^6.4
- npm-asset/mervick--mdi-icons: ^4.0
- yiisoft/yii2: ~2.0.10
- yiisoft/yii2-bootstrap5: ~2.0.4
This package is auto-updated.
Last update: 2023-09-07 21:12:00 UTC
README
Composer package for implementing FezVrasta's new bootstrap material design (MDB 6) in Yii2 https://github.com/mdbootstrap/mdb-ui-kit
Installation
The preferred way of installation is through Composer.
composer require exocet/yii2-bootstrap-material-design
Usage
To load the MDB CSS and JS files integrate the MaterialAsset into your app. Two ways to achieve this is to register the asset in the main layout:
// @app/views/layouts/main.php \exocet\bootstrap5md\MaterialAsset::register($this); // include css and js \exocet\bootstrap5md\MaterialIconsAsset::register($this); // include icons (optional) // further code
or as a dependency in your app wide AppAsset.php
// @app/assets/AppAsset.php public $depends = [ // include bootstrap 5 and material 'exocet\bootstrap5md\MaterialAsset', // include material icons (optional) 'exocet\bootstrap5md\MaterialIconsAsset', // more dependencies //... ];
Widgets
This add-on extends Bootstrap 5 by replacing dependencies with MDB dependencies and corrects the way html is generated in certain components to make them the way they are used with MDB.
It is probably best to use it in combination with https://github.com/kartik-v/yii2-widgets
Gii support
If you are creating your CRUD controller and view files using Gii you can get materialized view files by integrating the adapted Gii templates.
// @app/config/main-local.php $config['modules']['gii'] = [ 'class' => 'yii\gii\Module', 'allowedIPs' => ['127.0.0.1', '::1'], 'generators' => [ 'crud' => [ 'class' => 'yii\gii\generators\crud\Generator', 'templates' => [ 'material-bootstrap' => '@vendor/exocet/yii2-bootstrap-material-design/src/generators/crud', ] ] ], ];
You can copy those templates to any location you wish for further customization. Make sure you adapt the path accordingly in your config.