0byt3m1n1

Path: /data/applications/aps.bak/phprojekt/6.0.6-0/standard/htdocs/application/Default/Helpers/ [ Home ]
File: Save.php
<?php
/**
 * Helper to save tree nodes and models.
 *
 * This software is free software; you can redistribute it and/or
 * modify it under the terms of the GNU Lesser General Public
 * License version 3 as published by the Free Software Foundation
 *
 * This library 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
 * Lesser General Public License for more details.
 *
 * @category   PHProjekt
 * @package    Application
 * @subpackage Default
 * @copyright  Copyright (c) 2010 Mayflower GmbH (http://www.mayflower.de)
 * @license    LGPL v3 (See LICENSE file)
 * @link       http://www.phprojekt.com
 * @since      File available since Release 6.0
 * @version    Release: 6.0.6
 * @author     David Soria Parra <soria_parra@mayflower.de>
 */

/**
 * Helper to save tree nodes and models.
 *
 * @category   PHProjekt
 * @package    Application
 * @subpackage Default
 * @copyright  Copyright (c) 2010 Mayflower GmbH (http://www.mayflower.de)
 * @license    LGPL v3 (See LICENSE file)
 * @link       http://www.phprojekt.com
 * @since      File available since Release 6.0
 * @version    Release: 6.0.6
 * @author     David Soria Parra <soria_parra@mayflower.de>
 */
final class Default_Helpers_Save
{
    /**
     * Save a tree.
     *
     * @param Phprojekt_Tree_Node_Database $node     The project to save.
     * @param array                        $params   The parameters used to feed the model.
     * @param integer|null                 $parentId The parent ID.
     *
     * @throws Exception If validation of parameters fails.
     *
     * @return boolean True for a sucessful save.
     */
    protected static function _saveTree(Phprojekt_Tree_Node_Database $node, array $params, $parentId = null)
    {
        $node = $node->setup();

        if (null === $parentId) {
            $parentId = $node->getParentNode()->id;
        }

        $parentNode = new Phprojekt_Tree_Node_Database($node->getActiveRecord(), $parentId);
        $parentNode = $parentNode->setup();

        // Assign the values
        foreach ($params as $k => $v) {
            if (isset($node->$k)) {
                $node->$k = $v;
            }
        }

        if (empty($node->getActiveRecord()->id)) {
            $newItem = true;
        } else {
            $newItem = false;
        }

        // Set the owner
        if ($newItem && isset($node->ownerId)) {
            $node->ownerId = Phprojekt_Auth::getUserId();
        }

        // Parent Project
        if (!isset($node->projectId) || null === $node->projectId) {
            $node->projectId = 1;
        }
        $projectId = $node->projectId;

        // Checks
        if (!$node->getActiveRecord()->recordValidate()) {
            $errors = $node->getActiveRecord()->getError();
            $error  = array_pop($errors);
            throw new Phprojekt_PublishedException($error['label'] . ': ' . $error['message']);
        } else if (!self::_checkModule(1, $projectId)) {
            throw new Phprojekt_PublishedException('You do not have access to add projects on the parent project');
        } else if (!self::_checkItemRights($node->getActiveRecord(), 'Project')) {
            throw new Phprojekt_PublishedException('You do not have access to do this action');
        } else {
            if (null === $node->id || $node->id == 0) {
                $parentNode->appendNode($node);
            } else {
                $node->projectId = 0;
                $node->setParentNode($parentNode);
            }

            // Save access, modules and roles only if the user have "admin" right
            $itemRights = Phprojekt_Loader::getLibraryClass('Phprojekt_Item_Rights');
            $check      = $itemRights->getRights(1, $node->getActiveRecord()->id);
            if ($check['currentUser']['admin']) {
                $rights = Default_Helpers_Right::getItemRights($params, 1, $newItem);

                if (count($rights) > 0) {
                    $node->getActiveRecord()->saveRights($rights);
                }

                // Save the module-project relation
                if (isset($params['moduleRelation'])) {
                    if (!isset($params['checkModuleRelation'])) {
                        $params['checkModuleRelation'] = array();
                    }
                    $saveModules = array();
                    foreach ($params['checkModuleRelation'] as $checkModule => $checkValue) {
                        if ($checkValue == 1) {
                            $saveModules[] = $checkModule;
                        }
                    }
                    $node->getActiveRecord()->saveModules($saveModules);
                }

                // Save the role-user-project relation
                if (isset($params['userRelation'])) {
                    $model = Phprojekt_Loader::getModel('Project', 'ProjectRoleUserPermissions');
                    $model->saveRelation($params['roleRelation'], array_keys($params['userRelation']),
                        $node->getActiveRecord()->id);
                }
            }

            return $node->getActiveRecord();
        }
    }

    /**
     * Help to save a model by setting the models properties.
     * Validation is based on the ModelInformation implementation.
     *
     * @param Phprojekt_Model_Interface $model  The model
     * @param array                     $params The parameters used to feed the model.
     *
     * @throws Exception If validation of parameters fails.
     *
     * @return boolean True for a sucessful save.
     */
    protected static function _saveModel(Phprojekt_Model_Interface $model, array $params)
    {
        foreach ($params as $k => $v) {
            if (isset($model->$k)) {
                // Don't allow to set the id on save, since it is done by the ActiveRecord
                if (!in_array($k, array('id'))) {
                    $model->$k = $v;
                }
            }
        }

        if (empty($model->id)) {
            $newItem = true;
        } else {
            $newItem = false;
        }

        // Set the owner
        if ($newItem && isset($model->ownerId)) {
            $model->ownerId = Phprojekt_Auth::getUserId();
        }

        // Parent Project
        if (isset($model->projectId)) {
            $projectId = $model->projectId;
        } else {
            $projectId = 0;
        }

        // Checks
        $moduleName = Phprojekt_Loader::getModuleFromObject($model);
        $moduleId   = Phprojekt_Module::getId($moduleName);
        if (!$model->recordValidate()) {
            $errors = $model->getError();
            $error  = array_pop($errors);
            throw new Phprojekt_PublishedException($error['label'] . ': ' . $error['message']);
        } else if (!self::_checkModule($moduleId, $projectId)) {
            throw new Phprojekt_PublishedException('The parent project do not have enabled this module');
        } else if (!self::_checkItemRights($model, $moduleName)) {
            throw new Phprojekt_PublishedException('You do not have access to do this action');
        } else {
            // Set the projectId to 1 for global modules
            // @TODO Remove the Timecard limitation
            if (isset($model->projectId) && Phprojekt_Module::saveTypeIsGlobal($moduleId)
                && Phprojekt_Module::getModuleName($moduleId) != 'Timecard') {
                $model->projectId = 1;
            }

            $model->save();

            // Save access only if the user have "admin" right
            $itemRights = Phprojekt_Loader::getLibraryClass('Phprojekt_Item_Rights');
            $check      = $itemRights->getRights($moduleId, $model->id);
            if ($check['currentUser']['admin']) {
                if ($moduleName == 'Core') {
                    $rights = Default_Helpers_Right::getModuleRights($params);
                } else {
                    $rights = Default_Helpers_Right::getItemRights($params, $moduleId, $newItem);
                }

                if (count($rights) > 0) {
                    $model->saveRights($rights);
                }
            }

            return $model;
        }
    }

    /**
     * Overwrite call to support multiple save routines.
     *
     * @throws Exception If validation of parameters fails.
     *
     * @return void
     */
    public static function save()
    {
        $arguments = func_get_args();
        $model     = $arguments[0];
        $params    = $arguments[1];

        if (func_num_args() < 2) {
            throw new Phprojekt_PublishedException('Two arguments expected');
        }

        if (!is_array($params)) {
            throw new Phprojekt_PublishedException('Second parameter needs to be an array');
        }

        if ($model instanceof Phprojekt_Tree_Node_Database) {
            if (func_num_args() == 3) {
                $parentId = $arguments[2];
            } else if (array_key_exists('projectId', $params)) {
                $parentId = $params['projectId'];
            } else {
                throw new Phprojekt_PublishedException('No parent id found in parameters or passed');
            }

            $return = self::_saveTree($model, $params, $parentId);

            // Send mail notification?
            if (array_key_exists('sendNotification', $params)) {
                if ($params['sendNotification'] == 1) {
                    $model->getActiveRecord()->getNotification()->send(Phprojekt_Notification::TRANSPORT_MAIL_TEXT);
                }
            }

            if (Phprojekt::getInstance()->getConfig()->frontendMessages) {
                $model->getActiveRecord()->getNotification()->saveFrontendMessage();
            }

            return $return;
        }

        if ($model instanceof Phprojekt_Model_Interface) {
            $return = self::_saveModel($model, $params);

            // Send mail notification?
            if (array_key_exists('sendNotification', $params)) {
                if ($params['sendNotification'] == 1) {
                    $model->getNotification()->send(Phprojekt_Notification::TRANSPORT_MAIL_TEXT);
                }
            }

            if (Phprojekt::getInstance()->getConfig()->frontendMessages) {
                if (method_exists($model, 'getNotification')) {
                    $model->getNotification()->saveFrontendMessage();
                }
            }

            return $return;

        }

        return true;
    }

    /**
     * Check if the parent project has this module enabled.
     *
     * @param integer $projectId The project ID to check.
     *
     * @return boolean False if not.
     */
    private static function _checkModule($moduleId, $projectId)
    {
        $boolean = false;
        if ($projectId > 0) {
            if ($projectId == 1 && !Phprojekt_Module::saveTypeIsNormal($moduleId)) {
                $boolean = true;
            } else {
                if (!Phprojekt_Module::saveTypeIsNormal($moduleId)) {
                    $boolean = true;
                } else {
                    $relation = Phprojekt_Loader::getModel('Project', 'ProjectModulePermissions');
                    $modules  = $relation->getProjectModulePermissionsById($projectId);
                    if ($modules['data'][$moduleId]['inProject']) {
                        $boolean = true;
                    } else {
                        $boolean = false;
                    }
                }
            }
        } else {
            $boolean = true;
        }
        return $boolean;
    }

    /**
     * Check if the user has write access to the item if is not a global module.
     *
     * @param Phprojekt_Model_Interface $model      The model to save.
     * @param string                    $moduleName The current module.
     *
     * @return boolean False if not.
     */
    private static function _checkItemRights($model, $moduleName)
    {
        $canWrite = false;

        if ($moduleName == 'Core') {
            return Phprojekt_Auth::isAdminUser();
        } else if (Phprojekt_Module::saveTypeIsNormal(Phprojekt_Module::getId($moduleName))) {
            $itemRights = $model->getRights();

            if (isset($itemRights['currentUser'])) {
                if (!$itemRights['currentUser']['write']  &&
                    !$itemRights['currentUser']['create'] &&
                    !$itemRights['currentUser']['copy']   &&
                    !$itemRights['currentUser']['admin']) {
                    $canWrite = false;
                } else {
                    $canWrite = true;
                }
            }
        } else {
            $canWrite = true;
        }

        return $canWrite;
    }
}