Current File : //home2/vacivi36/intranet.vacivitta.com.br/static/js/humhub/humhub.core.js
/**
* Sets up the humhub namespace and module management.
* This namespace provides the following functions:
*
* module - for adding modules to this namespace and initializing them
*
* @namespace
*/
var humhub = humhub || (function ($) {
/** @module humhub **/
/**
* Contains the modules namespace e.g. modules.ui.modal
* @type object
* @namespace humhub.modules
*/
var modules = {};
/**
* Flat array with all registered modules.
* @type Array
*/
var moduleArr = [];
/**
* Used to collect modules added while initial page load.
* These modules will be intitialized after the document is ready.
* @type Array
*/
var initialModules = [];
/**
* Contains all modules which needs to be reinitialized after a pjax reload
* @type Array
*/
var pjaxInitModules = [];
/**
* Adds a module to the humhub.modules namespace.
*
* The module id can be provided either as
*
* - full namespace humhub.modules.ui.modal
* - or modules.ui.modal
* - or short ui.modal
*
* Usage:
*
* ```
* humhub.module('ui.modal', function(module, require, $) {...});
* ```
*
* This would create an empty ui namespace (if not already created before) register the given module `ui.modal`.
*
* The module can export functions and properties by using:
*
* ```
* module.myFunction = function() {...}
*
* or
*
* module.export({
* myFunction: function() {...}
* });
* ```
*
* The export function can be called as often as needed (but should be called once at the end of the module).
* Its also possible to export single classes e.g.:
*
* ```
* humhub.module('my.LoaderWidget', function(module, require, $) {
* var LoaderWidget = function() {...}
*
* module.export = LoaderWidget;
* });
* ```
*
* A module can provide an `init` function, which by default is only called after the first initialization
* e.g. after a full page load when the document is ready or when loaded by means of ajax ajax.
* In case a modules `init` function need to be called also after each `pjax` request, the modules `initOnPjaxLoad` has to be
* set to `true`:
*
* ```
* module.initOnPjaxLoad = true;
* ```
*
* Dependencies:
*
* The core modules are initialized in a specific order to provide the required dependencies for each module.
* The order is given by the order of module calls and in case of core modules configured in the API's AssetBundle.
*
* A module can be received by using the required function within a module function.
* You can either depend on a module at initialisation time or within your functions or
* use the lazy flag of the require function.
*
* Usage:
*
* ```
* var modal = require('ui.modal');
*
* or lazy require
*
* var modal = require('ui.modal', true);
* ````
* @function module:humhub.module
* @access public
* @param {string} id the namespaced id
* @param {function} moduleFunction
* @returns {undefined}
*/
var module = function (id, moduleFunction) {
//Create module in the namespace and add helper functions
var instance = resolveNameSpace(id, true);
// Do not register modules twice!
if (instance.id) {
return;
}
createModule(id, instance);
var exportFunc = instance.export;
// Setup the module by calling the moduleFunction
try {
moduleFunction(instance, require, $);
// Allows module.export = MyClass for exporting single classes/objects
if (exportFunc !== instance.export) {
_setNameSpace(instance.id, instance.export);
}
} catch (err) {
console.error('Error while creating module: ' + id, err);
}
moduleArr.push(instance);
if (instance.init && instance.initOnPjaxLoad) {
pjaxInitModules.push(instance);
}
//Initialize the modules when document is ready
if (!humhub.initialized) {
initialModules.push(instance);
} else { // Init modules added asynchronously (ajax/pjax)
addModuleLogger(instance);
initModule(instance);
}
};
var createModule = function(id, instance) {
instance.require = require;
instance.initOnPjaxLoad = false;
instance.isModule = true;
instance.id = 'humhub.modules.' + _cutModulePrefix(id);
instance.config = require('config').module(instance);
instance.text = function(key) {
var textCfg = instance.config['text'];
return (textCfg) ? textCfg[key] : undefined;
};
instance.export = function (exports) {
$.extend(instance, exports);
};
};
/**
* This function is used to resolve namespaces and receive module instances or single classes.
*
* For the module humhub.modules.ui.modal you can search:
*
* ```
* require('ui.modal');
* require('modules.ui.modal');
* require('humhub.modules.ui.modal');
* ```
*
* @function module:humhub.require
* @access public
* @param {type} moduleId
* @param {boolean} lazy - can be set to require modules which are not yet created.
* @returns object - the module instance if already initialized else undefined
*
* */
var require = function (moduleNS, lazy) {
var module = resolveNameSpace(moduleNS, (lazy !== false), true);
if (!module) {
console.error('No module found for namespace: ' + moduleNS);
}
return module;
};
/**
* Search the given namespace, and creates the namespace if init = true.
*
* @param {string} typePath the searched module namespace
* @param {Boolean} init - if set to true, creates namespaces if not already present
* @param warn whether or not to warn if the modules was initialized
* @returns Module - the given module
*/
var resolveNameSpace = function (typePath, init, warn) {
try {
//cut humhub.modules prefix if present
var moduleSuffix = _cutModulePrefix(typePath);
//Iterate through the namespace and return the last entry
var result = modules;
$.each(moduleSuffix.split('.'), function (i, subPath) {
if (subPath in result) {
result = result[subPath];
} else if (init) {
if(warn) {
console.warn('Required a non initialized module: '+typePath)
}
result = result[subPath] = {};
} else {
result = undefined; //path not found
return false; //leave each loop
}
});
return result;
} catch (e) {
var log = require('log') || console;
log.error('Error while resolving namespace: ' + typePath, e);
}
};
var _setNameSpace = function (path, obj) {
try {
//cut humhub.modules prefix if present
var moduleSuffix = _cutModulePrefix(path);
//Iterate through the namespace and return the last entry
var currentPath = modules;
var parent, last;
$.each(moduleSuffix.split('.'), function (i, subPath) {
if (subPath in currentPath) {
last = subPath;
parent = currentPath;
currentPath = currentPath[subPath];
} else {
return false; //leave each loop
}
});
parent[last] = obj;
} catch (e) {
var log = require('log') || console;
log.error('Error while setting namespace: ' + path, e);
}
};
/**
* Manages the state and access of module configurations.
*
* @module config
*/
var config = modules['config'] = {
id: 'config',
/**
* Searches for a given configuration key for a given module.
*
* @function module:config.get
* @access public
* @param {string} module module id
* @param {string} key configuration key
* @param {*} defaultVal default return type
* @returns {*}
*/
get: function (module, key, defaultVal) {
if (arguments.length === 1) {
return this.module(module);
} else if (_isDefined(key)) {
var result = this.module(module)[key];
return (_isDefined(result)) ? result : defaultVal;
}
},
/**
* Returns the whole configuration object of a module
*
* @function module:config.module
* @access public
* @param {string} module
* @returns {*}
*/
module: function (module) {
module = (module.id) ? module.id : module;
module = _cutModulePrefix(module);
if (!this[module]) {
this[module] = {};
}
return this[module];
},
/**
* Determines if a given configuration value is true
*
* @function module:config.is
* @access public
* @param {boolean} defaultVal
* @returns {boolean}
*/
is: function (module, key, defaultVal) {
return this.get(module, key, defaultVal) === true;
},
/**
* Sets a given configuration value
*
* @function module:config.set
* @access public
* @param {string} moduleId
* @param {string} key
* @param {*} value
*/
set: function (moduleId, key, value) {
//Moduleid with multiple values
if (arguments.length === 1) {
var that = this;
$.each(moduleId, function (moduleKey, config) {
that.set(moduleKey, config);
});
} else if (arguments.length === 2) {
$.extend(this.module(moduleId), key);
} else if (arguments.length === 3) {
this.module(moduleId)[key] = value;
}
}
};
/**
* Global event handling.
*
* @module event
**/
var event = modules['event'] = {
events: $({}),
/**
* Removes a given event handler.
*
* @function module:event.off
* @access public
* @param events
* @param selector
* @param handler
* @returns {module:event}
*/
off: function (events, selector, handler) {
this.events.off(events, selector, handler);
return this;
},
/**
* Registers an event handler.
*
* @function module:event.on
* @access public
* @param event
* @param selector
* @param data
* @param handler
* @returns {module:event}
*/
on: function (event, selector, data, handler) {
this.events.on(event, selector, data, handler);
return this;
},
/**
* Triggers a global event.
*
* @function module:event.trigger
* @access public
* @param eventType
* @param extraParameters
* @returns {module:event}
*/
trigger: function (eventType, extraParameters) {
this.events.trigger(eventType, extraParameters);
return this;
},
/**
* Registers a event handler which is only executed once.
*
* @function module:event.one
* @access public
* @param event
* @param selector
* @param data
* @param handler
* @returns {module:event}
*/
one: function (event, selector, data, handler) {
this.events.one(event, selector, data, handler);
return this;
},
/**
* Creates a sub event manager and appends it to a given target object.
*
* @function module:event.sub
* @access public
* @param {Object} target
*/
sub: function (target) {
target.events = $({});
target.on = $.proxy(event.on, target);
target.one = $.proxy(event.one, target);
target.off = $.proxy(event.off, target);
target.trigger = $.proxy(event.trigger, target);
target.triggerCondition = $.proxy(event.triggerCondition, target);
},
/**
* Triggers an given event and returns weather or not the events `preventDefaults()` was called.
*
* Supports the following cases:
*
* ```
* event.triggerCondition('testevent');
* event.triggerCondition('testevent', ['asdf']);
* event.triggerCondition('#test', 'testevent');
* event.triggerCondition('#test', 'testevent', ['asdf']);
* ```
*
* @function module:event.triggerCondition
* @access public
* @param target
* @param event
* @param extraParameters
* @returns {*}
*/
triggerCondition: function (target, event, extraParameters) {
var $target;
switch (arguments.length) {
case 1:
$target = this.events;
event = target;
break;
case 2:
if ($.isArray(event)) {
$target = this.events;
extraParameters = event;
} else {
$target = $(target);
}
break;
default:
$target = $(target);
break;
}
if (!event) {
return false;
}
var eventObj = $.Event(event);
$target.trigger(eventObj);
return eventObj.isDefaultPrevented();
}
};
/**
* Cuts the prefix humub.modules or modules. from the given value.
* @param {type} value
* @returns {unresolved}
*/
var _cutModulePrefix = function (value) {
return _cutPrefix(_cutPrefix(value, 'humhub.'), 'modules.');
};
/**
* Cuts a prefix from a string, this is already available in humhub.util but
* this is not accessible here.
*
* @param {type} value
* @param {type} prefix
* @returns {unresolved}
*/
var _cutPrefix = function (value, prefix) {
if (!_startsWith(value, prefix)) {
return value;
}
return value.substring(prefix.length, value.length);
};
/**
* Checks if a string strats with a given prefix
* @param {type} val
* @param {type} prefix
* @returns {Boolean}
*/
var _startsWith = function (val, prefix) {
if (!val || !prefix) {
return false;
}
return val.indexOf(prefix) === 0;
};
var _isDefined = function (obj) {
return typeof obj !== 'undefined';
};
var addModuleLogger = function (module, log) {
log = log || require('log');
module.log = log.module(module);
};
$(function() {
var log = require('log');
$.each(moduleArr, function (i, module) {
addModuleLogger(module, log);
});
initialModules.sort(function(a,b) {
var sortA = (typeof a.sortOrder !== 'undefined') ? a.sortOrder : 4294967295;
var sortB = (typeof b.sortOrder !== 'undefined') ? b.sortOrder : 4294967295;
if (sortA === sortB) {
return 0;
} else if (sortA < sortB) {
return -1;
}
return 1;
});
$.each(initialModules, function (i, module) {
initModule(module);
});
humhub.initialized = true;
event.trigger('humhub:ready');
$(document).trigger('humhub:ready', [false, humhub]);
});
var initModule = function (module) {
var log = require('log');
event.trigger('humhub:beforeInitModule', module);
if (module.init) {
try {
// compatibility with beta 1.2 beta release
event.trigger(module.id.replace('.', ':') + ':beforeInit', module);
event.trigger(module.id.replace(/\./g, ':') + ':beforeInit', module);
module.init();
event.trigger(module.id.replace(/\./g, ':') + ':afterInit', module);
// compatibility with beta 1.2 beta release
event.trigger(module.id.replace('.', ':') + ':afterInit', module);
} catch (err) {
log.error('Could not initialize module: ' + module.id, err);
}
}
event.trigger('humhub:afterInitModule', module);
log.debug('Module initialized: ' + module.id);
};
// Used to prevent the double initialization of modules loades by pjax.
var unloaded = [];
event.on('humhub:modules:client:pjax:success', function (evt) {
// Init all modules again which were unloaded in the beforeSend and are configured for pjax initialization.
// Note: this does not include modules loaded by the pjax request, those are initialized in the module function.
$.each(pjaxInitModules, function (i, module) {
if (module.initOnPjaxLoad && unloaded.indexOf(module.id) > -1) {
module.init(true);
}
});
event.trigger('humhub:ready');
$(document).trigger('humhub:ready', [true, humhub]);
}).on('humhub:modules:client:pjax:beforeSend', function (evt) {
unloaded = [];
$.each(moduleArr, function (i, module) {
if (module.unload) {
module.unload();
}
unloaded.push(module.id);
});
});
var polyfill = function () {
objectAssignPolyfill();
arrayIncludesPolyfill();
};
var arrayIncludesPolyfill = function () {
if (!Array.prototype.includes) {
Object.defineProperty(Array.prototype, 'includes', {
value: function (searchElement, fromIndex) {
if (this == null) {
throw new TypeError('"this" is null or not defined');
}
// 1. Let O be ? ToObject(this value).
var o = Object(this);
// 2. Let len be ? ToLength(? Get(O, "length")).
var len = o.length >>> 0;
// 3. If len is 0, return false.
if (len === 0) {
return false;
}
// 4. Let n be ? ToInteger(fromIndex).
// (If fromIndex is undefined, this step produces the value 0.)
var n = fromIndex | 0;
// 5. If n ≥ 0, then
// a. Let k be n.
// 6. Else n < 0,
// a. Let k be len + n.
// b. If k < 0, let k be 0.
var k = Math.max(n >= 0 ? n : len - Math.abs(n), 0);
function sameValueZero(x, y) {
return x === y || (typeof x === 'number' && typeof y === 'number' && isNaN(x) && isNaN(y));
}
// 7. Repeat, while k < len
while (k < len) {
// a. Let elementK be the result of ? Get(O, ! ToString(k)).
// b. If SameValueZero(searchElement, elementK) is true, return true.
if (sameValueZero(o[k], searchElement)) {
return true;
}
// c. Increase k by 1.
k++;
}
// 8. Return false
return false;
}
});
}
};
var objectAssignPolyfill = function () {
if (typeof Object.assign != 'function') {
// Must be writable: true, enumerable: false, configurable: true
Object.defineProperty(Object, "assign", {
value: function assign(target, varArgs) { // .length of function is 2
'use strict';
if (target == null) { // TypeError if undefined or null
throw new TypeError('Cannot convert undefined or null to object');
}
var to = Object(target);
for (var index = 1; index < arguments.length; index++) {
var nextSource = arguments[index];
if (nextSource != null) { // Skip over if undefined or null
for (var nextKey in nextSource) {
// Avoid bugs when hasOwnProperty is shadowed
if (Object.prototype.hasOwnProperty.call(nextSource, nextKey)) {
to[nextKey] = nextSource[nextKey];
}
}
}
}
return to;
},
writable: true,
configurable: true
});
}
};
polyfill();
return {
module: module,
modules: modules,
config: config,
event: event,
require: require
};
})(jQuery);
Mini Shell