Download the PHP package gilek/yii2-gtreetable without Composer
On this page you can find all versions of the php package gilek/yii2-gtreetable. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download gilek/yii2-gtreetable
More information about gilek/yii2-gtreetable
Files in gilek/yii2-gtreetable
Package yii2-gtreetable
Short Description yii2-gtreetable is an extension of Yii 2 Framework, which is wrapper for bootstrap-gtreetable plug-in, on the other hand it provides functionality which allows to save the nodes states into database.
License MIT
Homepage https://github.com/gilek/yii2-gtreetable
Informations about the package yii2-gtreetable
Yii2-GTreeTable
Yii2-GTreeTable is extension of Yii 2 framework which is wrapper for bootstrap-gtreetable plugin, on the other hand provides support to server side application.
Thanks to software it's possible to map actual state of nodes to data base.
Test available on demo project.
Installation
Installation is realized by Composer.
In the console write:
or add following line in require
section of composer.json
file.
One more thing, don't forget about the fxp/composer-asset-plugin
installation:
Minimal configuration
Note: You can also use a migrate file and omit following two steps:
yii migrate --migrationPath=<app_dir>/vendor/gilek/yii2-gtreetable/migrations
-
Create table to store nodes:
-
Add main node:
-
Create new active record model, based on table described in point 1. It's important that model extend
gilek\gtreetable\models\TreeModel
class: - Create new controller or add to existing one following actions:
Configuration
Actions
All actions from gilek\gtreetable\actions
location have properties:
-
afterAction
(callback(gilek\gtreetable\models\TreeModel
$model)) function triggered directly after code responsible for action task i.e. after node deleting, -
$afterRun
(callback) - function triggered after run the action, -
beforeAction
(callback(gilek\gtreetable\models\TreeModel
$model)) - function triggered directly before code responsible for action task i.e. before node deleting, -
$beforeRun
(callback) - function triggered before run the action. More info in yii\base\Action class documentation.Example of use, checking access to authorization unit:
$treeModelName
(TreeModel) - reference to model data extending formgilek\gtreetable\models\TreeModel
(see Minimal configuration point 1).
Model
Support of tree structure in data base is based on Nested set model.
Abstract class gilek\gtreetable\models\TreeModel
provides Nested set model on PHP side. It defines validation rules and other required methods. Its configuration can by adjusted by parameters:
-
$depthAttribute
(string) - column name storing level of node. Defualtlevel
, -
$leftAttribute
(string) - column name storing left value. Defaultlft
, -
$nameAttribute
(string) - column name storing label of node. Defualtname
, -
$rightAttribute
(string) - column name storing left value. Defaultrgt
, -
$treeAttribute
(string) - column name storing reference to main element ID. Defaultroot
, $typeAttribute
(string) - column name storing type of node. Defaulttype
.
View
gilek\gtreetable\views\widget
view class consists configuration of CUD operation with reference to nodes source. There is no necessity to use it, but it can be very helpful in simple projects.
Class may be adjusted by properties:
-
$controller
(string) - controller name where the actions are defined (see Minimal configuration point 4). By default is getting the controller name where thegilek\gtreetable\views\widget
view was triggered, -
$options
(array) - options supplied directly to bootstrap-gtreetable plugin, -
$routes
(array) - in the case when particular nodes are located in different containers or its name is different in relation to presented in point 4 of the chapter Minimal configutarion, then it's necessary to define it,Following example shows structure of data:
$title
(string) - define site title, when view is called directly from action level (see Minimal configuration point 4).
Widget
The main task of gilek\gtreetable\Widget
widget is generate parameters to bootstrap-gtreetable plugin and adding required files.
When container in not available he also response for creating it. Class has following properties:
-
$assetBundle
(AssetBundle) - parameter allows to overflow the mainAssetBundle
packet i.e.Asset
, -
$columnName
(string) - table column name. Default value isName
which is getting from translation file, -
$htmlOptions
(array) - html options of container, they are rendering in the moment of its creation (parameter$selector
set onnull
), -
$options
(array) - options supplied directly to bootstrap-gtreetable plugin, $selector
(string) - jQuery selector indicated on tree container (<table>
tag). When parameter is set onnull
, table will be automatically created. Defaultnull
.
Limitations
Yii2-GTreeTable use Nested Set behavior for Yii 2 extension, which in for the moment (Januray 2015) has some limitation regarding ordering main elements (nodes which level = 0).
In case of adding or moving node as the main node, then it will be located after last element in this level. Therefore order of displayed main nodes may not have the same mapping in data base.
All versions of yii2-gtreetable with dependencies
yiisoft/yii2-bootstrap Version ^2.0
yiisoft/yii2-jui Version ^2.0
creocoder/yii2-nested-sets Version ~0.9
bower-asset/bootstrap-gtreetable Version ^2.0
bower-asset/urijs Version ^1.19
bower-asset/jquery.browser Version 0.1.0