/************************************************************************ * This file is part of EspoCRM. * * EspoCRM – Open Source CRM application. * Copyright (C) 2014-2024 Yurii Kuznietsov, Taras Machyshyn, Oleksii Avramenko * 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 . * * 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. ************************************************************************/ /** @module layout-manager */ import {Events} from 'bullbone'; /** * A layout manager. * * @mixes Bull.Events */ class LayoutManager { /** * @param {module:cache|null} [cache] A cache. * @param {string} [applicationId] An application ID. * @param {string} [userId] A user ID. */ constructor(cache, applicationId, userId) { /** * @private * @type {module:cache|null} */ this.cache = cache || null; /** * @private * @type {string} */ this.applicationId = applicationId || 'espocrm'; /** * @private * @type {string|null} */ this.userId = userId || null; /** * @private * @type {Object} */ this.data = {}; /** @private */ this.ajax = Espo.Ajax; } /** * Set a user ID. To be used for the cache purpose. * * @param {string} userId A user ID. * * @todo Throw an exception if already set. */ setUserId(userId) { this.userId = userId } /** * @private * @param {string} scope * @param {string} type * @returns {string} */ getKey(scope, type) { if (this.userId) { return this.applicationId + '-' + this.userId + '-' + scope + '-' + type; } return this.applicationId + '-' + scope + '-' + type; } /** * @private * @param {string} scope * @param {string} type * @param {string} [setId] * @returns {string} */ getUrl(scope, type, setId) { let url = scope + '/layout/' + type; if (setId) { url += '/' + setId; } return url; } /** * @callback module:layout-manager~getCallback * * @param {*} layout A layout. */ /** * Get a layout. * * @param {string} scope A scope (entity type). * @param {string} type A layout type (name). * @param {module:layout-manager~getCallback} callback * @param {boolean} [cache=true] Use cache. */ get(scope, type, callback, cache) { if (typeof cache === 'undefined') { cache = true; } const key = this.getKey(scope, type); if (cache) { if (key in this.data) { if (typeof callback === 'function') { callback(this.data[key]); } return; } } if (this.cache && cache) { const cached = this.cache.get('app-layout', key); if (cached) { if (typeof callback === 'function') { callback(cached); } this.data[key] = cached; return; } } this.ajax .getRequest(this.getUrl(scope, type)) .then( layout => { if (typeof callback === 'function') { callback(layout); } this.data[key] = layout; if (this.cache) { this.cache.set('app-layout', key, layout); } } ); } /** * Get an original layout. * * @param {string} scope A scope (entity type). * @param {string} type A layout type (name). * @param {string} [setId] * @param {module:layout-manager~getCallback} callback */ getOriginal(scope, type, setId, callback) { let url = 'Layout/action/getOriginal?scope='+scope+'&name='+type; if (setId) { url += '&setId=' + setId; } Espo.Ajax .getRequest(url) .then( layout => { if (typeof callback === 'function') { callback(layout); } } ); } /** * Store and set a layout. * * @param {string} scope A scope (entity type). * @param {string} type A type (name). * @param {*} layout A layout. * @param {Function} callback A callback. * @param {string} [setId] A set ID. * @returns {Promise} */ set(scope, type, layout, callback, setId) { return Espo.Ajax .putRequest(this.getUrl(scope, type, setId), layout) .then( () => { const key = this.getKey(scope, type); if (this.cache && key) { this.cache.clear('app-layout', key); } delete this.data[key]; this.trigger('sync'); if (typeof callback === 'function') { callback(); } } ); } /** * Reset a layout to default. * * @param {string} scope A scope (entity type). * @param {string} type A type (name). * @param {Function} callback A callback. * @param {string} [setId] A set ID. */ resetToDefault(scope, type, callback, setId) { Espo.Ajax .postRequest('Layout/action/resetToDefault', { scope: scope, name: type, setId: setId, }) .then( () => { const key = this.getKey(scope, type); if (this.cache) { this.cache.clear('app-layout', key); } delete this.data[key]; this.trigger('sync'); if (typeof callback === 'function') { callback(); } } ); } /** * Clear loaded data. */ clearLoadedData() { this.data = {}; } } Object.assign(LayoutManager.prototype, Events); export default LayoutManager;