'application/Espo/Resources/metadata', 'modulePath' => 'application/Espo/Modules/{*}/Resources/metadata', 'customPath' => 'custom/Espo/Custom/Resources/metadata', ]; private $moduleList = null; protected $defaultModuleOrder = 10; private $deletedData = []; private $changedData = []; private $fileManager; private $dataCache; public function __construct(FileManager $fileManager, DataCache $dataCache, bool $useCache = false) { $this->fileManager = $fileManager; $this->dataCache = $dataCache; $this->useCache = $useCache; } protected function getObjUnifier() { if (!isset($this->objUnifier)) { $this->objUnifier = new Unifier($this->fileManager, $this, true); } return $this->objUnifier; } protected function getModule() { if (!isset($this->module)) { $this->module = new Module($this->fileManager, $this->dataCache, $this->useCache); } return $this->module; } protected function getMetadataHelper() { if (!isset($this->metadataHelper)) { $this->metadataHelper = new Helper($this); } return $this->metadataHelper; } /** * Init metadata. */ public function init(bool $reload = false) { if (!$this->useCache) { $reload = true; } if ($this->dataCache->has($this->cacheKey) && !$reload) { $this->data = $this->dataCache->get($this->cacheKey); return; } $this->clearVars(); $objData = $this->getAllObjects(false, $reload); $this->data = Util::objectToArray($objData); if ($this->useCache) { $this->dataCache->store($this->cacheKey, $this->data); } } /** * Get metadata array. * * @return array */ protected function getData() { if (empty($this->data) || !is_array($this->data)) { $this->init(); } return $this->data; } /** * Get Metadata. * * @param mixed string|array $key * @param mixed $default * * @return array */ public function get($key = null, $default = null) { $result = Util::getValueByKey($this->getData(), $key, $default); return $result; } /** * Get All Metadata context. * * @param $isJSON * @param bool $reload * * @return json | array */ public function getAll($isJSON = false, $reload = false) { if ($reload) { $this->init($reload); } if ($isJSON) { return Json::encode($this->data); } return $this->data; } protected function objInit($reload = false) { if (!$this->useCache) { $reload = true; } if ($this->dataCache->has($this->objCacheKey) && !$reload) { $this->objData = $this->dataCache->get($this->objCacheKey); return; } $this->objData = $this->getObjUnifier()->unify('metadata', $this->paths, true); $this->objData = $this->addAdditionalFieldsObj($this->objData); if ($this->useCache) { $this->dataCache->store($this->objCacheKey, $this->objData); } } protected function getObjData($reload = false) { if (!isset($this->objData) || $reload) { $this->objInit($reload); } return $this->objData; } /** * Get Metadata with StdClass items. * * @param mixed string|array $key * @param mixed $default * * @return object */ public function getObjects($key = null, $default = null) { $objData = $this->getObjData(); return Util::getValueByKey($objData, $key, $default); } public function getAllObjects($isJSON = false, $reload = false) { $objData = $this->getObjData($reload); if ($isJSON) { return Json::encode($objData); } return $objData; } public function getAllForFrontend() { $data = $this->getAllObjects(); $frontendHiddenPathList = $this->get(['app', 'metadata', 'frontendHiddenPathList'], []); foreach ($frontendHiddenPathList as $row) { $this->removeDataByPath($row, $data); } return $data; } private function removeDataByPath($row, &$data) { $p = &$data; $path = [&$p]; foreach ($row as $i => $item) { if (is_array($item)) { break; } if ($item === '__ANY__') { foreach (get_object_vars($p) as &$v) { $this->removeDataByPath( array_slice($row, $i + 1), $v ); } return; } if (!property_exists($p, $item)) { break; } if ($i == count($row) - 1) { unset($p->$item); $o = &$p; for ($j = $i - 1; $j > 0; $j--) { if (is_object($o) && !count(get_object_vars($o))) { $o = &$path[$j]; $k = $row[$j]; unset($o->$k); } else { break; } } } else { $p = &$p->$item; $path[] = &$p; } } } protected function addAdditionalFieldsObj($data) { if (!isset($data->entityDefs)) { return $data; } $fieldDefinitionList = Util::objectToArray($data->fields); foreach (get_object_vars($data->entityDefs) as $entityType => $entityDefsItem) { if (isset($data->entityDefs->$entityType->collection)) { $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' ? true : false; } 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) { $additionalFields = $this->getMetadataHelper()->getAdditionalFieldList( $field, Util::objectToArray($fieldDefsItem), $fieldDefinitionList ); if (!$additionalFields) { continue; } foreach ($additionalFields as $subFieldName => $subFieldParams) { if (isset($entityDefsItem->fields->$subFieldName)) { $data->entityDefs->$entityType->fields->$subFieldName = DataUtil::merge( Util::arrayToObject($subFieldParams), $entityDefsItem->fields->$subFieldName ); } else { $data->entityDefs->$entityType->fields->$subFieldName = Util::arrayToObject($subFieldParams); } } } } return $data; } /** * Get metadata definition in custom directory. * * @param string|array $key * @param mixed $default * * @return object|mixed */ public function getCustom($key1, $key2, $default = null) { $filePath = array($this->paths['customPath'], $key1, $key2.'.json'); $fileContent = $this->fileManager->getContents($filePath); if ($fileContent) { return Json::decode($fileContent); } return $default; } /** * Set and save metadata in custom directory. * The data is not merging with existing data. Use getCustom() to get existing data. * * @param string $key1 * @param string $key2 * @param array $data * * @return boolean */ public function saveCustom($key1, $key2, $data) { if (is_object($data)) { foreach ($data as $key => $item) { if ($item == new \stdClass()) { unset($data->$key); } } } $filePath = array($this->paths['customPath'], $key1, $key2.'.json'); $changedData = Json::encode($data, JSON_PRETTY_PRINT | JSON_UNESCAPED_UNICODE | JSON_UNESCAPED_SLASHES); $result = $this->fileManager->putContents($filePath, $changedData); $this->init(true); return true; } /** * Set Metadata data. * Ex. $key1 = menu, $key2 = Account then will be created a file metadataFolder/menu/Account.json * * @param string $key1 * @param string $key2 * @param JSON string $data * * @return bool */ public function set($key1, $key2, $data) { if (is_array($data)) { foreach ($data as $key => $item) { if (is_array($item) && empty($item)) { unset($data[$key]); } } } $newData = array( $key1 => array( $key2 => $data, ), ); $this->changedData = Util::merge($this->changedData, $newData); $this->data = Util::merge($this->getData(), $newData); $this->undelete($key1, $key2, $data); } /** * Unset some fields and other stuff in metadata. * * @param string $key1 * @param string $key2 * @param array | string $unsets Ex. 'fields.name' * * @return bool */ public function delete($key1, $key2, $unsets = null) { if (!is_array($unsets)) { $unsets = (array) $unsets; } switch ($key1) { case 'entityDefs': //unset related additional fields, e.g. a field with "address" type $fieldDefinitionList = $this->get('fields'); $unsetList = $unsets; foreach ($unsetList as $unsetItem) { if (preg_match('/fields\.([^\.]+)/', $unsetItem, $matches) && isset($matches[1])) { $fieldName = $matches[1]; $fieldPath = [$key1, $key2, 'fields', $fieldName]; $additionalFields = $this->getMetadataHelper()->getAdditionalFieldList( $fieldName, $this->get($fieldPath, []), $fieldDefinitionList ); if (is_array($additionalFields)) { foreach ($additionalFields as $additionalFieldName => $additionalFieldParams) { $unsets[] = 'fields.' . $additionalFieldName; } } } } break; } $normalizedData = [ '__APPEND__', ]; $metadataUnsetData = []; foreach ($unsets as $unsetItem) { $normalizedData[] = $unsetItem; $metadataUnsetData[] = implode('.', [$key1, $key2, $unsetItem]); } $unsetData = [ $key1 => [ $key2 => $normalizedData ] ]; $this->deletedData = Util::merge($this->deletedData, $unsetData); $this->deletedData = Util::unsetInArrayByValue('__APPEND__', $this->deletedData, true); $this->data = Util::unsetInArray($this->getData(), $metadataUnsetData, true); } protected function undelete($key1, $key2, $data) { if (isset($this->deletedData[$key1][$key2])) { foreach ($this->deletedData[$key1][$key2] as $unsetIndex => $unsetItem) { $value = Util::getValueByKey($data, $unsetItem); if (isset($value)) { unset($this->deletedData[$key1][$key2][$unsetIndex]); } } } } /** * Clear unsaved changes. */ public function clearChanges() { $this->changedData = []; $this->deletedData = []; $this->init(true); } /** * Save changes. * * @return bool */ public function save() { $path = $this->paths['customPath']; $result = true; if (!empty($this->changedData)) { foreach ($this->changedData as $key1 => $keyData) { foreach ($keyData as $key2 => $data) { if (!empty($data)) { $result &= $this->fileManager->mergeContents([$path, $key1, $key2.'.json'], $data, true); } } } } if (!empty($this->deletedData)) { foreach ($this->deletedData as $key1 => $keyData) { foreach ($keyData as $key2 => $unsetData) { if (!empty($unsetData)) { $rowResult = $this->fileManager->unsetContents( [$path, $key1, $key2.'.json'], $unsetData, true ); if ($rowResult == false) { $GLOBALS['log']->warning( 'Metadata items ['.$key1.'.'.$key2.'] can be deleted for custom code only.' ); } $result &= $rowResult; } } } } if ($result == false) { throw new Error("Error saving metadata. See log file for details."); } $this->clearChanges(); return (bool) $result; } /** * Load modules. */ protected function loadModuleList() { $modules = $this->fileManager->getFileList($this->pathToModules, false, '', false); $modulesToSort = []; if (is_array($modules)) { foreach ($modules as $moduleName) { if (!empty($moduleName) && !isset($modulesToSort[$moduleName])) { $modulesToSort[$moduleName] = $this->getModule()->get( $moduleName . '.order', $this->defaultModuleOrder ); } } } array_multisort( array_values($modulesToSort), SORT_ASC, array_keys($modulesToSort), SORT_ASC, $modulesToSort ); $this->moduleList = array_keys($modulesToSort); } /** * Get Module List. * * @return array */ public function getModuleList() { if (!isset($this->moduleList)) { $this->loadModuleList(); } return $this->moduleList; } /** * Get module name if it's a custom module or empty string for core entity. * * @param string $scopeName * * @return string */ public function getScopeModuleName(string $scopeName) { return $this->get('scopes.' . $scopeName . '.module', false); } /** * Clear metadata variables when reload metadata. * * @return void */ protected function clearVars() { $this->data = null; $this->moduleList = null; } }