EspoCRM – Open Source CRM Application
PHP calendarcontactscrmcrm-platformcrm-systemcustomer-portalcustomer-supportcustomizabledocumentsemail-marketingkanbanleadsopen-sourcephpplatformsales-automationsingle-page-applicationsupport
<?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\Core\Utils\Metadata\AdditionalBuilder;
use Espo\Core\Utils\DataUtil;
use Espo\Core\Utils\Metadata\AdditionalBuilder;
use Espo\Core\Utils\Metadata\BuilderHelper;
use Espo\Core\Utils\Util;
use RuntimeException;
use stdClass;
class Fields implements AdditionalBuilder
{
private BuilderHelper $builderHelper;
public function __construct()
{
$this->builderHelper = new BuilderHelper();
}
public function build(stdClass $data): void
{
if (!isset($data->entityDefs)) {
return;
}
$defs = Util::objectToArray($data->fields);
foreach (get_object_vars($data->entityDefs) as $entityType => $entityDefsItem) {
if (isset($data->entityDefs->$entityType->collection)) {
/** @var stdClass $collectionItem */
$collectionItem = $data->entityDefs->$entityType->collection;
if (isset($collectionItem->orderBy)) {
$collectionItem->sortBy = $collectionItem->orderBy;
} else if (isset($collectionItem->sortBy)) {
$collectionItem->orderBy = $collectionItem->sortBy;
}
if (isset($collectionItem->order)) {
$collectionItem->asc = $collectionItem->order === 'asc';
} else if (isset($collectionItem->asc)) {
$collectionItem->order = $collectionItem->asc === true ? 'asc' : 'desc';
}
}
if (!isset($entityDefsItem->fields)) {
continue;
}
foreach (get_object_vars($entityDefsItem->fields) as $field => $fieldDefsItem) {
if (!is_object($fieldDefsItem)) {
throw new RuntimeException("Bad definition for $entityType.$field field.");
}
$additionalFields = $this->builderHelper->getAdditionalFields(
field: $field,
params: Util::objectToArray($fieldDefsItem),
defs: $defs,
);
if (!$additionalFields) {
continue;
}
foreach ($additionalFields as $subFieldName => $subFieldParams) {
$item = Util::arrayToObject($subFieldParams);
if (isset($entityDefsItem->fields->$subFieldName)) {
$data->entityDefs->$entityType->fields->$subFieldName =
DataUtil::merge(
$item,
$entityDefsItem->fields->$subFieldName
);
continue;
}
$data->entityDefs->$entityType->fields->$subFieldName = $item;
}
}
}
}
}