Initial commit

application/Espo/Modules/Crm/Jobs/ControlKnowledgeBaseArticleStatus.php

@@ -0,0 +1,64 @@
+<?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\Jobs;
+
+use Espo\Core\Utils\DateTime;
+use Espo\Core\Utils\Metadata;
+use Espo\Modules\Crm\Entities\KnowledgeBaseArticle;
+use Espo\Core\Job\JobDataLess;
+use Espo\Core\ORM\EntityManager;
+
+class ControlKnowledgeBaseArticleStatus implements JobDataLess
+{
+    public function __construct(
+        private EntityManager $entityManager,
+        private Metadata $metadata
+    ) {}
+
+    public function run(): void
+    {
+        $statusList = $this->metadata->get("entityDefs.KnowledgeBaseArticle.fields.status.activeOptions") ??
+            [KnowledgeBaseArticle::STATUS_PUBLISHED];
+
+        $list = $this->entityManager
+            ->getRDBRepository(KnowledgeBaseArticle::ENTITY_TYPE)
+            ->where([
+                'expirationDate<=' => date(DateTime::SYSTEM_DATE_FORMAT),
+                'status' => $statusList,
+            ])
+            ->find();
+
+        foreach ($list as $e) {
+            $e->set('status', KnowledgeBaseArticle::STATUS_ARCHIVED);
+
+            $this->entityManager->saveEntity($e);
+        }
+    }
+}

application/Espo/Modules/Crm/Jobs/ProcessMassEmail.php

@@ -0,0 +1,103 @@
+<?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\Jobs;
+
+use Espo\Core\Job\JobDataLess;
+use Espo\Core\ORM\EntityManager;
+use Espo\Core\Utils\DateTime;
+use Espo\Core\Utils\Log;
+use Espo\Modules\Crm\Entities\MassEmail;
+use Espo\Modules\Crm\Tools\MassEmail\QueueCreator;
+use Espo\Modules\Crm\Tools\MassEmail\SendingProcessor;
+use Throwable;
+
+/**
+ * @noinspection PhpUnused
+ */
+class ProcessMassEmail implements JobDataLess
+{
+    public function __construct(
+        private SendingProcessor $processor,
+        private QueueCreator $queue,
+        private EntityManager $entityManager,
+        private Log $log
+    ) {}
+
+    public function run(): void
+    {
+        $this->processCreateQueue();
+        $this->processSend();
+    }
+
+    private function processCreateQueue(): void
+    {
+        $pendingMassEmails = $this->entityManager
+            ->getRDBRepositoryByClass(MassEmail::class)
+            ->where([
+                'status' => MassEmail::STATUS_PENDING,
+                'startAt<=' => date(DateTime::SYSTEM_DATE_TIME_FORMAT),
+            ])
+            ->find();
+
+        foreach ($pendingMassEmails as $massEmail) {
+            try {
+                $this->queue->create($massEmail);
+            } catch (Throwable $e) {
+                $this->log->error("Create queue error. {id}. {message}", [
+                    'id' => $massEmail->getId(),
+                    'message' => $e->getMessage(),
+                    'exception' => $e,
+                ]);
+            }
+        }
+    }
+
+    private function processSend(): void
+    {
+        $inProcessMassEmails = $this->entityManager
+            ->getRDBRepositoryByClass(MassEmail::class)
+            ->where([
+                'status' => MassEmail::STATUS_IN_PROCESS,
+            ])
+            ->find();
+
+        foreach ($inProcessMassEmails as $massEmail) {
+            try {
+                $this->processor->process($massEmail);
+            } catch (Throwable $e) {
+                $this->log->error("Sending mass email error. {id}. {message}", [
+                    'id' => $massEmail->getId(),
+                    'message' => $e->getMessage(),
+                    'exception' => $e,
+                ]);
+            }
+        }
+    }
+}

application/Espo/Modules/Crm/Jobs/SendEmailReminders.php

@@ -0,0 +1,95 @@
+<?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\Jobs;
+
+use Espo\Core\InjectableFactory;
+use Espo\Core\Job\JobDataLess;
+use Espo\Core\ORM\EntityManager;
+use Espo\Core\Utils\Config;
+use Espo\Core\Utils\DateTime as DateTimeUtil;
+use Espo\Core\Utils\Log;
+use Espo\Modules\Crm\Tools\Reminder\Sender\EmailReminder;
+use Espo\Modules\Crm\Entities\Reminder;
+use Throwable;
+use DateTime;
+use DateInterval;
+
+class SendEmailReminders implements JobDataLess
+{
+    private const MAX_PORTION_SIZE = 10;
+
+    public function __construct(
+        private InjectableFactory $injectableFactory,
+        private EntityManager $entityManager,
+        private Config $config,
+        private Log $log
+    ) {}
+
+    public function run(): void
+    {
+        $dt = new DateTime();
+
+        $now = $dt->format(DateTimeUtil::SYSTEM_DATE_TIME_FORMAT);
+
+        $nowShifted = $dt
+            ->sub(new DateInterval('PT1H'))
+            ->format(DateTimeUtil::SYSTEM_DATE_TIME_FORMAT);
+
+        $maxPortionSize = $this->config->get('emailReminderPortionSize') ?? self::MAX_PORTION_SIZE;
+
+        $collection = $this->entityManager
+            ->getRDBRepositoryByClass(Reminder::class)
+            ->where([
+                'type' => Reminder::TYPE_EMAIL,
+                'remindAt<=' => $now,
+                'startAt>' => $nowShifted,
+            ])
+            ->limit(0, $maxPortionSize)
+            ->find();
+
+        if (count($collection) === 0) {
+            return;
+        }
+
+        $emailReminder = $this->injectableFactory->create(EmailReminder::class);
+
+        foreach ($collection as $entity) {
+            try {
+                $emailReminder->send($entity);
+            } catch (Throwable $e) {
+                $this->log->error("Email reminder '{$entity->getId()}': " . $e->getMessage());
+            }
+
+            $this->entityManager
+                ->getRDBRepository(Reminder::ENTITY_TYPE)
+                ->deleteFromDb($entity->getId());
+        }
+    }
+}

application/Espo/Modules/Crm/Jobs/SubmitPopupReminders.php

@@ -0,0 +1,173 @@
+<?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\Jobs;
+
+use Espo\Core\Name\Field;
+use Espo\Core\ORM\Entity as CoreEntity;
+use Espo\Core\WebSocket\ConfigDataProvider;
+use Espo\Modules\Crm\Entities\Meeting;
+use Espo\Modules\Crm\Entities\Reminder;
+use Espo\Core\Job\JobDataLess;
+use Espo\Core\ORM\EntityManager;
+use Espo\Core\Utils\Config;
+use Espo\Core\Utils\DateTime as DateTimeUtil;
+use Espo\Core\Utils\Log;
+use Espo\Core\WebSocket\Submission as WebSocketSubmission;
+
+use Throwable;
+use DateTime;
+
+/**
+ * @noinspection PhpUnused
+ */
+class SubmitPopupReminders implements JobDataLess
+{
+    private const REMINDER_PAST_HOURS = 24;
+
+    public function __construct(
+        private EntityManager $entityManager,
+        private Config $config,
+        private WebSocketSubmission $webSocketSubmission,
+        private Log $log,
+        private ConfigDataProvider $webSocketConfig,
+    ) {}
+
+    public function run(): void
+    {
+        if (!$this->webSocketConfig->isEnabled()) {
+            return;
+        }
+
+        $dt = new DateTime();
+        $now = $dt->format(DateTimeUtil::SYSTEM_DATE_TIME_FORMAT);
+
+        $pastHours = $this->config->get('reminderPastHours', self::REMINDER_PAST_HOURS);
+
+        $nowShifted = $dt
+            ->modify('-' . $pastHours . ' hours')
+            ->format(DateTimeUtil::SYSTEM_DATE_TIME_FORMAT);
+
+        $reminderList = $this->entityManager
+            ->getRDBRepositoryByClass(Reminder::class)
+            ->where([
+                'type' => Reminder::TYPE_POPUP,
+                'remindAt<=' => $now,
+                'startAt>' => $nowShifted,
+                'isSubmitted' => false,
+            ])
+            ->find();
+
+        $submitData = [];
+
+        foreach ($reminderList as $reminder) {
+            $userId = $reminder->getUserId();
+            $entityType = $reminder->getTargetEntityType();
+            $entityId = $reminder->getTargetEntityId();
+
+            if (
+                !$userId ||
+                !$entityType ||
+                !$entityId ||
+                !$this->entityManager->hasRepository($entityType)
+            ) {
+                $this->deleteReminder($reminder);
+
+                continue;
+            }
+
+            $entity = $this->entityManager->getEntityById($entityType, $entityId);
+
+            if (!$entity) {
+                $this->deleteReminder($reminder);
+
+                continue;
+            }
+
+            if (
+                $entity instanceof CoreEntity &&
+                $entity->hasLinkMultipleField('users') &&
+                $entity->hasAttribute('usersColumns')
+            ) {
+                $status = $entity->getLinkMultipleColumn('users', 'status', $userId);
+
+                if ($status === Meeting::ATTENDEE_STATUS_DECLINED) {
+                    $this->deleteReminder($reminder);
+
+                    continue;
+                }
+            }
+
+            $dateField = 'dateStart';
+
+            $entityDefs = $this->entityManager->getDefs()->getEntity($entityType);
+
+            if ($entityDefs->hasField('reminders')) {
+                $dateField = $entityDefs
+                    ->getField('reminders')
+                    ->getParam('dateField') ?? $dateField;
+            }
+
+            $submitData[$userId] ??= [];
+
+            $submitData[$userId][] = [
+                'id' => $reminder->getId(),
+                'data' => (object) [
+                    'id' => $entity->getId(),
+                    'entityType' => $entityType,
+                    'name' => $entity->get(Field::NAME),
+                    'dateField' => $dateField,
+                    'attributes' => (object) [
+                        $dateField => $entity->get($dateField),
+                        $dateField . 'Date' => $entity->get($dateField . 'Date'),
+                    ],
+                ],
+            ];
+
+            $reminder->set('isSubmitted', true);
+
+            $this->entityManager->saveEntity($reminder);
+        }
+
+        foreach ($submitData as $userId => $list) {
+            try {
+                $this->webSocketSubmission->submit('popupNotifications.event', $userId, ['list' => $list]);
+            } catch (Throwable $e) {
+                $this->log->error('Job SubmitPopupReminders: [' . $e->getCode() . '] ' .$e->getMessage());
+            }
+        }
+    }
+
+    private function deleteReminder(Reminder $reminder): void
+    {
+        $this->entityManager
+            ->getRDBRepository(Reminder::ENTITY_TYPE)
+            ->deleteFromDb($reminder->getId());
+    }
+}