arogachev/yii2-tree

Database tree structures management for Yii 2 framework

Yii 2 Tree

Database tree structures management for Yii 2 framework, _(*1)

, _(*2)

Currently it's Nested Sets management extension based on:, _(*3)

• Yii2 Nested Sets
• jsTree

Contents:, _(*4)

• Installation
• Features
• Usage
• Behavior configuration
• Widget configuration

Installation

The preferred way to install this extension is through composer., _(*5)

Either run, _(*6)

php composer.phar require --prefer-dist arogachev/yii2-tree

or add, _(*7)

"arogachev/yii2-tree": "*"

to the require section of your composer.json file., _(*8)

Features

• Basic actions with tree nodes: creating, renaming, moving, deleting
• Saving state of nodes (opened / closed)
• Links for updating node

Usage

Add this to application config:, _(*9)

'controllerMap' => [
    'tree' => 'arogachev\tree\controllers\TreeController',
],

Attach additional behavior along with NestedSetsBehavior to your model:, _(*10)

use arogachev\tree\behaviors\NestedSetsManagementBehavior;

/**
 * @inheritdoc
 */
public function behaviors()
{
    return [
        NestedSetsBehavior::className(),
        NestedSetsManagementBehavior::className(),
    ];
}

The last step is display widget:, _(*11)

use arogachev\tree\widgets\NestedSets;
use frontend\modules\department\models\Department;

<?= NestedSets::widget([
    'modelClass' => Department::className(),
]) ?>

Behavior configuration

nameAttribute - string, the name of attribute storing the name of node. Defaults to name., _(*12)

saveState - boolean, save state of nodes (opened / closed). Defaults to false., _(*13)

isOpenedAttribute - string, the name of attribute storing if the node opened or closed. Used together with saveState. Defaults to is_opened., _(*14)

Widget configuration

modelClass - string, the full model class including namespace of managed model. Required., _(*15)

updateUrl - string, url for updating model in separate page. Will be processed by yii\helpers\Url::to()., _(*16)

jsTreeOptions - array, options for JsTree widget. Example:, _(*17)

'jsTreeOptions' => [
    'clientOptions' => [
        'core' => [
            'strings' => [
                'New node' => 'Новый отдел',
            ],
        ],
    ],
],