Initial commit

application/Espo/Modules/Crm/Hooks/Meeting/CalendarWebSocket.php

@@ -0,0 +1,66 @@
+<?php
+/************************************************************************
+ * This file is part of EspoCRM.
+ *
+ * EspoCRM – Open Source CRM application.
+ * Copyright (C) 2014-2025 EspoCRM, Inc.
+ * Website: https://www.espocrm.com
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program 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 Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with this program. If not, see <https://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 Affero General Public License version 3.
+ *
+ * In accordance with Section 7(b) of the GNU Affero General Public License version 3,
+ * these Appropriate Legal Notices must retain the display of the "EspoCRM" word.
+ ************************************************************************/
+
+namespace Espo\Modules\Crm\Hooks\Meeting;
+
+use Espo\Core\Hook\Hook\AfterRemove;
+use Espo\Core\Hook\Hook\AfterSave;
+use Espo\Core\WebSocket\Submission;
+use Espo\Modules\Crm\Entities\Meeting;
+use Espo\ORM\Entity;
+use Espo\ORM\Repository\Option\RemoveOptions;
+use Espo\ORM\Repository\Option\SaveOptions;
+
+/**
+ * @implements AfterSave<Meeting>
+ * @implements AfterRemove<Meeting>
+ */
+class CalendarWebSocket implements AfterSave, AfterRemove
+{
+    public function __construct(
+        private Submission $submission,
+    ) {}
+
+    public function afterSave(Entity $entity, SaveOptions $options): void
+    {
+        $this->process($entity);
+    }
+
+    public function afterRemove(Entity $entity, RemoveOptions $options): void
+    {
+        $this->process($entity);
+    }
+
+    private function process(Meeting $entity): void
+    {
+        foreach ($entity->getUsers()->getIdList() as $userId) {
+            $this->submission->submit('calendarUpdate', $userId);
+        }
+    }
+}

application/Espo/Modules/Crm/Hooks/Meeting/EmailCreatedEvent.php

@@ -0,0 +1,72 @@
+<?php
+/************************************************************************
+ * This file is part of EspoCRM.
+ *
+ * EspoCRM – Open Source CRM application.
+ * Copyright (C) 2014-2025 EspoCRM, Inc.
+ * Website: https://www.espocrm.com
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program 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 Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with this program. If not, see <https://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 Affero General Public License version 3.
+ *
+ * In accordance with Section 7(b) of the GNU Affero General Public License version 3,
+ * these Appropriate Legal Notices must retain the display of the "EspoCRM" word.
+ ************************************************************************/
+
+namespace Espo\Modules\Crm\Hooks\Meeting;
+
+use Espo\Core\ORM\Repository\Option\SaveOption;
+use Espo\Entities\Email;
+use Espo\ORM\EntityManager;
+use Espo\ORM\Entity;
+
+class EmailCreatedEvent
+{
+    private EntityManager $entityManager;
+
+    public function __construct(EntityManager $entityManager)
+    {
+        $this->entityManager = $entityManager;
+    }
+
+    /**
+     * @param array<string, mixed> $options
+     */
+    public function afterRemove(Entity $entity, array $options): void
+    {
+        if (!empty($options[SaveOption::SILENT])) {
+            return;
+        }
+
+        $updateQuery = $this->entityManager
+            ->getQueryBuilder()
+            ->update()
+            ->in(Email::ENTITY_TYPE)
+            ->set([
+                'createdEventId' => null,
+                'createdEventType' => null,
+            ])
+            ->where([
+                'createdEventId' => $entity->getId(),
+                'createdEventType' => $entity->getEntityType()
+            ])
+            ->limit(1)
+            ->build();
+
+        $this->entityManager->getQueryExecutor()->execute($updateQuery);
+    }
+}

application/Espo/Modules/Crm/Hooks/Meeting/ParentLink.php

@@ -0,0 +1,133 @@
+<?php
+/************************************************************************
+ * This file is part of EspoCRM.
+ *
+ * EspoCRM – Open Source CRM application.
+ * Copyright (C) 2014-2025 EspoCRM, Inc.
+ * Website: https://www.espocrm.com
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program 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 Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with this program. If not, see <https://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 Affero General Public License version 3.
+ *
+ * In accordance with Section 7(b) of the GNU Affero General Public License version 3,
+ * these Appropriate Legal Notices must retain the display of the "EspoCRM" word.
+ ************************************************************************/
+
+namespace Espo\Modules\Crm\Hooks\Meeting;
+
+use Espo\Core\Hook\Hook\BeforeSave;
+use Espo\Core\Name\Field;
+use Espo\Core\ORM\Entity as CoreEntity;
+use Espo\Modules\Crm\Entities\Account;
+use Espo\Modules\Crm\Entities\Lead;
+use Espo\ORM\Defs\Params\RelationParam;
+use Espo\ORM\Entity;
+use Espo\ORM\EntityManager;
+use Espo\ORM\Name\Attribute;
+use Espo\ORM\Repository\Option\SaveOptions;
+
+/**
+ * @implements BeforeSave<Entity>
+ */
+class ParentLink implements BeforeSave
+{
+    public function __construct(private EntityManager $entityManager) {}
+
+    public function beforeSave(Entity $entity, SaveOptions $options): void
+    {
+        if (!$entity->isNew() && $entity->isAttributeChanged('parentId')) {
+            $entity->set('accountId', null);
+        }
+
+        if (!$entity->isAttributeChanged('parentId') && !$entity->isAttributeChanged('parentType')) {
+            return;
+        }
+
+        $parent = null;
+
+        $parentId = $entity->get('parentId');
+        $parentType = $entity->get('parentType');
+
+        if ($parentId && $parentType && $this->entityManager->hasRepository($parentType)) {
+            $columnList = ['id', 'name'];
+
+            $defs = $this->entityManager->getMetadata()->getDefs();
+
+            if ($defs->getEntity($parentType)->hasAttribute('accountId')) {
+                $columnList[] = 'accountId';
+
+            }
+
+            if ($parentType === Lead::ENTITY_TYPE) {
+                $columnList[] = 'status';
+                $columnList[] = 'createdAccountId';
+                $columnList[] = 'createdAccountName';
+            }
+
+            $parent = $this->entityManager
+                ->getRDBRepository($parentType)
+                ->select($columnList)
+                ->where([Attribute::ID => $parentId])
+                ->findOne();
+        }
+
+        $accountId = null;
+        $accountName = null;
+
+        if ($parent) {
+            if ($parent instanceof Account) {
+                $accountId = $parent->getId();
+                $accountName = $parent->get(Field::NAME);
+            } else if (
+                $parent instanceof Lead &&
+                $parent->getStatus() === Lead::STATUS_CONVERTED &&
+                $parent->get('createdAccountId')
+            ) {
+                $accountId = $parent->get('createdAccountId');
+                $accountName = $parent->get('createdAccountName');
+            }
+
+            if (
+                !$accountId && $parent->get('accountId') &&
+                $parent instanceof CoreEntity &&
+                $parent->getRelationParam('account', RelationParam::ENTITY) === Account::ENTITY_TYPE
+            ) {
+                $accountId = $parent->get('accountId');
+            }
+
+            if ($accountId) {
+                $entity->set('accountId', $accountId);
+                $entity->set('accountName', $accountName);
+            }
+        }
+
+        if (
+            $entity->get('accountId') &&
+            !$entity->get('accountName')
+        ) {
+            $account = $this->entityManager
+                ->getRDBRepository(Account::ENTITY_TYPE)
+                ->select([Attribute::ID, Field::NAME])
+                ->where([Attribute::ID => $entity->get('accountId')])
+                ->findOne();
+
+            if ($account) {
+                $entity->set('accountName', $account->get(Field::NAME));
+            }
+        }
+    }
+}

application/Espo/Modules/Crm/Hooks/Meeting/Uid.php

@@ -0,0 +1,104 @@
+<?php
+/************************************************************************
+ * This file is part of EspoCRM.
+ *
+ * EspoCRM – Open Source CRM application.
+ * Copyright (C) 2014-2025 EspoCRM, Inc.
+ * Website: https://www.espocrm.com
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program 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 Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with this program. If not, see <https://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 Affero General Public License version 3.
+ *
+ * In accordance with Section 7(b) of the GNU Affero General Public License version 3,
+ * these Appropriate Legal Notices must retain the display of the "EspoCRM" word.
+ ************************************************************************/
+
+namespace Espo\Modules\Crm\Hooks\Meeting;
+
+use Espo\Core\Hook\Hook\BeforeSave;
+use Espo\Core\Mail\Event\EventFactory;
+use Espo\Core\Utils\Util;
+use Espo\Entities\Email;
+use Espo\Modules\Crm\Entities\Meeting;
+use Espo\ORM\Entity;
+use Espo\ORM\EntityManager;
+use Espo\ORM\Repository\Option\SaveOptions;
+use ICal\ICal;
+
+/**
+ * @implements BeforeSave<Meeting>
+ */
+class Uid implements BeforeSave
+{
+    public function __construct(private EntityManager $entityManager) {}
+
+    public function beforeSave(Entity $entity, SaveOptions $options): void
+    {
+        if (!$entity->isNew() || $entity->getUid()) {
+            return;
+        }
+
+        $uid = $this->getUid($entity);
+
+        $entity->setUid($uid);
+    }
+
+    private function getUid(Meeting $entity): string
+    {
+        $uid = $this->getIcsUid($entity);
+
+        if ($uid) {
+            return $uid;
+        }
+
+        return Util::generateUuid4();
+    }
+
+    private function getIcsUid(Meeting $entity): ?string
+    {
+        $email = $this->getEmail($entity);
+
+        if (!$email) {
+            return null;
+        }
+
+        $icsContents = $email->getIcsContents();
+
+        if (!$icsContents) {
+            return null;
+        }
+
+        $ical = new ICal();
+
+        $ical->initString($icsContents);
+
+        $espoEvent = EventFactory::createFromU01jmg3Ical($ical);
+
+        return $espoEvent->getUid();
+    }
+
+    private function getEmail(Meeting $entity): ?Email
+    {
+        $emailId = $entity->get('sourceEmailId');
+
+        if (!$emailId) {
+            return null;
+        }
+
+        return $this->entityManager->getRDBRepositoryByClass(Email::class)->getById($emailId);
+    }
+}

application/Espo/Modules/Crm/Hooks/Meeting/Users.php

@@ -0,0 +1,96 @@
+<?php
+/************************************************************************
+ * This file is part of EspoCRM.
+ *
+ * EspoCRM – Open Source CRM application.
+ * Copyright (C) 2014-2025 EspoCRM, Inc.
+ * Website: https://www.espocrm.com
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program 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 Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with this program. If not, see <https://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 Affero General Public License version 3.
+ *
+ * In accordance with Section 7(b) of the GNU Affero General Public License version 3,
+ * these Appropriate Legal Notices must retain the display of the "EspoCRM" word.
+ ************************************************************************/
+
+namespace Espo\Modules\Crm\Hooks\Meeting;
+
+use Espo\Core\Hook\Hook\BeforeSave;
+use Espo\Core\Name\Field;
+use Espo\Core\ORM\Entity as CoreEntity;
+use Espo\Core\Utils\Config;
+use Espo\Entities\User;
+use Espo\Modules\Crm\Entities\Meeting;
+use Espo\ORM\Entity;
+use Espo\ORM\Repository\Option\SaveOptions;
+
+/**
+ * @implements BeforeSave<CoreEntity>
+ */
+class Users implements BeforeSave
+{
+    public static int $order = 12;
+
+    public function __construct(
+        private Config $config,
+        private User $user
+    ) {}
+
+    /**
+     * @param CoreEntity $entity
+     */
+    public function beforeSave(Entity $entity, SaveOptions $options): void
+    {
+        if (!$this->config->get('eventAssignedUserIsAttendeeDisabled')) {
+            if ($entity->hasLinkMultipleField(Field::ASSIGNED_USERS)) {
+                $assignedUserIdList = $entity->getLinkMultipleIdList(Field::ASSIGNED_USERS);
+
+                foreach ($assignedUserIdList as $assignedUserId) {
+                    $entity->addLinkMultipleId('users', $assignedUserId);
+                    $entity->setLinkMultipleName(
+                        'users',
+                        $assignedUserId,
+                        $entity->getLinkMultipleName(Field::ASSIGNED_USERS, $assignedUserId)
+                    );
+                }
+            } else {
+                $assignedUserId = $entity->get('assignedUserId');
+
+                if ($assignedUserId) {
+                    $entity->addLinkMultipleId('users', $assignedUserId);
+                    $entity->setLinkMultipleName('users', $assignedUserId, $entity->get('assignedUserName'));
+                }
+            }
+        }
+
+        if (!$entity->isNew()) {
+            return;
+        }
+
+        $currentUserId = $this->user->getId();
+
+        if (!$entity->hasLinkMultipleId('users', $currentUserId)) {
+            return;
+        }
+
+        $status = $entity->getLinkMultipleColumn('users', 'status', $currentUserId);
+
+        if (!$status || $status === Meeting::ATTENDEE_STATUS_NONE) {
+            $entity->setLinkMultipleColumn('users', 'status', $currentUserId, Meeting::ATTENDEE_STATUS_ACCEPTED);
+        }
+    }
+}