Current File : /home/tjamichg/cursos.tjamich.gob.mx/vendor/knplabs/knp-menu/src/Knp/Menu/Twig/Helper.php
<?php
namespace Knp\Menu\Twig;
use Knp\Menu\ItemInterface;
use Knp\Menu\Matcher\MatcherInterface;
use Knp\Menu\Provider\MenuProviderInterface;
use Knp\Menu\Renderer\RendererProviderInterface;
use Knp\Menu\Util\MenuManipulator;
/**
* Helper class containing logic to retrieve and render menus from templating engines
*/
class Helper
{
private $rendererProvider;
private $menuProvider;
private $menuManipulator;
private $matcher;
/**
* @param RendererProviderInterface $rendererProvider
* @param MenuProviderInterface|null $menuProvider
* @param MenuManipulator|null $menuManipulator
* @param MatcherInterface|null $matcher
*/
public function __construct(RendererProviderInterface $rendererProvider, MenuProviderInterface $menuProvider = null, MenuManipulator $menuManipulator = null, MatcherInterface $matcher = null)
{
$this->rendererProvider = $rendererProvider;
$this->menuProvider = $menuProvider;
$this->menuManipulator = $menuManipulator;
$this->matcher = $matcher;
}
/**
* Retrieves item in the menu, eventually using the menu provider.
*
* @param ItemInterface|string $menu
* @param array $path
* @param array $options
*
* @return ItemInterface
*
* @throws \BadMethodCallException when there is no menu provider and the menu is given by name
* @throws \LogicException
* @throws \InvalidArgumentException when the path is invalid
*/
public function get($menu, array $path = [], array $options = [])
{
if (!$menu instanceof ItemInterface) {
if (null === $this->menuProvider) {
throw new \BadMethodCallException('A menu provider must be set to retrieve a menu');
}
$menuName = $menu;
$menu = $this->menuProvider->get($menuName, $options);
if (!$menu instanceof ItemInterface) {
throw new \LogicException(\sprintf('The menu "%s" exists, but is not a valid menu item object. Check where you created the menu to be sure it returns an ItemInterface object.', $menuName));
}
}
foreach ($path as $child) {
$menu = $menu->getChild($child);
if (null === $menu) {
throw new \InvalidArgumentException(\sprintf('The menu has no child named "%s"', $child));
}
}
return $menu;
}
/**
* Renders a menu with the specified renderer.
*
* If the argument is an array, it will follow the path in the tree to
* get the needed item. The first element of the array is the whole menu.
* If the menu is a string instead of an ItemInterface, the provider
* will be used.
*
* @param ItemInterface|string|array $menu
* @param array $options
* @param string $renderer
*
* @return string
*
* @throws \InvalidArgumentException
*/
public function render($menu, array $options = [], $renderer = null)
{
$menu = $this->castMenu($menu);
return $this->rendererProvider->get($renderer)->render($menu, $options);
}
/**
* Renders an array ready to be used for breadcrumbs.
*
* Each element in the array will be an array with 3 keys:
* - `label` containing the label of the item
* - `url` containing the url of the item (may be `null`)
* - `item` containing the original item (may be `null` for the extra items)
*
* The subItem can be one of the following forms
* * 'subItem'
* * ItemInterface object
* * ['subItem' => '@homepage']
* * ['subItem1', 'subItem2']
* * [['label' => 'subItem1', 'url' => '@homepage'], ['label' => 'subItem2']]
*
* @param mixed $menu
* @param mixed $subItem A string or array to append onto the end of the array
*
* @return array
*/
public function getBreadcrumbsArray($menu, $subItem = null)
{
if (null === $this->menuManipulator) {
throw new \BadMethodCallException('The menu manipulator must be set to get the breadcrumbs array');
}
$menu = $this->castMenu($menu);
return $this->menuManipulator->getBreadcrumbsArray($menu, $subItem);
}
/**
* Returns the current item of a menu.
*
* @param ItemInterface|array|string $menu
*
* @return ItemInterface|null
*/
public function getCurrentItem($menu)
{
if (null === $this->matcher) {
throw new \BadMethodCallException('The matcher must be set to get the current item of a menu');
}
$menu = $this->castMenu($menu);
return $this->retrieveCurrentItem($menu);
}
/**
* @param ItemInterface|array|string $menu
*
* @return ItemInterface
*/
private function castMenu($menu)
{
if (!$menu instanceof ItemInterface) {
$path = [];
if (\is_array($menu)) {
if (empty($menu)) {
throw new \InvalidArgumentException('The array cannot be empty');
}
$path = $menu;
$menu = \array_shift($path);
}
return $this->get($menu, $path);
}
return $menu;
}
/**
* @param ItemInterface $item
*
* @return ItemInterface|null
*/
private function retrieveCurrentItem(ItemInterface $item)
{
if ($this->matcher->isCurrent($item)) {
return $item;
}
if ($this->matcher->isAncestor($item)) {
foreach ($item->getChildren() as $child) {
$currentItem = $this->retrieveCurrentItem($child);
if (null !== $currentItem) {
return $currentItem;
}
}
}
return null;
}
}
Mini Shell