Download the PHP package webtoolsnz/yii2-giiant without Composer
On this page you can find all versions of the php package webtoolsnz/yii2-giiant. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download webtoolsnz/yii2-giiant
More information about webtoolsnz/yii2-giiant
Files in webtoolsnz/yii2-giiant
Package yii2-giiant
Short Description Gii CRUD generator for Yii 2 Framework
License BSD-3-Clause
Homepage http://bitbucket.org/webtoolsnz/yii2-giiant
Informations about the package yii2-giiant
yii2-giiant
Project was forked from https://github.com/schmunk42/yii2-giiant
Extended models and CRUDs for Gii, the code generator of Yii2 Framework
What is it?
Giiant provides templates for model and CRUD generation with relation support and a sophisticated UI. A main project goal is porting many features and learnings from gtc, giix, awecrud and others into one solution.
Installation
The preferred way to install this extension is through composer.
Update your composer.json
with the following:
"require-dev": {
"webtoolsnz/yii2-giiant" : "dev-master"
},
"repositories": [
{
"type": "composer",
"url": "http://packages.webtools.nz"
}
]
The generators are registered automatically in the application bootstrap process, if the Gii module is enabled
Usage
Visit your application's Gii (eg. index.php?r=gii
and choose one of the generators from the main menu screen.
For basic usage instructions see the Yii2 Guide section for Gii.
Command Line Batches
You can run batches of base-model and CRUD generation with the build in batch command:
./yii giiant-batch --tables=profile,social_account,user,token
It will process the given tables, for more details see ./yii help giiant-batch
. See the Sakila example for a detailed example.
Features
Model generator
- generates separate model classes to customize and base models classes to regenerate
- table prefixes can be stipped off model class names (not bound to db connection setting)
CRUD generator
- model, view and controller locations can be customized to use subfolders
- horizontal and vertical form layout
- action button class customization (Select "App Class" option on the Action Button Class option on CRUD generator to customize)
- input, attribute, column and relation customization with provider queue
- callback provider to inject any kind of code for inputs, attributes and columns via dependency injection
Providers
- CallbackProvider universal provider to modify any input, attribute or column with highly flexible callback functions
- RelationProvider renders code for relations (eg. links, dropdowns)
- EditorProvider renders RTE, like
Ckeditor
as input widget - DateTimeProvider renders date inputs
- OptsProvider render a populated dropdown, if the model contains and
optsColumnName()
method.
Customization with providers
In many cases you want to exchange i.e. some inputs with a customized version for your project. Examples for this use-case are editors, file-uploads or choosers, complex input widget with a modal screen, getting data via AJAX and so on.
With Giiant Providers you can create a queue of instances which may provide custom code depending on more complex rules. Take a look at some existing giiant providers.
Configure providers, add this to your provider list in the form:
\webtoolsnz\giiant\crud\providers\EditorProvider,
\webtoolsnz\giiant\crud\providers\SelectProvider,
\webtoolsnz\giiant\crud\providers\OptsProvider,
And configure the settings of the provider, add setting via dependecy injection this to your application config, eg. in console/config/bootstrap.php
:
\Yii::$container->set(
'webtoolsnz\giiant\crud\providers\EditorProvider',
[
'columnNames' => ['description']
]
);
This will render a Ckeditor widget for every column named description
.
<?= $form->field($model, 'description')->widget(
\dosamigos\ckeditor\CKEditor::className(),
[
'options' => ['rows' => 6],
'preset' => 'basic'
]) ?>
NOTE The OptsProvider matches every model with opts methods for a field, i.e. method optsMembers
matches for model attribute members
.
Using "prompt" in dropdown lists
Set the first entry in your getColumnName()
method to value null
.
null => \Yii::t('app', 'Select'),
To ensure that the correct value is written to the database you should add a validation rule in the model.
public function rules()
{
return ArrayHelper::merge(
parent::rules(),
[
[
['field_name'],
'default',
'value' => null
]
]
);
}
Universal CallbackProvider
This provider has three properties activeFields
(form), columnFormats
(index) and attributeFormats
(view) which all take an array of callback as input. The keys are evaluated as a regular expression the match the class and attribute name.
While the callback function takes the current attribute and generator as input parameters.
The configuration can be done via the dependency injection container of Yii2.
Define callbacks for input fields in _form
view
Define callbacks for grid columns in index
view
Detail view
attributes
Finally add the configuration via DI container
More providers...
Use custom generators, model and crud templates
Extras
A detailed description how to use MySQL workbench for model updates and migration see here.
Special thanks to motin, thyseus, uldisn and rcoelho for their work, inspirations and feedback.
Troubleshooting
You can also add
"repositories": [
{
"type": "vcs",
"url": "https://github.com/schmunk42/yii2-giiant.git"
}
],
"require": {
.....(your required modules)....
"schmunk42/yii2-giiant":"dev-master"
},
to your composer.json file and run
composer update
if you are having trouble with "Not found" errors using the preferred method.