ElggMenuItem.php

Go to the documentation of this file.

<?php
class ElggMenuItem {

    protected $data = array(
        // string Identifier of the menu
        'name' => '',

        // array Page contexts this menu item should appear on
        'contexts' => array('all'),

        // string Menu section identifier
        'section' => 'default',

        // int Smaller priorities float to the top
        'priority' => 100,

        // bool Is this the currently selected menu item
        'selected' => false,

        // string Identifier of this item's parent
        'parent_name' => '',

        // \ElggMenuItem The parent object or null
        'parent' => null,

        // array Array of children objects or empty array
        'children' => array(),

        // array Classes to apply to the li tag
        'itemClass' => array(),

        // array Classes to apply to the anchor tag
        'linkClass' => array(),

        // array AMD modules required by this menu item
        'deps' => array()
    );

    protected $text;

    protected $href = null;

    protected $title = false;

    protected $confirm = '';


    public function __construct($name, $text, $href) {
        $this->text = $text;
        if ($href) {
            $this->href = elgg_normalize_url($href);
        } else {
            $this->href = $href;
        }

        $this->data['name'] = $name;
    }

    public static function factory($options) {
        if (!isset($options['name']) || !isset($options['text'])) {
            elgg_log(__METHOD__ . ': $options "name" and "text" are required.', 'ERROR');
            return null;
        }
        if (!isset($options['href'])) {
            $options['href'] = '';
        }

        $item = new \ElggMenuItem($options['name'], $options['text'], $options['href']);
        unset($options['name']);
        unset($options['text']);
        unset($options['href']);

        // special catch in case someone uses context rather than contexts
        if (isset($options['context'])) {
            $options['contexts'] = $options['context'];
            unset($options['context']);
        }
        
        // make sure contexts is set correctly
        if (isset($options['contexts'])) {
            $item->setContext($options['contexts']);
            unset($options['contexts']);
        }

        if (isset($options['link_class'])) {
            $item->setLinkClass($options['link_class']);
            unset($options['link_class']);
        } elseif (isset($options['class'])) {
            elgg_deprecated_notice("\ElggMenuItem::factory() does not accept 'class' key anymore, use 'link_class' instead", 1.9);
            $item->setLinkClass($options['class']);
            unset($options['class']);
        }

        if (isset($options['item_class'])) {
            $item->setItemClass($options['item_class']);
            unset($options['item_class']);
        }

        if (isset($options['data']) && is_array($options['data'])) {
            $item->setData($options['data']);
            unset($options['data']);
        }
        
        foreach ($options as $key => $value) {
            if (isset($item->data[$key])) {
                $item->data[$key] = $value;
            } else {
                $item->$key = $value;
            }
        }

        return $item;
    }

    public function setData($key, $value = null) {
        if (is_array($key)) {
            $this->data = array_merge($this->data, $key);
        } else {
            $this->data[$key] = $value;
        }
    }

    public function getData($key) {
        if (isset($this->data[$key])) {
            return $this->data[$key];
        } else {
            return null;
        }
    }

    public function setName($name) {
        $this->data['name'] = $name;
    }

    public function getName() {
        return $this->data['name'];
    }

    public function setText($text) {
        $this->text = $text;
    }

    public function getText() {
        return $this->text;
    }

    public function setHref($href) {
        $this->href = $href;
    }

    public function getHref() {
        return $this->href;
    }

    public function setContext($contexts) {
        if (is_string($contexts)) {
            $contexts = array($contexts);
        }
        $this->data['contexts'] = $contexts;
    }

    public function getContext() {
        return $this->data['contexts'];
    }

    public function inContext($context = '') {
        if (in_array('all', $this->data['contexts'])) {
            return true;
        }

        if ($context) {
            return in_array($context, $this->data['contexts']);
        }

        foreach ($this->data['contexts'] as $context) {
            if (elgg_in_context($context)) {
                return true;
            }
        }
        return false;
    }

    public function setSelected($state = true) {
        $this->data['selected'] = $state;
    }

    public function getSelected() {
        return $this->data['selected'];
    }

    public function setTooltip($text) {
        $this->title = $text;
    }

    public function getTooltip() {
        return $this->title;
    }

    public function setConfirmText($text) {
        $this->confirm = $text;
    }

    public function getConfirmText() {
        return $this->confirm;
    }

    public function setLinkClass($class) {
        if (!is_array($class)) {
            $this->data['linkClass'] = array($class);
        } else {
            $this->data['linkClass'] = $class;
        }
    }

    public function getLinkClass() {
        return implode(' ', $this->data['linkClass']);
    }

    public function addLinkClass($class) {
        $this->addClass($this->data['linkClass'], $class);
    }

    public function setDeps($modules) {
        $this->data['deps'] = (array) $modules;
    }

    public function getDeps() {
        $modules = (array) $this->data['deps'];
        return array_filter($modules, function($m) {
            return is_string($m) && !empty($m);
        });
    }

    public function addDeps($modules) {
        $current = $this->getDeps();
        $this->setDeps($current + (array) $modules);
    }

    public function setItemClass($class) {
        if (!is_array($class)) {
            $this->data['itemClass'] = array($class);
        } else {
            $this->data['itemClass'] = $class;
        }
    }

    public function getItemClass() {
        // allow people to specify name with underscores and colons
        $name = strtolower($this->getName());
        $name = str_replace('_', '-', $name);
        $name = str_replace(':', '-', $name);
        $name = str_replace(' ', '-', $name);

        $class = implode(' ', $this->data['itemClass']);
        if ($class) {
            return "elgg-menu-item-$name $class";
        } else {
            return "elgg-menu-item-$name";
        }
    }

    public function addItemClass($class) {
        $this->addClass($this->data['itemClass'], $class);
    }

    // @codingStandardsIgnoreStart
    protected function addClass(array &$current, $additional) {
        if (!is_array($additional)) {
            $current[] = $additional;
        } else {
            $current = array_merge($current, $additional);
        }
    }
    // @codingStandardsIgnoreEnd


    public function setWeight($priority) {
        elgg_deprecated_notice("\ElggMenuItem::setWeight() deprecated by \ElggMenuItem::setPriority()", 1.9);
        $this->data['priority'] = $priority;
    }

    public function getWeight() {
        elgg_deprecated_notice("\ElggMenuItem::getWeight() deprecated by \ElggMenuItem::getPriority()", 1.9);
        return $this->data['priority'];
    }

    public function setPriority($priority) {
        $this->data['priority'] = $priority;
    }

    public function getPriority() {
        return $this->data['priority'];
    }

    public function setSection($section) {
        $this->data['section'] = $section;
    }

    public function getSection() {
        return $this->data['section'];
    }

    public function setParentName($name) {
        $this->data['parent_name'] = $name;
    }

    public function getParentName() {
        return $this->data['parent_name'];
    }

    public function setParent($parent) {
        $this->data['parent'] = $parent;
    }

    public function getParent() {
        return $this->data['parent'];
    }

    public function addChild($item) {
        $this->data['children'][] = $item;
    }

    public function setChildren($children) {
        $this->data['children'] = $children;
    }

    public function getChildren() {
        return $this->data['children'];
    }

    public function sortChildren($sortFunction) {
        foreach ($this->data['children'] as $key => $node) {
            $this->data['children'][$key]->data['original_order'] = $key;
        }
        usort($this->data['children'], $sortFunction);
    }

    public function getValues() {
        $values = get_object_vars($this);
        unset($values['data']);

        return $values;
    }

    public function getContent(array $vars = array()) {
        elgg_deprecated_notice("\ElggMenuItem::getContent() deprecated by elgg_view_menu_item()", 1.9);
        return elgg_view_menu_item($this, $vars);
    }
}