<?php
// {{{ICINGA_LICENSE_CODE}}}
// -----------------------------------------------------------------------------
// This file is part of icinga-web.
// 
// Copyright (c) 2009-2013 Icinga Developer Team.
// All rights reserved.
// 
// icinga-web is free software: you can redistribute it and/or modify
// it under the terms of the GNU General Public License as published by
// the Free Software Foundation, either version 3 of the License, or
// (at your option) any later version.
// 
// icinga-web is distributed in the hope that it will be useful,
// but WITHOUT ANY WARRANTY; without even the implied warranty of
// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
// GNU General Public License for more details.
// 
// You should have received a copy of the GNU General Public License
// along with icinga-web.  If not, see <http://www.gnu.org/licenses/>.
// -----------------------------------------------------------------------------
// {{{ICINGA_LICENSE_CODE}}}


/**
 * The base view from which all project views inherit.
 */
class IcingaBaseView extends AgaviView {
    const SLOT_LAYOUT_NAME = 'slot';

    /**
     * Handles output types that are not handled elsewhere in the view. The
     * default behavior is to simply throw an exception.
     *
     * @param      AgaviRequestDataHolder The request data associated with
     *                                    this execution.
     *
     * @throws     AgaviViewException if the output type is not handled.
     */
    public final function execute(AgaviRequestDataHolder $rd) {
        throw new AgaviViewException(sprintf(
                                         'The view "%1$s" does not implement an "execute%3$s()" method to serve '.
                                         'the output type "%2$s", and the base view "%4$s" does not implement an '.
                                         '"execute%3$s()" method to handle this situation.',
                                         get_class($this),
                                         $this->container->getOutputType()->getName(),
                                         ucfirst(strtolower($this->container->getOutputType()->getName())),
                                         get_class()
                                     ));
    }

    /**
     * Prepares the HTML output type.
     *
     * @param      AgaviRequestDataHolder The request data associated with
     *                                    this execution.
     * @param      string The layout to load.
     */
    public function setupHtml(AgaviRequestDataHolder $rd, $layoutName = null) {
        if ($layoutName === null && $this->getContainer()->getParameter('is_slot', false)) {
            // it is a slot, so we do not load the default layout, but a different one
            // otherwise, we could end up with an infinite loop
            $layoutName = self::SLOT_LAYOUT_NAME;
        }

        // now load the layout
        // this method returns an array containing the parameters that were declared on the layout (not on a layer!) in output_types.xml
        // you could use this, for instance, to automatically set a bunch of CSS or Javascript includes based on layout parameters -->
        $this->loadLayout($layoutName);
    }

    public function initialize(AgaviExecutionContainer $container) {
        parent::initialize($container);

        if ($this->getAttribute('redirect', false) !== false) {
            $params = $this->getAttribute('redirect_params', array());
            $this->getResponse()->setRedirect($this->getContext()->getRouting()->gen($this->getAttribute('redirect'), $params));
        }

    }

    /**
     * Execute html within a slot layout only without
     * implementing a new layout method in the corresponding
     * views
     *
     * @param AgaviRequestDataHolder $rd
     * @return mixed
     */
    public function executeSimple(AgaviRequestDataHolder $rd) {
        $rd->setParameter('is_slot', true);
        return $this->executeHtml($rd);
    }
}

?>
