library mahana-hierarchy-laravel

jrmadsen67/mahana-hierarchy-laravel

A hierarchy management package

Mahana Hierarchy Laravel

Laravel package version of the Mahana Hierarchy module found here: https://github.com/jrmadsen67/mahana-hierarchy, _(*1)

A complete description of the functionality is located here: http://www.codebyjeff.com/blog/2012/10/nested-data-with-mahana-hierarchy-library, _(*2)

Installation

Available (recommended) via composer:, _(*3)

"require": {
     "jrmadsen67/mahana-hierarchy-laravel": "dev-master"
}

In you Laravel app.php file add this to providers:, _(*4)

'Jrmadsen67\MahanaHierarchyLaravel\MahanaHierarchyLaravelServiceProvider'

and this to your facades (optional):, _(*5)

 'MahanaHierarchy'    => 'Jrmadsen67\MahanaHierarchyLaravel\Facades\HierarchyFacade'

then run the migration:, _(*6)

php artisan migrate --package="jrmadsen67/mahana-hierarchy-laravel"

You may run these line to check that the installation is correct:, _(*7)

$data = ['name' => 'A parent', 'parent_id' => 0 ];
$insert = MahanaHierarchy::insert($data);
$row = MahanaHierarchy::get($insert->id);

A data seeder for experimenting and testing is coming soon., _(*8)

Configuration

Table name and fields are completely configurable to your needs. Simply publish the package with the following:, _(*9)

php artisan config:publish jrmadsen67/mahana-hierarchy-laravel

IMPORTANT! If you wish to use the included migration, run the publish config line BEFORE the migration and your new table name and fields will be used., _(*10)

Differences in this release

Aside from being a Laravel package, I have not yet fully set up the configuration to allow multiple instances and to easily change all the tabel and field names. This is coming very shortly (the main library is already set up this way, but supporting classes are not)., _(*11)

Testing

This is fully tested, but proper Unit Testing is not yet included until done a little more...er, "properly"., _(*12)