Initial commit

custom/Espo/Modules/Advanced/Classes/ServiceActions/Meeting/SendInvitations.php

@@ -0,0 +1,115 @@
+<?php
+/***********************************************************************************
+ * The contents of this file are subject to the Extension License Agreement
+ * ("Agreement") which can be viewed at
+ * https://www.espocrm.com/extension-license-agreement/.
+ * By copying, installing downloading, or using this file, You have unconditionally
+ * agreed to the terms and conditions of the Agreement, and You may not use this
+ * file except in compliance with the Agreement. Under the terms of the Agreement,
+ * You shall not license, sublicense, sell, resell, rent, lease, lend, distribute,
+ * redistribute, market, publish, commercialize, or otherwise transfer rights or
+ * usage to the software or any modified version or derivative work of the software
+ * created by or for you.
+ *
+ * Copyright (C) 2015-2025 EspoCRM, Inc.
+ *
+ * License ID: 19bc86a68a7bb01f458cb391d43a9212
+ ************************************************************************************/
+
+namespace Espo\Modules\Advanced\Classes\ServiceActions\Meeting;
+
+use Espo\Core\InjectableFactory;
+use Espo\Core\ORM\Entity as CoreEntity;
+use Espo\Entities\User;
+use Espo\Modules\Advanced\Tools\Workflow\Action\RunAction\ServiceAction;
+use Espo\Modules\Crm\Business\Event\Invitations;
+use Espo\Modules\Crm\Entities\Call;
+use Espo\Modules\Crm\Entities\Meeting;
+use Espo\ORM\Entity;
+use Espo\ORM\EntityManager;
+use RuntimeException;
+
+/**
+ * @implements ServiceAction<Meeting|Call>
+ */
+class SendInvitations implements ServiceAction
+{
+    private InjectableFactory $injectableFactory;
+    private EntityManager $entityManager;
+    private User $user;
+
+    public function __construct(
+        InjectableFactory $injectableFactory,
+        EntityManager $entityManager,
+        User $user
+    ) {
+        $this->injectableFactory = $injectableFactory;
+        $this->entityManager = $entityManager;
+        $this->user = $user;
+    }
+
+    private function getInvitationManager(): Invitations
+    {
+        return $this->injectableFactory->create(Invitations::class);
+    }
+
+    /**
+     * @inheritDoc
+     */
+    public function run(Entity $entity, mixed $data): mixed
+    {
+        if (!$entity instanceof CoreEntity) {
+            throw new RuntimeException();
+        }
+
+        $invitationManager = $this->getInvitationManager();
+        $emailHash = [];
+
+        $users = $this->entityManager
+            ->getRDBRepository($entity->getEntityType())
+            ->getRelation($entity, 'users')
+            ->find();
+
+        foreach ($users as $user) {
+            if ($user->getId() === $this->user->getId()) {
+                if (
+                    $entity->getLinkMultipleColumn('users', 'status', $user->getId()) ===
+                    Meeting::ATTENDEE_STATUS_ACCEPTED
+                ) {
+                    continue;
+                }
+            }
+
+            if ($user->get('emailAddress') && !array_key_exists($user->get('emailAddress'), $emailHash)) {
+                $invitationManager->sendInvitation($entity, $user, 'users');
+                $emailHash[$user->get('emailAddress')] = true;
+            }
+        }
+
+        $contacts = $this->entityManager
+            ->getRDBRepository($entity->getEntityType())
+            ->getRelation($entity, 'contacts')
+            ->find();
+
+        foreach ($contacts as $contact) {
+            if ($contact->get('emailAddress') && !array_key_exists($contact->get('emailAddress'), $emailHash)) {
+                $invitationManager->sendInvitation($entity, $contact, 'contacts');
+                $emailHash[$contact->get('emailAddress')] = true;
+            }
+        }
+
+        $leads = $this->entityManager
+            ->getRDBRepository($entity->getEntityType())
+            ->getRelation($entity, 'leads')
+            ->find();
+
+        foreach ($leads as $lead) {
+            if ($lead->get('emailAddress') && !array_key_exists($lead->get('emailAddress'), $emailHash)) {
+                $invitationManager->sendInvitation($entity, $lead, 'leads');
+                $emailHash[$lead->get('emailAddress')] = true;
+            }
+        }
+
+        return null;
+    }
+}

custom/Espo/Modules/Advanced/Classes/ServiceActions/Person/OptOut.php

@@ -0,0 +1,77 @@
+<?php
+/***********************************************************************************
+ * The contents of this file are subject to the Extension License Agreement
+ * ("Agreement") which can be viewed at
+ * https://www.espocrm.com/extension-license-agreement/.
+ * By copying, installing downloading, or using this file, You have unconditionally
+ * agreed to the terms and conditions of the Agreement, and You may not use this
+ * file except in compliance with the Agreement. Under the terms of the Agreement,
+ * You shall not license, sublicense, sell, resell, rent, lease, lend, distribute,
+ * redistribute, market, publish, commercialize, or otherwise transfer rights or
+ * usage to the software or any modified version or derivative work of the software
+ * created by or for you.
+ *
+ * Copyright (C) 2015-2025 EspoCRM, Inc.
+ *
+ * License ID: 19bc86a68a7bb01f458cb391d43a9212
+ ************************************************************************************/
+
+namespace Espo\Modules\Advanced\Classes\ServiceActions\Person;
+
+use Espo\Core\ORM\Entity as CoreEntity;
+use Espo\Entities\EmailAddress;
+use Espo\Modules\Advanced\Tools\Workflow\Action\RunAction\ServiceAction;
+use Espo\ORM\Entity;
+use Espo\ORM\EntityManager;
+use Espo\Repositories\EmailAddress as EmailAddressRepository;
+
+/**
+ * @implements ServiceAction<CoreEntity>
+ */
+class OptOut implements ServiceAction
+{
+    private EntityManager $entityManager;
+
+    public function __construct(EntityManager $entityManager)
+    {
+        $this->entityManager = $entityManager;
+    }
+
+    /**
+     * @inheritDoc
+     * @noinspection PhpHierarchyChecksInspection
+     * @noinspection PhpUndefinedClassInspection
+     * @noinspection PhpSignatureMismatchDuringInheritanceInspection
+     */
+    public function run(Entity $entity, mixed $data): mixed
+    {
+        $targetListId = $data->targetListId ?? null;
+
+        if ($targetListId) {
+            $this->entityManager
+                ->getRDBRepository($entity->getEntityType())
+                ->getRelation($entity, 'targetLists')
+                ->updateColumnsById($targetListId, ['optedOut' => true]);
+
+            return null;
+        }
+
+        $emailAddress = $entity->get('emailAddress');
+
+        if (!$emailAddress) {
+            return null;
+        }
+
+        /** @var EmailAddressRepository $emailAddressRepository */
+        $emailAddressRepository = $this->entityManager->getRepository(EmailAddress::ENTITY_TYPE);
+
+        $addressEntity = $emailAddressRepository->getByAddress($emailAddress);
+
+        if ($addressEntity) {
+            $addressEntity->set('optOut', true);
+            $this->entityManager->saveEntity($addressEntity);
+        }
+
+        return null;
+    }
+}

custom/Espo/Modules/Advanced/Classes/ServiceActions/User/GenerateAndSendPassword.php

@@ -0,0 +1,71 @@
+<?php
+/***********************************************************************************
+ * The contents of this file are subject to the Extension License Agreement
+ * ("Agreement") which can be viewed at
+ * https://www.espocrm.com/extension-license-agreement/.
+ * By copying, installing downloading, or using this file, You have unconditionally
+ * agreed to the terms and conditions of the Agreement, and You may not use this
+ * file except in compliance with the Agreement. Under the terms of the Agreement,
+ * You shall not license, sublicense, sell, resell, rent, lease, lend, distribute,
+ * redistribute, market, publish, commercialize, or otherwise transfer rights or
+ * usage to the software or any modified version or derivative work of the software
+ * created by or for you.
+ *
+ * Copyright (C) 2015-2025 EspoCRM, Inc.
+ *
+ * License ID: 19bc86a68a7bb01f458cb391d43a9212
+ ************************************************************************************/
+
+namespace Espo\Modules\Advanced\Classes\ServiceActions\User;
+
+use Espo\Core\InjectableFactory;
+use Espo\Core\Record\ServiceContainer;
+use Espo\Entities\User;
+use Espo\Modules\Advanced\Tools\Workflow\Action\RunAction\ServiceAction;
+use Espo\ORM\Entity;
+use Espo\Tools\UserSecurity\Password\Service;
+
+/**
+ * @implements ServiceAction<User>
+ */
+class GenerateAndSendPassword implements ServiceAction
+{
+    private InjectableFactory $injectableFactory;
+    private ServiceContainer $serviceContainer;
+
+    public function __construct(
+        InjectableFactory $injectableFactory,
+        ServiceContainer $serviceContainer
+    ) {
+        $this->injectableFactory = $injectableFactory;
+        $this->serviceContainer = $serviceContainer;
+    }
+
+    /**
+     * @inheritDoc
+     * @noinspection PhpHierarchyChecksInspection
+     * @noinspection PhpUndefinedClassInspection
+     * @noinspection PhpSignatureMismatchDuringInheritanceInspection
+     */
+    public function run(Entity $entity, mixed $data): mixed
+    {
+        if (class_exists("Espo\\Tools\\UserSecurity\\Password\\Service")) {
+            /** @var Service $service */
+            $service = $this->injectableFactory->create("Espo\\Tools\\UserSecurity\\Password\\Service");
+
+            // @todo Support non-admin users.
+
+            $service->generateAndSendNewPasswordForUser($entity->getId());
+
+            return null;
+        }
+
+        $service = $this->serviceContainer->get(User::ENTITY_TYPE);
+
+        if (method_exists($service, 'generateNewPasswordForUser')) {
+            $service->generateNewPasswordForUser($entity->getId(), true);
+        }
+
+        return null;
+    }
+}