helbrary/node-item-tree

Tree structure library.

v1.2.3 2016-10-23 12:00 UTC

Requires

• php: >= 5.5.0
• latte/latte: >=v2.3.8
• nette/tester: >=1.6.1

BSD-3-Clause, GPL-2.0, GPL-3.0

README

Example: Products in categories

Imagine that nodes are categories and items are products.

$tree->addNode(1, 'All categories', array()); // root

// subcategories of category 'All categories'
$tree->addNode(2, 'Computer', array(), 1);
$tree->addNode(3, 'Wifi', array(), 1);
$tree->addNode(4, 'other', array(), 1); 

$tree->addNode(5, 'Gaming computer', array(), 2);

// add products to categories
$tree->addItem(2, 1448, 'My super computer', array('price' => 15000));  // 1448 = id of product
$tree->addItem(3, 1453, 'My super wifi', array('price' => 800));  // 1453 = id of product
$tree->addItem(4, 1350, 'My super printer', array('price' => 800));  // 1350 = id of product

//instead of array with information we can put object

$product = $db->getProduct(1351);
$tree->addItem(4, $product->id,  $product->name, $product);

And then we can render tree

foreach ($tree->findRootNodes() as $rootCategories) {

  foreach ($node->findNodes() as $subCategory) {

  echo $subCategory->getValue(); // name of category

    foreach ($subcategory->findItems() as $product) {
      echo "- " . $product->getValue();     // name of product
    }
  }
}

Render items of node

$node = $tree->getNode(1);
$items = $node->findItems(); // return all items which are direct in node with key 1

$items = $node->findItems(TRUE); // return all items in node 1 and all items in all descendants of node 1

Path to node

$pathToNodes = $tree->getPathToNode(5);
foreach ($pathToNodes as $node) {
  echo '- ' . $node->getValue();
}

// output will be:  All  categories - Computer - Gaming computer

// if we do not want render last node 'Gaming computer' then we must set second parameter of method getPathToNode to FALSE

$pathToNodes = $tree->getPathToNode(5, FALSE);
foreach ($pathToNodes as $node) {
  echo '- ' . $node->getValue();
}

// output will be:  All  categories - Computer