/************************************************************************ * This file is part of EspoCRM. * * EspoCRM - Open Source CRM application. * Copyright (C) 2014-2021 Yurii Kuznietsov, Taras Machyshyn, Oleksii Avramenko * Website: https://www.espocrm.com * * EspoCRM is free software: you can redistribute it and/or modify * it under the terms of the GNU General Public License as published by * the Free Software Foundation, either version 3 of the License, or * (at your option) any later version. * * EspoCRM 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 General Public License for more details. * * You should have received a copy of the GNU General Public License * along with EspoCRM. If not, see http://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 General Public License version 3. * * In accordance with Section 7(b) of the GNU General Public License version 3, * these Appropriate Legal Notices must retain the display of the "EspoCRM" word. ************************************************************************/ /** * Controller. Views, Models and Collections are created here.*/ define('controller', [], function () { var Controller = function (params, injections) { this.params = params || {}; this.baseController = injections.baseController; this.viewFactory = injections.viewFactory; this.modelFactory = injections.modelFactory; this.collectionFactory = injections.collectionFactory; this.initialize(); this._settings = injections.settings || null; this._user = injections.user || null; this._preferences = injections.preferences || null; this._acl = injections.acl || null; this._cache = injections.cache || null; this._router = injections.router || null; this._storage = injections.storage || null; this._metadata = injections.metadata || null; this._dateTime = injections.dateTime || null; this.set('masterRendered', false); }; _.extend(Controller.prototype, { defaultAction: 'index', name: false, params: null, viewFactory: null, modelFactory: null, controllerFactory: null, initialize: function () {}, setRouter: function (router) { this._router = router; }, getConfig: function () { return this._settings; }, getUser: function () { return this._user; }, getPreferences: function () { return this._preferences; }, getAcl: function () { return this._acl; }, getCache: function () { return this._cache; }, getRouter: function () { return this._router; }, getStorage: function () { return this._storage; }, getMetadata: function () { return this._metadata; }, getDateTime: function () { return this._dateTime; }, /** * Get parameter of all controllers. * @param key * @return null if doesn't exist. */ get: function (key) { if (key in this.params) { return this.params[key]; } return null; }, /** * Set paramer for all controllers. * @param key Name of view. * @param value. */ set: function (key, value) { this.params[key] = value; }, unset: function (key) { delete this.params[key]; }, has: function (key) { return key in this.params; }, getStoredMainView: function (key) { return this.get('storedMainView-' + key); }, hasStoredMainView: function (key) { return this.has('storedMainView-' + key); }, clearStoredMainView: function (key) { var view = this.getStoredMainView(key); if (view) { view.remove(true); } this.unset('storedMainView-' + key); }, storeMainView: function (key, view) { this.set('storedMainView-' + key, view); this.listenTo(view, 'remove', function (o) { o = o || {}; if (o.ignoreCleaning) { return; } this.stopListening(view, 'remove'); this.clearStoredMainView(key); }, this); }, checkAccess: function (action) { return true; }, handleAccessGlobal: function () { if (!this.checkAccessGlobal()) { throw new Espo.Exceptions.AccessDenied("Denied access to '" + this.name + "'"); } }, checkAccessGlobal: function () { return true; }, handleCheckAccess: function (action) { if (!this.checkAccess(action)) { var msg; if (action) { msg = "Denied access to action '" + this.name + "#" + action + "'"; } else { msg = "Denied access to scope '" + this.name + "'"; } throw new Espo.Exceptions.AccessDenied(msg); } }, doAction: function (action, options) { this.handleAccessGlobal(); action = action || this.defaultAction; var method = 'action' + Espo.Utils.upperCaseFirst(action); if (!(method in this)) { throw new Espo.Exceptions.NotFound("Action '" + this.name + "#" + action + "' is not found"); } var preMethod = 'before' + Espo.Utils.upperCaseFirst(action); var postMethod = 'after' + Espo.Utils.upperCaseFirst(action); if (preMethod in this) { this[preMethod].call(this, options || {}); } this[method].call(this, options || {}); if (postMethod in this) { this[postMethod].call(this, options || {}); } }, /** * Create master view, render it if not rendered and return it. * @param {Function} callback Master view will be argument for this. */ master: function (callback) { var entire = this.get('entire'); if (entire) { entire.remove(); this.set('entire', null); } var master = this.get('master'); if (!master) { var masterView = this.masterView || 'views/site/master'; this.viewFactory.create(masterView, {el: 'body'}, function (master) { this.set('master', master); if (!this.get('masterRendered')) { master.render(function () { this.set('masterRendered', true); callback.call(this, master); }.bind(this)); return; } callback.call(this, master); }.bind(this)); } else { callback.call(this, master); } }, /** * Create main view in master and return it. * @param {String} view Name of view. * @param {Object} options Options for view. * @return {view} */ main: function (view, options, callback, useStored, storedKey) { var isCanceled = false; this.listenToOnce(this.baseController, 'action', function () { isCanceled = true; }, this); var view = view || 'views/base'; this.master(function (master) { if (isCanceled) { return; } options = options || {}; options.el = '#main'; var process = function (main) { if (isCanceled) { return; } if (storedKey) { this.storeMainView(storedKey, main); } main.once('render', function () { main.updatePageTitle(); }); main.listenToOnce(this.baseController, 'action', function () { main.cancelRender(); isCanceled = true; }, this); if (master.currentViewKey) { this.set('storedScrollTop-' + master.currentViewKey, $(window).scrollTop()); if (this.hasStoredMainView(master.currentViewKey)) { var mainView = master.getView('main'); if (mainView) { mainView.propagateEvent('remove', {ignoreCleaning: true}); } master.unchainView('main'); } } master.currentViewKey = storedKey; master.setView('main', main); main.once('after:render', function () { if (useStored && this.has('storedScrollTop-' + storedKey)) { $(window).scrollTop(this.get('storedScrollTop-' + storedKey)); } else { $(window).scrollTop(0); } }.bind(this)); if (isCanceled) { return; } if (callback) { callback.call(this, main); } else { main.render(); } }.bind(this); if (useStored) { if (this.hasStoredMainView(storedKey)) { var main = this.getStoredMainView(storedKey); var isActual = true; if (main && typeof main.isActualForReuse === 'function') { isActual = main.isActualForReuse(); } if ( (!main.lastUrl || main.lastUrl === this.getRouter().getCurrentUrl()) && isActual ) { process(main); if (main && typeof main.applyRoutingParams === 'function') { main.applyRoutingParams(options.params || {}); } return; } else { this.clearStoredMainView(storedKey); } } } this.viewFactory.create(view, options, process); }.bind(this)); }, showLoadingNotification: function () { var master = this.get('master'); if (master) { master.showLoadingNotification(); } }, hideLoadingNotification: function () { var master = this.get('master'); if (master) { master.hideLoadingNotification(); } }, /** * Create view in the body tag. * @param {String} view Name of view. * @param {Object} options Options for view. * @return {Espo.View} */ entire: function (view, options, callback) { var master = this.get('master'); if (master) { master.remove(); } this.set('master', null); this.set('masterRendered', false); options = options || {}; options.el = 'body'; this.viewFactory.create(view, options, function (view) { this.set('entire', view); callback(view); }.bind(this)); } }, Backbone.Events); Controller.extend = Backbone.Router.extend; return Controller; });