espocrm-base/application/Espo/Services/Preferences.php

<?php
/************************************************************************
 * This file is part of EspoCRM.
 *
 * EspoCRM - Open Source CRM application.
 * Copyright (C) 2014-2021 Yurii Kuznietsov, Taras Machyshyn, Oleksii Avramenko
 * Website: https://www.espocrm.com
 *
 * EspoCRM 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.
 *
 * EspoCRM 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 EspoCRM. If not, see http://www.gnu.org/licenses/.
 *
 * The interactive user interfaces in modified source and object code versions
 * of this program must display Appropriate Legal Notices, as required under
 * Section 5 of the GNU General Public License version 3.
 *
 * In accordance with Section 7(b) of the GNU General Public License version 3,
 * these Appropriate Legal Notices must retain the display of the "EspoCRM" word.
 ************************************************************************/

namespace Espo\Services;

use Espo\ORM\EntityManager;

use Espo\Entities\{
    User,
    Preferences as PreferencesEntity,
};

use Espo\Core\{
    Exceptions\Forbidden,
    Exceptions\NotFound,
    Utils\Crypt,
    Acl\Table,
    Acl,
    Utils\Config,
};

use StdClass;

class Preferences
{
    private $entityManager;

    private $user;

    private $crypt;

    private $acl;

    private $config;

    public function __construct(
        EntityManager $entityManager,
        User $user,
        Crypt $crypt,
        Acl $acl,
        Config $config
    ) {
        $this->entityManager = $entityManager;
        $this->user = $user;
        $this->crypt = $crypt;
        $this->acl = $acl;
        $this->config = $config;
    }

    protected function processAccessCheck(string $userId): void
    {
        if (!$this->user->isAdmin()) {
            if ($this->user->getId() !== $userId) {
                throw new Forbidden();
            }
        }
    }

    public function read(string $userId): PreferencesEntity
    {
        $this->processAccessCheck($userId);

        $entity = $this->entityManager->getEntity('Preferences', $userId);
        $user = $this->entityManager->getEntity('User', $userId);

        if (!$entity || !$user) {
            throw new NotFound();
        }

        $entity->set('smtpEmailAddress', $user->get('emailAddress'));
        $entity->set('name', $user->get('name'));
        $entity->set('isPortalUser', $user->isPortal());

        $entity->clear('smtpPassword');

        $fobiddenAttributeList = $this->acl
            ->getScopeForbiddenAttributeList('Preferences', Table::ACTION_READ);

        foreach ($fobiddenAttributeList as $attribute) {
            $entity->clear($attribute);
        }

        return $entity;
    }

    public function update(string $userId, StdClass $data): PreferencesEntity
    {
        $this->processAccessCheck($userId);

        if ($this->acl->getLevel('Preferences', Table::ACTION_EDIT) === Table::LEVEL_NO) {
            throw new Forbidden();
        }

        $fobiddenAttributeList = $this->acl
            ->getScopeForbiddenAttributeList('Preferences', Table::ACTION_EDIT);

        foreach ($fobiddenAttributeList as $attribute) {
            unset($data->$attribute);
        }

        if (property_exists($data, 'smtpPassword')) {
            $data->smtpPassword = $this->crypt->encrypt($data->smtpPassword);
        }

        $user = $this->entityManager->getEntity('User', $userId);

        $entity = $this->entityManager->getEntity('Preferences', $userId);

        if (!$entity || !$user) {
            throw new NotFound();
        }

        $entity->set($data);

        $this->entityManager->saveEntity($entity);

        $entity->set('smtpEmailAddress', $user->get('emailAddress'));
        $entity->set('name', $user->get('name'));

        $entity->clear('smtpPassword');

        return $entity;
    }

    public function resetToDefaults(string $userId): void
    {
        $this->processAccessCheck($userId);

        $result = $this->entityManager
            ->getRepository('Preferences')
            ->resetToDefaults($userId);

        if (!$result) {
            throw new NotFound();
        }
    }

    public function resetDashboard(string $userId): StdClass
    {
        $this->processAccessCheck($userId);

        if ($this->acl->getLevel('Preferences', Table::ACTION_EDIT) === Table::LEVEL_NO) {
            throw new Forbidden();
        }

        $user = $this->entityManager->getEntity('User', $userId);

        $preferences = $this->entityManager->getEntity('Preferences', $userId);

        if (!$user) {
            throw new NotFound();
        }

        if (!$preferences) {
            throw new NotFound();
        }

        if ($user->isPortal()) {
            throw new Forbidden();
        }

        $forbiddenAttributeList = $this->acl
            ->getScopeForbiddenAttributeList('Preferences', Table::ACTION_EDIT);

        if (in_array('dashboardLayout', $forbiddenAttributeList)) {
            throw new Forbidden();
        }

        $dashboardLayout = $this->config->get('dashboardLayout');
        $dashletsOptions = $this->config->get('dashletsOptions');

        $preferences->set([
            'dashboardLayout' => $dashboardLayout,
            'dashletsOptions' => $dashletsOptions,
        ]);

        $this->entityManager->saveEntity($preferences);

        return (object) [
            'dashboardLayout' => $preferences->get('dashboardLayout'),
            'dashletsOptions' => $preferences->get('dashletsOptions'),
        ];
    }
}