snapshot of https://github.com/espocrm/espocrm.git (master, 2026-09-18; blobs > 131072B omitted)

application/Espo/Hooks/Note/Mentions.php

@@ -0,0 +1,61 @@
+<?php
+/************************************************************************
+ * This file is part of EspoCRM.
+ *
+ * EspoCRM – Open Source CRM application.
+ * Copyright (C) 2014-2026 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\Hooks\Note;
+
+use Espo\Core\ORM\Repository\Option\SaveOption;
+use Espo\Tools\Notification\NoteMentionHookProcessor;
+use Espo\ORM\Entity;
+use Espo\Entities\Note;
+
+class Mentions
+{
+    public static int $order = 9;
+
+    private NoteMentionHookProcessor $processor;
+
+    public function __construct(NoteMentionHookProcessor $processor)
+    {
+        $this->processor = $processor;
+    }
+
+    /**
+     * @param array<string, mixed> $options
+     */
+    public function beforeSave(Entity $entity, array $options): void
+    {
+        if (!empty($options[SaveOption::SILENT])) {
+            return;
+        }
+
+        assert($entity instanceof Note);
+
+        $this->processor->beforeSave($entity);
+    }
+}

application/Espo/Hooks/Note/Notifications.php

@@ -0,0 +1,62 @@
+<?php
+/************************************************************************
+ * This file is part of EspoCRM.
+ *
+ * EspoCRM – Open Source CRM application.
+ * Copyright (C) 2014-2026 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\Hooks\Note;
+
+use Espo\Core\Hook\Hook\AfterSave;
+use Espo\ORM\Repository\Option\SaveContext;
+use Espo\ORM\Entity;
+use Espo\ORM\Repository\Option\SaveOptions;
+use Espo\Tools\Notification\HookProcessor\Params;
+use Espo\Tools\Notification\NoteHookProcessor;
+use Espo\Entities\Note;
+
+/**
+ * @implements AfterSave<Note>
+ */
+class Notifications implements AfterSave
+{
+    public static int $order = 14;
+
+    public function __construct(private NoteHookProcessor $processor)
+    {}
+
+    public function afterSave(Entity $entity, SaveOptions $options): void
+    {
+        if (!$entity->isNew() && !$options->get('forceProcessNotifications')) {
+            return;
+        }
+
+        $saveContext = SaveContext::obtainFromOptions($options);
+
+        $params = new Params(actionId: $saveContext?->getActionId());
+
+        $this->processor->afterSave($entity, $params);
+    }
+}

application/Espo/Hooks/Note/SetFields.php

@@ -0,0 +1,60 @@
+<?php
+/************************************************************************
+ * This file is part of EspoCRM.
+ *
+ * EspoCRM – Open Source CRM application.
+ * Copyright (C) 2014-2026 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\Hooks\Note;
+
+use Espo\Core\Hook\Hook\BeforeSave;
+use Espo\Core\Utils\Metadata;
+use Espo\Entities\Note;
+use Espo\ORM\Entity;
+use Espo\ORM\Repository\Option\SaveOptions;
+
+/**
+ * @implements BeforeSave<Note>
+ */
+class SetFields implements BeforeSave
+{
+    public function __construct(
+        private Metadata $metadata,
+    ) {}
+
+    public function beforeSave(Entity $entity, SaveOptions $options): void
+    {
+        if (
+            $entity->isNew() &&
+            (
+                !$entity->isPost() ||
+                !$entity->getParentType() ||
+                !$this->metadata->get("streamDefs.{$entity->getParentType()}.allowInternalNotes")
+            )
+        ) {
+            $entity->setIsInternal(false);
+        }
+    }
+}

application/Espo/Hooks/Note/StreamUpdatedAt.php

@@ -0,0 +1,66 @@
+<?php
+/************************************************************************
+ * This file is part of EspoCRM.
+ *
+ * EspoCRM – Open Source CRM application.
+ * Copyright (C) 2014-2026 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\Hooks\Note;
+
+use Espo\Core\Hook\Hook\AfterSave;
+use Espo\ORM\Entity;
+use Espo\ORM\Repository\Option\SaveOptions;
+use Espo\Entities\Note;
+use Espo\Tools\Stream\Service;
+
+/**
+ * @implements AfterSave<Note>
+ */
+class StreamUpdatedAt implements AfterSave
+{
+    public function __construct(private Service $service)
+    {}
+
+    public function afterSave(Entity $entity, SaveOptions $options): void
+    {
+        if (!$entity->isNew()) {
+            return;
+        }
+
+        if (
+            $entity->getType() !== Note::TYPE_POST ||
+            !$entity->getParentType() ||
+            !$this->service->checkIsEnabled($entity->getParentType())
+        ) {
+            return;
+        }
+
+        if (!$entity->getParent()) {
+            return;
+        }
+
+        $this->service->updateStreamUpdatedAt($entity->getParent());
+    }
+}

application/Espo/Hooks/Note/WebSocketSubmit.php

@@ -0,0 +1,77 @@
+<?php
+/************************************************************************
+ * This file is part of EspoCRM.
+ *
+ * EspoCRM – Open Source CRM application.
+ * Copyright (C) 2014-2026 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\Hooks\Note;
+
+use Espo\Core\Hook\Hook\AfterSave;
+use Espo\Entities\Note;
+use Espo\ORM\Entity;
+use Espo\Core\WebSocket\Submission as WebSocketSubmission;
+use Espo\ORM\Repository\Option\SaveOptions;
+
+/**
+ * @implements AfterSave<Note>
+ */
+class WebSocketSubmit implements AfterSave
+{
+    public static int $order = 20;
+
+    public function __construct(
+        private WebSocketSubmission $webSocketSubmission,
+    ) {}
+
+    public function afterSave(Entity $entity, SaveOptions $options): void
+    {
+        if (!$entity->isNew()) {
+            $updateTopic = "recordUpdate.Note.{$entity->getId()}";
+
+            $this->webSocketSubmission->submit($updateTopic);
+        }
+
+        $parentId = $entity->getParentId();
+        $parentType = $entity->getParentType();
+
+        if (!$parentId || !$parentType) {
+            return;
+        }
+
+        $data = (object) [
+            'createdById' => $entity->getCreatedById(),
+        ];
+
+        if (!$entity->isNew()) {
+            $data->noteId = $entity->getId();
+            $data->pin = $entity->isAttributeChanged('isPinned');
+        }
+
+        $topic = "streamUpdate.$parentType.$parentId";
+
+        $this->webSocketSubmission->submit($topic, null, $data);
+    }
+}