icingaweb2/library/Icinga/Web/Navigation/DashboardPane.php

<?php
/* Icinga Web 2 | (c) 2013-2015 Icinga Development Team | GPLv2+ */

namespace Icinga\Web\Navigation;

use Icinga\Web\Url;

/**
 * A dashboard pane
 */
class DashboardPane extends NavigationItem
{
    /**
     * This pane's dashlets
     *
     * @var array
     */
    protected $dashlets;

    /**
     * Set this pane's dashlets
     *
     * @param   array   $dashlets
     *
     * @return  $this
     */
    public function setDashlets(array $dashlets)
    {
        $this->dashlets = $dashlets;
        return $this;
    }

    /**
     * Return this pane's dashlets
     *
     * @param   bool    $order  Whether to order the dashlets first
     *
     * @return  array
     */
    public function getDashlets($order = true)
    {
        if ($this->dashlets === null) {
            return array();
        }

        if ($order) {
            ksort($this->dashlets);
        }

        return $this->dashlets;
    }

    /**
     * {@inheritdoc}
     */
    public function init()
    {
        $this->setUrl(Url::fromPath('dashboard', array('pane' => $this->getName())));
    }

    /**
     * {@inheritdoc}
     */
    public function merge(NavigationItem $item)
    {
        parent::merge($item);

        $this->setDashlets(array_merge(
            $this->getDashlets(false),
            $item->getDashlets(false)
        ));
    }
}