Service.php

Go to the documentation of this file.

<?php
namespace Elgg\Menu;

use Elgg\PluginHooksService;
use Elgg\Config;
use ElggMenuBuilder;
use ElggMenuItem;

class Service {

    private $hooks;

    private $config;

    public function __construct(PluginHooksService $hooks, Config $config) {
        $this->hooks = $hooks;
        $this->config = $config;
    }

    public function getMenu($name, array $params = []) {
        return $this->prepareMenu($this->getUnpreparedMenu($name, $params));
    }

    public function getUnpreparedMenu($name, array $params = []) {
        $menus = $this->config->getVolatile('menus');

        $items = $this->prepareMenuItems(elgg_extract('items', $params, []));
        unset($params['items']);
        
        if ($menus && isset($menus[$name])) {
            $registered_items = elgg_extract($name, $menus, []);
            $items = array_merge($items, $registered_items);
        }

        $params['name'] = $name;

        $params = $this->hooks->trigger('parameters', "menu:$name", $params, $params);

        if (!isset($params['sort_by'])) {
            $params['sort_by'] = 'text';
        }

        $items = $this->hooks->trigger('register', "menu:$name", $params, $items);

        return new UnpreparedMenu($params, $items);
    }

    public function prepareMenu(UnpreparedMenu $menu) {
        $name = $menu->getName();
        $params = $menu->getParams();
        $sort_by = $menu->getSortBy();

        $builder = new ElggMenuBuilder($menu->getItems());
        $params['menu'] = $builder->getMenu($sort_by);
        $params['selected_item'] = $builder->getSelected();

        $params['menu'] = $this->hooks->trigger('prepare', "menu:$name", $params, $params['menu']);

        return new Menu($params);
    }

    function combineMenus(array $names = [], array $params = [], $new_name = '') {
        if (!$new_name) {
            $new_name = implode('__' , $names);
        }

        $all_items = [];
        foreach ($names as $name) {
            $items = $this->getUnpreparedMenu($name, $params)->getItems();

            foreach ($items as $item) {
                $section = $item->getSection();
                if ($section == 'default') {
                    $item->setSection($name);
                }
                $item->setData('menu_name', $name);
                $all_items[] = $item;
            }
        }

        $params['name'] = $new_name;

        return new UnpreparedMenu($params, $all_items);
    }

    public function prepareMenuItems(array $items = []) {
        $prepared_items = [];
        
        foreach ($items as $item) {
            if (is_array($item)) {
                $options = $item;
                $item = ElggMenuItem::factory($options);
            }

            if (!$item instanceof ElggMenuItem) {
                continue;
            }
            
            $prepared_items[] = $item;
        }

        return $prepared_items;
    }
}