icingaweb2/library/Icinga/Web/Widget/Tabs.php

<?php

/**
 * Navigation tabs
 */
namespace Icinga\Web\Widget;

use Icinga\Exception\ProgrammingError;
use Icinga\Web\Url;

use Countable;

/**
 * Navigation tab widget
 *
 * Useful if you want to create navigation tabs
 *
 * @copyright  Copyright (c) 2013 Icinga-Web Team <info@icinga.org>
 * @author     Icinga-Web Team <info@icinga.org>
 * @license    http://www.gnu.org/copyleft/gpl.html GNU General Public License
 */
class Tabs extends AbstractWidget implements Countable
{
    /**
     * This is where single tabs added to this container will be stored
     *
     * @var array
     */
    protected $tabs = array();

    /**
     * The name of the currently activated tab
     *
     * @var string
     */
    protected $active;

    /**
     * Class name(s) going to be assigned to the &lt;ul&gt; element
     *
     * @var string
     */
    protected $tab_class = 'nav-tabs';

    protected $specialActions = false;

    /**
     * Activate the tab with the given name
     *
     * If another tab is currently active it will be deactivated
     *
     * @param  string $name Name of the tab going to be activated
     *
     * @throws ProgrammingError if given tab name doesn't exist
     *
     * @return self
     */
    public function activate($name)
    {
        if ($this->has($name)) {
            if ($this->active !== null) {
                $this->tabs[$this->active]->setActive(false);
            }
            $this->get($name)->setActive();
            $this->active = $name;
            return $this;
        }

        throw new ProgrammingError(
            sprintf(
                "Cannot activate a tab that doesn't exist: %s. Available: %s",
                $name,
                empty($this->tabs)
                ? 'none'
                : implode(', ', array_keys($this->tabs))
            )
        );
    }

    public function getActiveName()
    {
        return $this->active;
    }

    /**
     * Set the CSS class name(s) for the &lt;ul&gt; element
     *
     * @param  string $name CSS class name(s)
     *
     * @return self
     */
    public function setClass($name)
    {
        $this->tab_class = $name;
        return $this;
    }

    /**
     * Whether the given tab name exists
     *
     * @param  string $name Tab name
     *
     * @return bool
     */
    public function has($name)
    {
        return array_key_exists($name, $this->tabs);
    }

    /**
     * Whether the given tab name exists
     *
     * @param  string $name The tab you're interested in
     *
     * @throws ProgrammingError if given tab name doesn't exist
     *
     * @return Tab
     */
    public function get($name)
    {
        if (! $this->has($name)) {
            throw new ProgrammingError(
                sprintf(
                    'There is no such tab: %s',
                    $name
                )
            );
        }
        return $this->tabs[$name];
    }

    /**
     * Add a new tab
     *
     * A unique tab name is required, the Tab itself can either be an array
     * with tab properties or an instance of an existing Tab
     *
     * @param  string $name                The new tab name
     * @param  array|Tab The tab itself of it's properties
     *
     * @throws ProgrammingError if tab name already exists
     *
     * @return self
     */
    public function add($name, $tab)
    {
        if ($this->has($name)) {
            throw new ProgrammingError(
                sprintf(
                    'Cannot add a tab named "%s" twice"',
                    $name
                )
            );
        }
        return $this->set($name, $tab);
    }

    /**
     * Set a tab
     *
     * A unique tab name is required, will be replaced in case it already
     * exists. The tab can either be an array with tab properties or an instance
     * of an existing Tab
     *
     * @param  string $name                The new tab name
     * @param  array|Tab The tab itself of it's properties
     *
     * @return self
     */
    public function set($name, $tab)
    {
        if ($tab instanceof Tab) {
            $this->tabs[$name] = $tab;
        } else {
            $this->tabs[$name] = new Tab($tab + array('name' => $name));
        }
        return $this;
    }

    public function enableSpecialActions()
    {
        $this->specialActions = true;
        return $this;
    }

    /**
     * This is where the tabs are going to be rendered
     *
     * @return string
     */
    public function renderAsHtml()
    {
        $view = $this->view();

        if (empty($this->tabs)) {
            return '';
        }
        $html = '<ul class="nav ' . $this->tab_class . '">' . "\n";

        foreach ($this->tabs as $tab) {
            $html .= $tab;
        }

        $special = array();
        $special[] = $this->view()->qlink(
            $this->view()->img('img/classic/application-pdf.png') . ' PDF',
            Url::fromRequest(),
            array('filetype' => 'pdf'),
            array('target' => '_blank', 'quote' => false)
        );
        $special[] = $this->view()->qlink(
            $this->view()->img('img/classic/application-csv.png') . ' CSV',
            Url::fromRequest(),
            array('format' => 'csv'),
            array('target' => '_blank', 'quote' => false)
        );
        $special[] = $this->view()->qlink(
            $this->view()->img('img/classic/application-json.png') . ' JSON',
            Url::fromRequest(),
            array('format' => 'json', 'quote' => false),
            array('target' => '_blank', 'quote' => false)
        );

        $special[] = $this->view()->qlink(
            $this->view()->img('img/classic/basket.png') . ' URL Basket',
            Url::fromPath('basket/add'),
            array('url' => Url::fromRequest()->getRelativeUrl()),
            array('quote' => false)
        );

        $special[] = $this->view()->qlink(
            $this->view()->img('img/classic/dashboard.png') . ' Dashboard',
            Url::fromPath('dashboard/addurl'),
            array('url' => Url::fromRequest()->getRelativeUrl()),
            array('quote' => false)
        );
        // $auth = Auth::getInstance();
        // if ($this->specialActions && ! empty($special) && $auth->isAuthenticated() && $auth->getUsername() === 'admin') {
        if ($this->specialActions) {
            $html .= '
               <li class="dropdown">
                <a href="#" class="dropdown-toggle" data-toggle="dropdown"><b class="caret"></b></a>
                <ul class="dropdown-menu">
            ';

            foreach ($special as $shtml) {
                $html .= '<li>' . $shtml . "</li>\n";
            }
            $html .= '    </ul>
               </li>
            ';

        }
        $html .= "</ul>\n";
        return $html;
    }

    public function count()
    {
        return count($this->tabs);
    }

    public function getTabs()
    {
        return $this->tabs;
    }
}