Initial commit

This commit is contained in:
root
2026-01-19 17:44:46 +01:00
commit 823af8b11d
8721 changed files with 1130846 additions and 0 deletions

View File

@@ -0,0 +1,37 @@
<?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\Tools\LinkManager\Hook;
use Espo\Tools\LinkManager\Params;
interface CreateHook
{
public function process(Params $params): void;
}

View File

@@ -0,0 +1,37 @@
<?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\Tools\LinkManager\Hook;
use Espo\Tools\LinkManager\Params;
interface DeleteHook
{
public function process(Params $params): void;
}

View File

@@ -0,0 +1,90 @@
<?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\Tools\LinkManager\Hook;
use Espo\Core\Utils\Metadata;
use Espo\Core\InjectableFactory;
use Espo\Tools\LinkManager\Params;
class HookProcessor
{
public function __construct(
private Metadata $metadata,
private InjectableFactory $injectableFactory
) {}
public function processCreate(Params $params): void
{
foreach ($this->getCreateHookList() as $hook) {
$hook->process($params);
}
}
public function processDelete(Params $params): void
{
foreach ($this->getDeleteHookList() as $hook) {
$hook->process($params);
}
}
/**
* @return CreateHook[]
*/
private function getCreateHookList(): array
{
/** @var class-string<CreateHook>[] $classNameList */
$classNameList = $this->metadata->get(['app', 'linkManager', 'createHookClassNameList']) ?? [];
$list = [];
foreach ($classNameList as $className) {
$list[] = $this->injectableFactory->create($className);
}
return $list;
}
/**
* @return DeleteHook[]
*/
private function getDeleteHookList(): array
{
/** @var class-string<DeleteHook>[] $classNameList */
$classNameList = $this->metadata->get(['app', 'linkManager', 'deleteHookClassNameList']) ?? [];
$list = [];
foreach ($classNameList as $className) {
$list[] = $this->injectableFactory->create($className);
}
return $list;
}
}

View File

@@ -0,0 +1,78 @@
<?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\Tools\LinkManager\Hook\Hooks;
use Espo\Core\ORM\Type\FieldType;
use Espo\Tools\LinkManager\Hook\DeleteHook;
use Espo\Tools\LinkManager\Params;
use Espo\Core\Utils\Metadata;
use Espo\ORM\Defs;
class ForeignFieldDelete implements DeleteHook
{
public function __construct(
private Metadata $metadata,
private Defs $defs
) {}
public function process(Params $params): void
{
$this->processInternal($params->getEntityType(), $params->getLink());
if ($params->getForeignEntityType()) {
$this->processInternal($params->getForeignEntityType(), $params->getForeignLink());
}
}
private function processInternal(string $entityType, string $link): void
{
if (!$this->defs->hasEntity($entityType)) {
return;
}
foreach ($this->defs->getEntity($entityType)->getFieldList() as $fieldDefs) {
if ($fieldDefs->getType() !== FieldType::FOREIGN) {
continue;
}
if ($fieldDefs->getParam('link') === $link) {
$this->deleteForeignField($entityType, $fieldDefs->getName());
}
}
}
private function deleteForeignField(string $entityType, string $field): void
{
$this->metadata->delete('entityDefs', $entityType, ['fields.' . $field]);
$this->metadata->save();
}
}

View File

@@ -0,0 +1,169 @@
<?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\Tools\LinkManager\Hook\Hooks;
use Espo\Core\ORM\Type\FieldType;
use Espo\Core\Templates\Entities\Company;
use Espo\Core\Templates\Entities\Person;
use Espo\ORM\Defs\Params\FieldParam;
use Espo\ORM\Defs\Params\RelationParam;
use Espo\ORM\Type\AttributeType;
use Espo\Tools\LinkManager\Hook\CreateHook;
use Espo\Tools\LinkManager\Params;
use Espo\Tools\LinkManager\Type;
use Espo\Modules\Crm\Entities\TargetList;
use Espo\Core\Utils\Metadata;
class TargetListCreate implements CreateHook
{
public function __construct(private Metadata $metadata)
{}
public function process(Params $params): void
{
$toProcess =
(
$params->getEntityType() === TargetList::ENTITY_TYPE ||
$params->getForeignEntityType() === TargetList::ENTITY_TYPE
) &&
$params->getType() === Type::MANY_TO_MANY;
if (!$toProcess) {
return;
}
[$entityType, $link, $foreignLink] = $params->getEntityType() === TargetList::ENTITY_TYPE ?
[
$params->getForeignEntityType(),
$params->getForeignLink(),
$params->getLink(),
] :
[
$params->getEntityType(),
$params->getLink(),
$params->getForeignLink(),
];
if (!$entityType) {
return;
}
$type = $this->metadata->get(['scopes', $entityType, 'type']);
if (!in_array($type, [Person::TEMPLATE_TYPE, Company::TEMPLATE_TYPE])) {
return;
}
if ($link !== 'targetLists') {
return;
}
$this->processInternal($entityType, $link, $foreignLink);
}
private function processInternal(string $entityType, string $link, string $foreignLink): void
{
$this->metadata->set('entityDefs', TargetList::ENTITY_TYPE, [
'links' => [
$foreignLink => [
RelationParam::ADDITIONAL_COLUMNS => [
'optedOut' => [
'type' => AttributeType::BOOL,
]
],
'columnAttributeMap' => [
'optedOut' => 'isOptedOut',
],
],
],
]);
$this->metadata->set('entityDefs', $entityType, [
'links' => [
$link => [
'columnAttributeMap' => [
'optedOut' => 'targetListIsOptedOut',
],
],
],
'fields' => [
'targetListIsOptedOut' => [
'type' => FieldType::BOOL,
FieldParam::NOT_STORABLE => true,
'readOnly' => true,
'disabled' => true,
],
]
]);
$this->metadata->set('clientDefs', TargetList::ENTITY_TYPE, [
'relationshipPanels' => [
$foreignLink => [
'actionList' => [
[
'label' => 'Unlink All',
'action' => 'unlinkAllRelated',
'acl' => 'edit',
'data' => [
'link' => $foreignLink,
],
],
],
'rowActionsView' => 'crm:views/target-list/record/row-actions/default',
'view' => 'crm:views/target-list/record/panels/relationship',
'massSelect' => true,
'removeDisabled' => true,
],
],
]);
$this->metadata->set('recordDefs', TargetList::ENTITY_TYPE, [
'relationships' => [
$foreignLink => [
'massLink' => true,
'linkRequiredForeignAccess' => 'read',
'mandatoryAttributeList' => ['targetListIsOptedOut'],
],
],
]);
$targetLinkList = $this->metadata->get(['scopes', TargetList::ENTITY_TYPE, 'targetLinkList']) ?? [];
if (!in_array($foreignLink, $targetLinkList)) {
$targetLinkList[] = $foreignLink;
$this->metadata->set('scopes', TargetList::ENTITY_TYPE, [
'targetLinkList' => $targetLinkList,
]);
}
$this->metadata->save();
}
}

View File

@@ -0,0 +1,107 @@
<?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\Tools\LinkManager\Hook\Hooks;
use Espo\Core\Templates\Entities\Company;
use Espo\Core\Templates\Entities\Person;
use Espo\Tools\LinkManager\Hook\DeleteHook;
use Espo\Tools\LinkManager\Params;
use Espo\Tools\LinkManager\Type;
use Espo\Modules\Crm\Entities\TargetList;
use Espo\Core\Utils\Metadata;
class TargetListDelete implements DeleteHook
{
public function __construct(private Metadata $metadata)
{}
public function process(Params $params): void
{
$toProcess =
(
$params->getEntityType() === TargetList::ENTITY_TYPE ||
$params->getForeignEntityType() === TargetList::ENTITY_TYPE
) &&
$params->getType() === Type::MANY_TO_MANY;
if (!$toProcess) {
return;
}
[$entityType, $link, $foreignLink] = $params->getEntityType() === TargetList::ENTITY_TYPE ?
[
$params->getForeignEntityType(),
$params->getForeignLink(),
$params->getLink(),
] :
[
$params->getEntityType(),
$params->getLink(),
$params->getForeignLink(),
];
if (!$entityType) {
return;
}
$type = $this->metadata->get(['scopes', $entityType, 'type']);
if (!in_array($type, [Person::TEMPLATE_TYPE, Company::TEMPLATE_TYPE])) {
return;
}
if ($link !== 'targetLists') {
return;
}
$this->processInternal($entityType, $link, $foreignLink);
}
private function processInternal(string $entityType, string $link, string $foreignLink): void
{
$this->metadata->delete('entityDefs', $entityType, ['fields.targetListIsOptedOut']);
$targetLinkList = $this->metadata->get(['scopes', TargetList::ENTITY_TYPE, 'targetLinkList']) ?? [];
if (in_array($foreignLink, $targetLinkList)) {
$targetLinkList = array_diff($targetLinkList, [$foreignLink]);
$this->metadata->set('scopes', TargetList::ENTITY_TYPE, [
'targetLinkList' => $targetLinkList,
]);
}
$this->metadata->delete('clientDefs', TargetList::ENTITY_TYPE, ["relationshipPanels.$foreignLink"]);
$this->metadata->delete('recordDefs', TargetList::ENTITY_TYPE, ["relationships.$foreignLink"]);
$this->metadata->save();
}
}

File diff suppressed because it is too large Load Diff

View File

@@ -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\Tools\LinkManager;
use Espo\Tools\LinkManager\ParamsBuilder;
/**
* Immutable.
*/
class Params
{
private string $type;
private string $entityType;
private string $link;
private string $foreignLink;
private ?string $foreignEntityType;
private ?string $name;
public function __construct(
string $type,
string $entityType,
string $link,
?string $foreignEntityType,
string $foreignLink,
?string $name
) {
$this->type = $type;
$this->entityType = $entityType;
$this->link = $link;
$this->foreignEntityType = $foreignEntityType;
$this->foreignLink = $foreignLink;
$this->name = $name;
}
public static function createBuilder(): ParamsBuilder
{
return new ParamsBuilder();
}
public function getType(): string
{
return $this->type;
}
public function getEntityType(): string
{
return $this->entityType;
}
public function getLink(): string
{
return $this->link;
}
public function getForeignLink(): string
{
return $this->foreignLink;
}
public function getForeignEntityType(): ?string
{
return $this->foreignEntityType;
}
public function getName(): ?string
{
return $this->name;
}
}

View File

@@ -0,0 +1,94 @@
<?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\Tools\LinkManager;
class ParamsBuilder
{
private string $type;
private string $entityType;
private string $link;
private string $foreignLink;
private ?string $foreignEntityType = null;
private ?string $name = null;
public function setType(string $type): self
{
$this->type = $type;
return $this;
}
public function setEntityType(string $entityType): self
{
$this->entityType = $entityType;
return $this;
}
public function setLink(string $link): self
{
$this->link = $link;
return $this;
}
public function setForeignLink(string $foreignLink): self
{
$this->foreignLink = $foreignLink;
return $this;
}
public function setForeignEntityType(?string $foreignEntityType): self
{
$this->foreignEntityType = $foreignEntityType;
return $this;
}
public function setName(?string $name): self
{
$this->name = $name;
return $this;
}
public function build(): Params
{
return new Params(
$this->type,
$this->entityType,
$this->link,
$this->foreignEntityType,
$this->foreignLink,
$this->name
);
}
}

View File

@@ -0,0 +1,40 @@
<?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\Tools\LinkManager;
class Type
{
public const MANY_TO_MANY = 'manyToMany';
public const MANY_TO_ONE = 'manyToOne';
public const ONE_TO_MANY = 'oneToMany';
public const ONE_TO_ONE_LEFT = 'oneToOneLeft';
public const ONE_TO_ONE_RIGHT = 'oneToOneRight';
public const CHILDREN_TO_PARENT = 'childrenToParent';
}