winponta/treevel

Set of classes and traits to handle tree hierarchy in Laravel Eloquent Models

treevel

Installation

1. Require this package in your composer.json file and run composer install (or run composer require winponta/treevel directly):, _(*1)

   "winponta/treevel": "0.*", _(*2)

2. Run copmposer:, _(*3)

   composer update, _(*4)

Using

Enable your models to be ready to handle tree hierarchy records, using one of the traits of the package (for now only Parent tree model is available)., _(*5)

Parent tree model

Parent tree models are handled using parent id references., _(*6)

Trait

<?php
    ...
    class MyModel extends Eloquent {
        use \Winponta\Treevel\Traits\ParentTreeModel;

Default properties

Parent primary key (parentIdField)

This property is used to resolve the parent table primary key. If it's null the Eloquent primaryKey model property is used. You can change this value customizing the database field name your table/collection is using. Do this by setting the property calling the setParentIdField method in the model __constructot:, _(*7)

<?php
    ...
    class MyModel extends Eloquent {
        use \Winponta\Treevel\Traits\ParentTreeModel;

        public function __construct() {
            $this->setParentIdField( 'pk_on_parent_table' );
        }

Parent references (parentField)

The default field name used by the package to handle the reference value to the parent record is named parent_id, you can change this value customizing the database field name your table/collection is using. Do this by setting the property calling the setParentField method in the model __constructot:, _(*8)

<?php
    ...
    class MyModel extends Eloquent {
        use \Winponta\Treevel\Traits\ParentTreeModel;

        public function __construct() {
            $this->setParentField( 'my_father_id' );
        }

Node level property (levelField)

This property controls the deep level of the node in the tree. The default field value used to handle this feature is named node_level, you can change this value customizing the database field name your table/collection is using. Do this by setting the property calling the setLevelField method in the model __constructot:, _(*9)

<?php
    ...
    class MyModel extends Eloquent {
        use \Winponta\Treevel\Traits\ParentTreeModel;

        public function __construct() {
            $this->setLevelField( 'depth' );
        }

Retrieving the tree

getTree

Returns the full tree from database as a Eloquent Collection, _(*10)

• $options - An array with options to be appplied when recovering descendants

> * where => [key, value] - recover only descendants the key matches the value >, _(*11)