☰

Greasy Fork is available in English.

Ikariam Core

Framework for Ikariam userscript developers.

Ovu skriptu ne treba izravno instalirati. To je biblioteka za druge skripte koje se uključuju u meta direktivu // @require https://update.greatest.deepsurf.us/scripts/5574/961702/Ikariam%20Core.js 

  1. // ==UserScript==
  2. // @name			Ikariam Core
  3. // @description		Framework for Ikariam userscript developers.
  4. // @namespace		IkariamCore
  5. // @author			Tobbe
  6. // @version			3.2.1
  7. // @license			MIT License
  8. //
  9. // @name:de			Ikariam Core
  10. // @description:de	Framework für Ikariam Benutzerscript Entwickler.
  11. //
  12. // @exclude			*
  13. // 
  14. // @connect			greatest.deepsurf.us
  15. // 
  16. // @grant			unsafeWindow
  17. // @grant			GM_setValue
  18. // @grant			GM.setValue
  19. // @grant			GM_getValue
  20. // @grant			GM.getValue
  21. // @grant			GM_deleteValue
  22. // @grant			GM.deleteValue
  23. // @grant			GM_listValues
  24. // @grant			GM.listValues
  25. // @grant			GM_getResourceText
  26. // @grant			GM.getResourceText
  27. // @grant			GM_xmlhttpRequest
  28. // @grant			GM.xmlHttpRequest
  29. // ==/UserScript==
  30.  
  31. // Add some functions to the String and Array prototype, namespaced by "IC".
  32. (function() {
  33. 	// "Internal" function to add functions to native objects with the usage of an namespace.
  34. 	var _addNamespacedFunctions = function(io_parent, is_namespaceName, io_functionsToAdd) {
  35. 		var lo_functionStorage = {};
  36. 		
  37. 		var lf_createGetter = function(is_functionName) {
  38. 			return function() {
  39. 				return function() {
  40. 					return io_functionsToAdd[is_functionName].apply(go_self, arguments);
  41. 				};
  42. 			};
  43. 		};
  44. 		
  45. 		for(var ls_functionName in io_functionsToAdd) {
  46. 			if(io_functionsToAdd.hasOwnProperty(ls_functionName)) {
  47. 				Object.defineProperty(lo_functionStorage, ls_functionName, { get: lf_createGetter(ls_functionName) });
  48. 			}
  49. 		}
  50. 		
  51. 		Object.defineProperty(io_parent.prototype, is_namespaceName, {
  52. 			get: function() {
  53. 				go_self = this;
  54. 				return lo_functionStorage;
  55. 			}
  56. 		});
  57. 	};
  58. 	
  59. 	/**
  60. 	 * Additional methods for processing strings.
  61. 	 * 
  62. 	 * @external	"String.IC"
  63. 	 */
  64. 	_addNamespacedFunctions(String, 'IC', {
  65. 		/**
  66. 		 * Replaces characters or whitespaces at the beginning of a string.
  67. 		 * 
  68. 		 * @function external:"String.IC".ltrim
  69. 		 * 
  70. 		 * @param	{?String}	[is_toRemove=whitespaces]
  71. 		 *   A string containing the characters to remove.
  72. 		 *
  73. 		 * @return	{String}
  74. 		 *   The trimmed string.
  75. 		 */
  76. 		ltrim: function(is_toRemove) {
  77. 			return !!is_toRemove ? this.replace(new RegExp('^[' + is_toRemove + ']+'), '') : this.replace(/^\s+/, '');
  78. 		},
  79. 		/**
  80. 		 * Replaces characters or whitespaces at the end of a string.
  81. 		 *
  82. 		 * @function external:"String.IC".rtrim
  83. 		 * 
  84. 		 * @param	{?String}	[is_toRemove=whitespaces]
  85. 		 *   A string containing the characters to remove.
  86. 		 *
  87. 		 * @return	{String}
  88. 		 *   The trimmed string.
  89. 		 */
  90. 		rtrim: function(is_toRemove) {
  91. 			return !!is_toRemove ? this.replace(new RegExp('[' + is_toRemove + ']+$'), '') : this.replace(/\s+$/, '');
  92. 		},
  93. 		/**
  94. 		 * Replaces characters or whitespaces at the beginning and end of a string.
  95. 		 *
  96. 		 * @function external:"String.IC".trim
  97. 		 * 
  98. 		 * @param	{?String}	[is_toRemove=whitespaces]
  99. 		 *   A string containing the characters to remove.
  100. 		 *
  101. 		 * @return	{String}
  102. 		 *   The trimmed string.
  103. 		 */
  104. 		trim: function(is_toRemove) {
  105. 			return this.IC.ltrim(is_toRemove).IC.rtrim(is_toRemove);
  106. 		},
  107. 		/**
  108. 		 * Encodes HTML-special characters in a string.
  109. 		 *
  110. 		 * @function external:"String.IC".encodeHTML
  111. 		 * 
  112. 		 * @return	{String}
  113. 		 *   The encoded string.
  114. 		 */
  115. 		encodeHTML: function() {
  116. 			// Set the characters to encode.
  117. 			var lo_characters = {
  118. 				'&':	'&',
  119. 				'"':	'"',
  120. 				'\'':	''',
  121. 				'<':	'&lt;',
  122. 				'>':	'&gt;'
  123. 			};
  124. 			
  125. 			return this.replace(/([\&"'<>])/g, function(is_string, is_symbol) { return lo_characters[is_symbol]; });
  126. 		},
  127. 		/**
  128. 		 * Decodes HTML-special characters in a string.
  129. 		 *
  130. 		 * @function external:"String.IC".decodeHTML
  131. 		 * 
  132. 		 * @return	{String}
  133. 		 *   The decoded string.
  134. 		 */
  135. 		decodeHTML: function() {
  136. 			// Set the characters to decode.
  137. 			var lo_characters = {
  138. 				'&amp;':	'&',
  139. 				'&quot;':	'"',
  140. 				'&apos;':	'\'',
  141. 				'&lt;':		'<',
  142. 				'&gt;':		'>'
  143. 			};
  144. 			
  145. 			return this.replace(/(&quot;|&apos;|&lt;|&gt;|&amp;)/g, function(is_string, is_symbol) { return lo_characters[is_symbol]; });
  146. 		},
  147. 		/**
  148. 		 * Repeats a string a specified number of times.
  149. 		 * 
  150. 		 * @function external:"String.IC".repeat
  151. 		 * 
  152. 		 * @param	{int}	ii_nr
  153. 		 *   The number of times to repeat the string.
  154. 		 * 
  155. 		 * @return	{String}
  156. 		 *   The repeated string.
  157. 		 */
  158. 		repeat: function(ii_nr) {
  159. 			var rs_repeated = this;
  160. 			
  161. 			for(var i = 1; i < ii_nr; i++) {
  162. 				rs_repeated += this;
  163. 			}
  164. 			
  165. 			return rs_repeated;
  166. 		}
  167. 	});
  168. 	
  169. 	/**
  170. 	 * Additional methods for processing arrays.
  171. 	 * 
  172. 	 * @external	"Array.IC"
  173. 	 */
  174. 	_addNamespacedFunctions(Array, 'IC', {
  175. 		/**
  176. 		 * Inserts an element at a specified position into an array.
  177. 		 * 
  178. 		 * @function external:"Array.IC".insert
  179. 		 * 
  180. 		 * @param	{*}		im_item
  181. 		 *   The item which should be inserted.
  182. 		 * @param	{?int}	[ii_index=this.length]
  183. 		 *   The position where the element should be added. If not set, the element will be added at the end.
  184. 		 */
  185. 		insert: function(im_item, ii_index) {
  186. 			var li_maxIndex = this.length;
  187. 			
  188. 			// Get the index to insert.
  189. 			var li_index = !ii_index && ii_index != 0 ? li_maxIndex : ii_index;
  190. 			li_index = Math.max(li_index, 0);			// No negative index.
  191. 			li_index = Math.min(li_index, li_maxIndex);	// No index bigger than the array length.
  192. 			
  193. 			this.splice(li_index, 0, im_item);
  194. 		},
  195. 		/**
  196. 		 * Deletes an element at a specified position from an array.
  197. 		 * 
  198. 		 * @function external:"Array.IC".remove
  199. 		 * 
  200. 		 * @param	{int}	ii_index
  201. 		 *   The position of the element which should be deleted.
  202. 		 */
  203. 		remove: function(ii_index) {
  204. 			if(ii_index >= 0 && ii_index < this.length) {
  205. 				this.splice(ii_index, 1);
  206. 			}
  207. 		}
  208. 	});
  209. 	
  210. 	/**
  211. 	 * Additional methods for processing dates.
  212. 	 * 
  213. 	 * @external	"Date.IC"
  214. 	 */
  215. 	_addNamespacedFunctions(Date, 'IC', {
  216. 		/**
  217. 		 * Formats a date / time.
  218. 		 * 
  219. 		 * @example
  220. 		 *   (new Date()).IC.format('yyyy-MM-dd HH:mm:ss.SSS');
  221. 		 * 
  222. 		 * @function external:"Date.IC".format
  223. 		 * 
  224. 		 * @param	{String}	is_pattern
  225. 		 *   The pattern for the output.<br>
  226. 		 *   <br>
  227. 		 *   Options:<br>
  228. 		 *   <pre>  yyyy year, four digits
  229. 		 *   yy   year, two digits
  230. 		 *   MM   month, leading 0
  231. 		 *   M    month, no leading 0
  232. 		 *   dd   day, leading 0
  233. 		 *   d    day, no leading 0
  234. 		 *   hh   hour, 1-12, leading 0
  235. 		 *   h    hour, 1-12, no leading 0
  236. 		 *   HH   hour, 0-23, leading 0
  237. 		 *   H    hour, 0-23, no leading 0
  238. 		 *   mm   minute, leading 0
  239. 		 *   m    minute, no leading 0
  240. 		 *   ss   seconds, leading 0
  241. 		 *   s    seconds, no leading 0
  242. 		 *   SSS  milliseconds, leading 0
  243. 		 *   S    milliseconds, no leading 0
  244. 		 *   a    AM / PM</pre>
  245. 		 */
  246. 		format: function(is_pattern) {
  247. 			var lo_possibleOptions = {
  248. 				'yyyy':	this.getFullYear(),		// year, four digits
  249. 				'yy':	this.getYear() % 100,	// year, two digits
  250. 				'MM':	this.getMonth() + 1,	// month, leading 0
  251. 				'M':	this.getMonth() + 1,	// month, no leading 0
  252. 				'dd':	this.getDate(),			// day, leading 0
  253. 				'd':	this.getDate(),			// day, no leading 0
  254. 				'hh':	this.getHours() + 1,	// hour, 1-12, leading 0
  255. 				'h':	this.getHours() + 1,	// hour, 1-12, no leading 0
  256. 				'HH':	this.getHours(),		// hour, 0-23, leading 0
  257. 				'H':	this.getHours(),		// hour, 0-23, no leading 0
  258. 				'mm':	this.getMinutes(),		// minute, leading 0
  259. 				'm':	this.getMinutes(),		// minute, no leading 0
  260. 				'ss':	this.getSeconds(),		// seconds, leading 0
  261. 				's':	this.getSeconds(),		// seconds, no leading 0
  262. 				'SSS':	this.getMilliseconds(),	// milliseconds, ledaing 0
  263. 				'S':	this.getMilliseconds(),	// milliseconds, no leading 0
  264. 				'a':	'AM'					// AM / PM
  265. 			};
  266. 			
  267. 			if(lo_possibleOptions.MM < 10)	lo_possibleOptions.MM = '0' + lo_possibleOptions.MM;
  268. 			if(lo_possibleOptions.dd < 10)	lo_possibleOptions.dd = '0' + lo_possibleOptions.dd;
  269. 			if(lo_possibleOptions.h > 12)	lo_possibleOptions.hh = lo_possibleOptions.h = lo_possibleOptions.h - 12;
  270. 			if(lo_possibleOptions.hh < 10)	lo_possibleOptions.hh = '0' + lo_possibleOptions.hh;
  271. 			if(lo_possibleOptions.HH < 10)	lo_possibleOptions.HH = '0' + lo_possibleOptions.HH;
  272. 			if(lo_possibleOptions.mm < 10)	lo_possibleOptions.mm = '0' + lo_possibleOptions.mm;
  273. 			if(lo_possibleOptions.ss < 10)	lo_possibleOptions.ss = '0' + lo_possibleOptions.ss;
  274. 			if(lo_possibleOptions.S < 100)	lo_possibleOptions.SSS = '0' + lo_possibleOptions.SSS;
  275. 			if(lo_possibleOptions.S < 10)	lo_possibleOptions.SSS = '0' + lo_possibleOptions.SSS;
  276. 			if(lo_possibleOptions.H > 11)	lo_possibleOptions.a = 'PM';
  277. 			
  278. 			var rs_pattern = is_pattern;
  279. 			
  280. 			for(var ls_option in lo_possibleOptions) {
  281. 				rs_pattern = rs_pattern.replace(new RegExp('(' + ls_option + ')', 'g'), lo_possibleOptions[ls_option]);
  282. 			}
  283. 			
  284. 			return rs_pattern;
  285. 		}
  286. 	});
  287. })();
  288.  
  289. /**
  290.  * Instantiate a new set of core functions.<br>
  291.  * {@link https://greatest.deepsurf.us/scripts/5574-ikariam-core Script on Greasy Fork}<br>
  292.  * {@link https://github.com/IkaScripts/IkariamCore Script on GitHub}
  293.  * 
  294.  * @version	3.2.1
  295.  * @author	Tobbe	<ikascripts@tobbexiv.de>
  296.  * 
  297.  * @global
  298.  * 
  299.  * @class
  300.  * @classdesc	Framework for Ikariam userscript developers.
  301.  * 
  302.  * @param	{String}	is_scriptVersion
  303.  *   The version of the script using Ikariam Core.
  304.  * @param	{int}		ii_scriptId
  305.  *   The id of the script using Ikariam Core.
  306.  * @param	{String}	is_scriptName
  307.  *   The name of the script using Ikariam Core.
  308.  * @param	{String}	is_scriptAuthor
  309.  *   The author of the script using Ikariam Core.
  310.  * @param	{boolean}	ib_debug
  311.  *   If debugging is enabled.
  312.  */
  313. function IkariamCore(is_scriptVersion, ii_scriptId, is_scriptName, is_scriptAuthor, ib_debug) {
  314. 	/**
  315. 	 * Storage for accessing <code>this</code> as reference to IkariamCore in subfunctions. Do <b>NOT</b> delete!
  316. 	 * 
  317. 	 * @private
  318. 	 * @inner
  319. 	 * 
  320. 	 * @type	IkariamCore
  321. 	 */
  322. 	var go_self = this;
  323. 	
  324. 	/**
  325. 	 * Storage for information on the script using Ikariam Core.
  326. 	 * 
  327. 	 * @private
  328. 	 * @inner
  329. 	 * 
  330. 	 * @type Object
  331. 	 * 
  332. 	 * @property	{String}	version	- The script version.
  333. 	 * @property	{int}		id		- The script id.
  334. 	 * @property	{String}	name	- The script name.
  335. 	 * @property	{String}	author	- The script author.
  336. 	 */
  337. 	var go_script = {
  338. 		version:	is_scriptVersion,
  339. 		id:			ii_scriptId,
  340. 		name:		is_scriptName,
  341. 		author:		is_scriptAuthor
  342. 	};
  343. 	
  344. 	/**
  345. 	 * General settings like debugging switched on / off.
  346. 	 * 
  347. 	 * @private
  348. 	 * @inner
  349. 	 * 
  350. 	 * @type Object
  351. 	 * 
  352. 	 * @property	{boolean}	debug	- If debugging is enabled.
  353. 	 */
  354. 	var go_settings = {
  355. 		debug:	ib_debug
  356. 	};
  357. 	
  358. 	/**
  359. 	 * A reference to <code>window</code> / <code>unsafeWindow</code>.
  360. 	 * 
  361. 	 * @instance
  362. 	 * 
  363. 	 * @type	window
  364. 	 */
  365. 	this.win = typeof unsafeWindow != 'undefined' ? unsafeWindow : window;
  366. 	
  367. 	/**
  368. 	 * Reference to <code>window.ikariam</code>.
  369. 	 * 
  370. 	 * @instance
  371. 	 * 
  372. 	 * @type	Object
  373. 	 */
  374. 	this.ika = this.win.ikariam;
  375. 	
  376. 	/**
  377. 	 * Debugging console.<br>
  378. 	 * Available commands:<br>
  379. 	 * <code>assert, clear, count, debug, dir, dirxml, error, exception, group, groupCollapsed, groupEnd,
  380. 	 * info, log, logTimeStamp, profile, profileEnd, table, time, timeEnd, timeStamp, trace, warn</code><br>
  381. 	 * <br>
  382. 	 * The console is deactivated by the Ikariam page but with the script {@link https://greatest.deepsurf.us/de/scripts/6310-rescue-console Rescue Console} you can use it.
  383. 	 * 
  384. 	 * @instance
  385. 	 * 
  386. 	 * @type	console
  387. 	 */
  388. 	this.con = (function() {
  389. 		// Wrapper for console functions.
  390. 		var lo_consoleWrapper = {};
  391. 		
  392. 		// Set the console to the "rescued" debugConsole.
  393. 		var lo_originalConsole = go_self.win.debugConsole;
  394. 		
  395. 		// Define all console tags.
  396. 		var la_tags = ['assert', 'clear', 'count', 'debug', 'dir', 'dirxml', 'error', 'exception',
  397. 						'group', 'groupCollapsed', 'groupEnd', 'info', 'log', 'logTimeStamp', 'profile',
  398. 						'profileEnd', 'table', 'time', 'timeEnd', 'timeStamp', 'trace', 'warn'];
  399. 		
  400. 		var lo_counters	= {};
  401. 		var lo_timers	= {};
  402. 		
  403. 		// Define the backup functions.
  404. 		var lo_selfDefinedFunctions = {
  405. 			assert: function(im_toCheck, im_toLog) {
  406. 				if(im_toCheck === false || im_toCheck === 0 || im_toCheck === null || im_toCheck === undefined) {
  407. 					go_self.con.error(im_toLog || 'Assertion Failure');
  408. 				}
  409. 			},
  410. 			count: function(is_name) {
  411. 				if(!lo_counters[is_name] === true)
  412. 					lo_counters[is_name] = 0;
  413. 				
  414. 				lo_counters[is_name]++;
  415. 				
  416. 				go_self.con.log(is_name + ': ' + lo_counters[is_name]);
  417. 			},
  418. 			debug: function() {
  419. 				go_self.con.log.apply(arguments);
  420. 			},
  421. 			error: function() {
  422. 				go_self.con.log.apply(arguments);
  423. 			},
  424. 			exception: function() {
  425. 				go_self.con.log.apply(arguments);
  426. 			},
  427. 			info: function() {
  428. 				go_self.con.log.apply(arguments);
  429. 			},
  430. 			logTimeStamp: function(iv_name) {
  431. 				go_self.con.log((new Date()).IC.format('HH:mm:ss.SSS') + ' ' + iv_name);
  432. 			},
  433. 			time: function(is_name) {
  434. 				go_self.con.info(is_name + ': timer started');
  435. 				lo_timers[is_name] = new Date();
  436. 			},
  437. 			timeEnd: function(is_name) {
  438. 				var ld_now = new Date();
  439. 				var li_timeElapsed = ld_now.getMilliseconds() - lo_timers[is_name].getMilliseconds();
  440. 				
  441. 				delete	lo_timers[is_name];
  442. 				
  443. 				go_self.con.info(is_name + ': ' + li_timeElapsed + 'ms');
  444. 			},
  445. 			warn: function() {
  446. 				go_self.con.log.apply(arguments);
  447. 			}
  448. 		};
  449. 		
  450. 		for(var i = 0; i < la_tags.length; i++) {
  451. 			var ls_key = la_tags[i];
  452. 			
  453. 			if(go_settings.debug) {
  454. 				// If available in console: use console; else: use backup function if available.
  455. 				if(lo_originalConsole[ls_key]) {
  456. 					lo_consoleWrapper[ls_key] = lo_originalConsole[ls_key];
  457. 				} else if(lo_selfDefinedFunctions[ls_key]) {
  458. 					lo_consoleWrapper[ls_key] = lo_selfDefinedFunctions[ls_key];
  459. 				}
  460. 			}
  461. 			
  462. 			// If the function is not set yet, set it to an empty function.
  463. 			if(!lo_consoleWrapper[ls_key]) {
  464. 				lo_consoleWrapper[ls_key] = function() { return; };
  465. 			}
  466. 		}
  467. 		
  468. 		return lo_consoleWrapper;
  469. 	})();
  470.  
  471. 	this.con.groupCollapsed('IkariamCore initalization ...');
  472. 	
  473. 	/**
  474. 	 * Instantiate a new set of myGM functions.
  475. 	 * 
  476. 	 * @inner
  477. 	 * 
  478. 	 * @class
  479. 	 * @classdesc	Functions for cross-browser compatibility of the GM_* functions.<br>Also there are some new functionalities implemented.
  480. 	 */
  481. 	function myGM() {
  482. 		/*--------------------------------------------*
  483. 		 * Private variables, functions and settings. *
  484. 		 *--------------------------------------------*/
  485. 		
  486. 		/**
  487. 		 * Storage for style sheets which will be added by the script.
  488. 		 * 
  489. 		 * @private
  490. 		 * @inner
  491. 		 * 
  492. 		 * @type	Object.<String, Element>
  493. 		 */
  494. 		var _go_styleSheets = {};
  495. 		
  496. 		/**
  497. 		 * Storage for notification id for possibility to identify a notification popup.
  498. 		 * 
  499. 		 * @private
  500. 		 * @inner
  501. 		 * 
  502. 		 * @type	int
  503. 		 */
  504. 		var _gi_notificationId = 0;
  505. 		
  506. 		/**
  507. 		 * If the GM_ functions <code>GM_setValue</code>, <code>GM_getValue</code>, <code>GM_deleteValue</code> and <code>GM_listValues</code> can be used.
  508. 		 * 
  509. 		 * @private
  510. 		 * @inner
  511. 		 * 
  512. 		 * @type	boolean
  513. 		 */
  514. 		var _gb_canUseGmStorage = !(typeof GM_getValue == 'undefined')
  515. 									&& !(typeof GM_setValue == 'undefined')
  516. 									&& !(typeof GM_deleteValue == 'undefined')
  517. 									&& !(typeof GM_listValues == 'undefined');
  518. 		
  519. 		/**
  520. 		 * If the GM. functions <code>GM.setValue</code>, <code>GM.getValue</code>, <code>GM.deleteValue</code> and <code>GM.listValues</code> can be used.
  521. 		 * 
  522. 		 * @private
  523. 		 * @inner
  524. 		 * 
  525. 		 * @type	boolean
  526. 		 */
  527. 		var _gb_canUseGmStorageNew = !(typeof GM == 'undefined')
  528. 									&& !(typeof GM.getValue == 'undefined')
  529. 									&& !(typeof GM.setValue == 'undefined')
  530. 									&& !(typeof GM.deleteValue == 'undefined')
  531. 									&& !(typeof GM.listValues == 'undefined');
  532. 		
  533. 		/**
  534. 		 * If the GM_ function <code>GM_getResourceText</code> can be used.
  535. 		 * 
  536. 		 * @private
  537. 		 * @inner
  538. 		 * 
  539. 		 * @type	boolean
  540. 		 */
  541. 		var _gb_canUseGmRessource = !(typeof GM_getResourceText == 'undefined');
  542. 		
  543. 		/**
  544. 		 * If the GM_ function <code>GM_xmlhttpRequest</code> can be used.
  545. 		 * 
  546. 		 * @private
  547. 		 * @inner
  548. 		 * 
  549. 		 * @type	boolean
  550. 		 */
  551. 		var _gb_canUseGmXhr = !(typeof GM_xmlhttpRequest == 'undefined');
  552. 		
  553. 		/**
  554. 		 * If the GM. function <code>GM.xmlhttpRequest</code> can be used.
  555. 		 * 
  556. 		 * @private
  557. 		 * @inner
  558. 		 * 
  559. 		 * @type	boolean
  560. 		 */
  561. 		var _gb_canUseGmXhrNew = !(typeof GM == 'undefined') && !(typeof GM.xmlHttpRequest == 'undefined');
  562. 		
  563. 		/**
  564. 		 * If the local storage can be used.
  565. 		 * 
  566. 		 * @private
  567. 		 * @inner
  568. 		 * 
  569. 		 * @type	boolean
  570. 		 */
  571. 		var _gb_canUseLocalStorage = !!go_self.win.localStorage;
  572. 		
  573. 		/**
  574. 		 * The domain for storing cookies.
  575. 		 * 
  576. 		 * @private
  577. 		 * @inner
  578. 		 * 
  579. 		 * @type	String
  580. 		 */
  581. 		var _gs_cookieDomain = 'ikariam.gameforge.com';
  582. 		
  583. 		/**
  584. 		 * Create the header for a notification panel.
  585. 		 * 
  586. 		 * @private
  587. 		 * @inner
  588. 		 * 
  589. 		 * @param	{int}		ii_id
  590. 		 *   The id of the notification.
  591. 		 * @param	{Element}	ie_panel
  592. 		 *   The panel of the notification.
  593. 		 * @param	{String}	is_headerText
  594. 		 *   The text for the header.
  595. 		 * @param	{IkariamCore~myGM~ConfirmAbortWithoutInput}	if_closePanel
  596. 		 *   The function to close the notification panel.
  597. 		 */
  598. 		var _createNotificationPanelHeader = function(ii_id, ie_panel, is_headerText, if_closePanel) {
  599. 			var le_wrapper		= go_self.myGM.addElement('div', ie_panel, { 'id': 'notificationPanelHeader' + ii_id, 'class': 'notificationPanelHeader' }, true);
  600. 			var le_left			= go_self.myGM.addElement('div', le_wrapper, { 'id': 'notificationPanelHeaderL' + ii_id, 'class': 'notificationPanelHeaderL' }, true);
  601. 			var le_right		= go_self.myGM.addElement('div', le_left, { 'id': 'notificationPanelHeaderR' + ii_id, 'class': 'notificationPanelHeaderR' }, true);
  602. 			var le_center		= go_self.myGM.addElement('div', le_right, { 'id': 'notificationPanelHeaderM' + ii_id, 'class': 'notificationPanelHeaderM', 'innerHTML': is_headerText }, true);
  603. 			go_self.myGM.addElement('div', le_center, { 'id': 'notificationPanelClose' + ii_id, 'class': 'notificationPanelClose', 'click': if_closePanel }, true);
  604. 		};
  605. 		
  606. 		/**
  607. 		 * Create the header for a notification.
  608. 		 * 
  609. 		 * @private
  610. 		 * @inner
  611. 		 * 
  612. 		 * @param	{int}		ii_id
  613. 		 *   The id of the notification.
  614. 		 * @param	{Element}	ie_panel
  615. 		 *   The panel of the notification.
  616. 		 * @param	{IkariamCore~myGM~NotificationBodyOptions}	io_options
  617. 		 *   Options for the body.<br>
  618. 		 * @param	{IkariamCore~myGM~NotificationBodyText}	io_texts
  619. 		 *   The texts for the body.
  620. 		 */
  621. 		var _createNotificationPanelBody = function(ii_id, ie_panel, io_options, io_texts) {
  622. 			var le_wrapper	= go_self.myGM.addElement('div', ie_panel, { 'id': 'notificationPanelBody' + ii_id, 'class': 'notificationPanelBody' }, true);
  623. 			var le_left		= go_self.myGM.addElement('div', le_wrapper, { 'id': 'notificationPanelBodyL' + ii_id, 'class': 'notificationPanelBodyL' }, true);
  624. 			var le_right	= go_self.myGM.addElement('div', le_left, { 'id': 'notificationPanelBodyR' + ii_id, 'class': 'notificationPanelBodyR' }, true);
  625. 			var le_center	= go_self.myGM.addElement('div', le_right, { 'id': 'notificationPanelBodyM' + ii_id, 'class': 'notificationPanelBodyM' }, true);
  626. 			var ls_bodyType = 'div';
  627. 			var re_body;
  628. 			
  629. 			var lo_generalOptions = {};
  630. 			
  631. 			if(io_options.textarea === true) {
  632. 				ls_bodyType = 'textarea';
  633. 				
  634. 				if(io_options.readonly === true)
  635. 					lo_generalOptions['readonly'] = 'readonly';
  636. 				
  637. 				if(io_options.autoselect === true)
  638. 					lo_generalOptions['focus'] = function() { this.select(); };
  639. 			}
  640. 			
  641. 			if(!!io_texts.body === true) {
  642. 				re_body = go_self.myGM.addElement(ls_bodyType, le_center, go_self.myGM.merge({
  643. 					'id':			'notificationPanelBodyMContent' + ii_id,
  644. 					'class':		'notificationPanelBodyMContent',
  645. 					'innerHTML':	io_texts.body
  646. 				}, lo_generalOptions), true);
  647. 			} else {
  648. 				go_self.myGM.addElement('div', le_center, { 'id': 'notificationPanelBodyMTop' + ii_id, 'class': 'notificationPanelBodyMTop', 'innerHTML': io_texts.top }, true);
  649. 				re_body = go_self.myGM.addElement(ls_bodyType, le_center, go_self.myGM.merge({
  650. 					'id':			'notificationPanelBodyMBottom' + ii_id,
  651. 					'class':		'notificationPanelBodyMBottom',
  652. 					'innerHTML':	io_texts.bottom
  653. 				}, lo_generalOptions), true);
  654. 			}
  655. 			
  656. 			if(io_options.textarea !== true)
  657. 				re_body = null;
  658. 			
  659. 			go_self.myGM.addElement('div', le_center, { 'id': 'notificationPanelBodyPlaceholder' + ii_id, 'class': 'notificationPanelBodyPlaceholder' }, true);
  660. 			
  661. 			return re_body;
  662. 		};
  663. 		
  664. 		/**
  665. 		 * Create the footer for a notification panel.
  666. 		 * 
  667. 		 * @private
  668. 		 * @inner
  669. 		 * 
  670. 		 * @param	{int}		ii_id
  671. 		 *   The id of the notification.
  672. 		 * @param	{Element}	ie_panel
  673. 		 *   The panel of the notification.
  674. 		 */
  675. 		var _createNotificationPanelFooter = function(ii_id, ie_panel) {
  676. 			var le_wrapper		= go_self.myGM.addElement('div', ie_panel, { 'id': 'notificationPanelFooter' + ii_id, 'class': 'notificationPanelFooter' }, true);
  677. 			var le_left			= go_self.myGM.addElement('div', le_wrapper, { 'id': 'notificationPanelFooterL' + ii_id, 'class': 'notificationPanelFooterL' }, true);
  678. 			var le_right		= go_self.myGM.addElement('div', le_left, { 'id': 'notificationPanelFooterR' + ii_id, 'class': 'notificationPanelFooterR' }, true);
  679. 			go_self.myGM.addElement('div', le_right, {
  680. 				'id':			'notificationPanelFooterM' + ii_id,
  681. 				'class':		'notificationPanelFooterM',
  682. 				'innerHTML':	go_script.name + ' v' + go_script.version
  683. 			}, true);
  684. 		};
  685. 		
  686. 		/**
  687. 		 * Create the buttons for a notification panel.
  688. 		 * 
  689. 		 * @private
  690. 		 * @inner
  691. 		 * 
  692. 		 * @param	{int}		ii_id
  693. 		 *   The id of the notification.
  694. 		 * @param	{Element}	ie_panel
  695. 		 *   The panel of the notification.
  696. 		 * @param	{Element}	ie_body
  697. 		 *   The body of the notification.
  698. 		 * @param	{IkariamCore~myGM~NotificationButtonsText}	io_texts
  699. 		 *   The texts for the buttons.
  700. 		 * @param	{IkariamCore~myGM~NotificationButtonCallbacks}	io_callbacks
  701. 		 *   The callbacks for the buttons.
  702. 		 */
  703. 		var _createNotificationPanelButtons = function(ii_id, ie_panel, ie_body, io_texts, io_callbacks) {
  704. 			var le_wrapper	= go_self.myGM.addElement('div', ie_panel, {
  705. 				'id':		'notificationPanelButtonWrapper' + ii_id,
  706. 				'class':	'notificationPanelButtonWrapper'
  707. 			}, true);
  708. 			
  709. 			var lf_confirm;
  710. 			if(!!io_callbacks.confirm === true)
  711. 				lf_confirm = function() { io_callbacks.close(); io_callbacks.confirm(ie_body); };
  712. 			else
  713. 				lf_confirm = io_callbacks.close;
  714. 			
  715. 			go_self.myGM.addElement('input', le_wrapper, {
  716. 				'id':		'notificationPanelConfirm' + ii_id,
  717. 				'classes':	['notificationPanelButton', 'notificationPanelButtonConfirm'],
  718. 				'type':		'button',
  719. 				'value':	io_texts.confirm ? io_texts.confirm : go_self.Language.$('core.notification.button.confirm'),
  720. 				'click':	lf_confirm
  721. 			}, true);
  722. 			
  723. 			if(!!io_callbacks.abort === true) {
  724. 				go_self.myGM.addElement('input', le_wrapper, {
  725. 					'id':		'notificationPanelAbort' + ii_id,
  726. 					'classes':	['notificationPanelButton', 'notificationPanelButtonAbort'],
  727. 					'type':		'button',
  728. 					'value':	io_texts.abort ? io_texts.abort : go_self.Language.$('core.notification.button.abort'),
  729. 					'click':	function() { io_callbacks.close(); io_callbacks.abort(ie_body); }
  730. 				}, true);
  731. 			}
  732. 		};
  733. 		
  734. 		/*-------------------------------------------*
  735. 		 * Public variables, functions and settings. *
  736. 		 *-------------------------------------------*/
  737. 		
  738. 		/**
  739. 		 * Script identifying prefix.
  740. 		 * 
  741. 		 * @instance
  742. 		 * @readonly
  743. 		 * @name	 prefix
  744. 		 * @memberof IkariamCore~myGM
  745. 		 * 
  746. 		 * @type	{String}
  747. 		 */
  748. 		Object.defineProperty(this, 'prefix', { get: function() {
  749. 			return 'script' + go_script.id;
  750. 		} });
  751. 		
  752. 		/**
  753. 		 * Returns if the script is already executed on this page.
  754. 		 * 
  755. 		 * @instance
  756. 		 * @readonly
  757. 		 * @name	 alreadyExecuted
  758. 		 * @memberof IkariamCore~myGM
  759. 		 *
  760. 		 * @type	{boolean}
  761. 		 */
  762. 		Object.defineProperty(this, 'alreadyExecuted', { get: function() {
  763. 			if(this.$('#' + this.prefix + 'alreadyExecuted'))
  764. 				return true;
  765. 		
  766. 			// Add the hint, that the script was already executed.
  767. 			this.addElement('input', this.$('body'), { 'id': 'alreadyExecuted', 'type': 'hidden' });
  768. 			return false;
  769. 		} });
  770. 		
  771. 		/**
  772. 		 * Store a value specified by a key.
  773. 		 * 
  774. 		 * @instance
  775. 		 * 
  776. 		 * @param	{String}	is_key
  777. 		 *   The key of the value.
  778. 		 * @param	{*}			im_value
  779. 		 *   The value to store.
  780. 		 * 
  781. 		 * @return	{Promise}
  782. 		 *   A promise which resolves once the value is stored.
  783. 		 */
  784. 		this.setValue = function(is_key, im_value) {
  785. 			// Stringify the value to store also arrays.
  786. 			var ls_toStore = JSON.stringify(im_value);
  787. 			var ro_promise = null;
  788. 			
  789. 			// If the use of GM_setValue is possible, use it.
  790. 			if(_gb_canUseGmStorage) {
  791. 				GM_setValue(is_key, ls_toStore);
  792. 				
  793. 			// If the use of GM.setValue is possible, use it.
  794. 			} else if(_gb_canUseGmStorageNew) {
  795. 				ro_promise = GM.setValue(is_key, ls_toStore);
  796. 				
  797. 			// Otherwise use the local storage if possible.
  798. 			} else if(_gb_canUseLocalStorage) {
  799. 				go_self.win.localStorage.setItem(this.prefix + is_key, ls_toStore);
  800. 	
  801. 			// Otherwise use cookies.
  802. 			} else {
  803. 				var ls_data	= escape(this.prefix + is_key) + '=' + escape(ls_toStore);
  804. 				var ls_expire	= 'expires=' + (new Date(2020, 0, 1, 0, 0, 0, 0)).toGMTString();
  805. 				var ls_path	= 'path=/';
  806. 				var ls_domain	= 'domain=' + _gs_cookieDomain;
  807. 	
  808. 				go_self.win.document.cookie = ls_data + ';' + ls_expire + ';' + ls_path + ';' + ls_domain;
  809. 			}
  810. 			
  811. 			if(ro_promise == null) {
  812. 				ro_promise = Promise.resolve();
  813. 			}
  814. 	
  815. 			// Return the promise.
  816. 			return ro_promise;
  817. 		};
  818. 	
  819. 		/**
  820. 		 * Get a value and return it.
  821. 		 * 
  822. 		 * @instance
  823. 		 * 
  824. 		 * @param	{String}	is_key
  825. 		 *   The key of the value.
  826. 		 * @param	{*}			im_defaultValue
  827. 		 *   The value which is set if the value is not set.
  828. 		 *
  829. 		 * @return	{Promise}
  830. 		 *   A Promise which resolves to the stored value.
  831. 		 */
  832. 		this.getValue = function(is_key, im_defaultValue) {
  833. 			// Put the default value to JSON.
  834. 			var ls_value = JSON.stringify(im_defaultValue);
  835. 			var lo_promise = null;
  836. 	
  837. 			// If the use of GM_getValue is possible, use it.
  838. 			if(_gb_canUseGmStorage) {
  839. 				ls_value = GM_getValue(is_key, ls_value);
  840. 				
  841. 				// If the use of GM.getValue is possible, use it.
  842. 			} else if(_gb_canUseGmStorageNew) {
  843. 				lo_promise = GM.getValue(is_key, ls_value);
  844. 	
  845. 			// Otherwise use the local storage if possible.
  846. 			} else if(_gb_canUseLocalStorage) {
  847. 				var ls_storageValue = go_self.win.localStorage.getItem(this.prefix + is_key);
  848. 	
  849. 				if(ls_storageValue) {
  850. 					ls_value = ls_storageValue;
  851. 				}
  852. 	
  853. 			// Otherwise use cookies.
  854. 			} else {
  855. 				var la_allCookies = document.cookie.split("; ");
  856. 	
  857. 				for(var i = 0; i < la_allCookies.length; i++) {
  858. 					var la_oneCookie = la_allCookies[i].split("=");
  859. 	
  860. 					if(la_oneCookie[0] == escape(this.prefix + is_key)) {
  861. 						ls_value = unescape(la_oneCookie[1]);
  862. 						break;
  863. 					}
  864. 				}
  865. 			}
  866. 			
  867. 			if(lo_promise == null) {
  868. 				lo_promise = Promise.resolve(ls_value);
  869. 			}
  870. 			
  871. 			// Return the value (parsed for the correct return type).
  872. 			return lo_promise.then(function(is_stringifiedValue) { return JSON.parse(is_stringifiedValue); });
  873. 		};
  874. 	
  875. 		/**
  876. 		 * Delete a value specified by a key.
  877. 		 * 
  878. 		 * @instance
  879. 		 * 
  880. 		 * @param	{String}	is_key
  881. 		 *   The key of the value.
  882. 		 * 
  883. 		 * @return	{Promise}
  884. 		 *   A promise which resolves once the value is deleted.
  885. 		 */
  886. 		this.deleteValue = function(is_key) {
  887. 			var ro_promise = null;
  888. 			
  889. 			// If the use of GM_deleteValue is possible, use it.
  890. 			if(_gb_canUseGmStorage) {
  891. 				GM_deleteValue(is_key);
  892. 				
  893. 			// If the use of GM.deleteValue is possible, use it.
  894. 			} else if(_gb_canUseGmStorageNew) {
  895. 				ro_promise = GM.deleteValue(is_key);
  896. 	
  897. 			// Otherwise use the local storage if possible.
  898. 			} else if(_gb_canUseLocalStorage) {
  899. 				go_self.win.localStorage.removeItem(this.prefix + is_key);
  900. 	
  901. 			// Otherwise use cookies.
  902. 			} else {
  903. 				var ls_data	= escape(this.prefix + is_key) + '=';
  904. 				var ls_expire	= 'expires=' + (new Date(2000, 0, 1, 0, 0, 0, 0)).toGMTString();
  905. 				var ls_path	= 'path=/';
  906. 				var ls_domain	= 'domain=' + _gs_cookieDomain;
  907. 	
  908. 				go_self.win.document.cookie = ls_data + ';' + ls_expire + ';' + ls_path + ';' + ls_domain;
  909. 			}
  910. 			
  911. 			if(ro_promise == null) {
  912. 				ro_promise = Promise.resolve();
  913. 			}
  914. 	
  915. 			// Return the promise.
  916. 			return ro_promise;
  917. 		};
  918. 	
  919. 		/**
  920. 		 * Returns an array with the keys of all values stored by the script.
  921. 		 * 
  922. 		 * @instance
  923. 		 * 
  924. 		 * @return	{Promise}
  925. 		 *   A Promise which resolves to the array with all keys.
  926. 		 */
  927. 		this.listValues = function() {
  928. 			// Create an array for the storage of the values keys.
  929. 			var la_key = new Array();
  930. 			var ro_promise = null;
  931. 	
  932. 			// If the use of GM_listValues is possible, use it.
  933. 			if(_gb_canUseGmStorage) {
  934. 				la_key = GM_listValues();
  935. 				
  936. 			// If the use of GM.listValues is possible, use it.
  937. 			} else if(_gb_canUseGmStorageNew) {
  938. 				ro_promise = GM.listValues();
  939. 	
  940. 			// Otherwise use the local storage if possible.
  941. 			} else if(_gb_canUseLocalStorage) {
  942. 				for(var i = 0; i < go_self.win.localStorage.length; i++) {
  943. 					var ls_keyName = go_self.win.localStorage.key(i);
  944. 	
  945. 					if(ls_keyName.indexOf(this.prefix) != -1) {
  946. 						la_key.push(ls_keyName.replace(this.prefix, ''));
  947. 					}
  948. 				}
  949. 	
  950. 			// Otherwise use cookies.
  951. 			} else {
  952. 				var la_allCookies = document.cookie.split("; ");
  953. 	
  954. 				for(var i = 0; i < la_allCookies.length; i++) {
  955. 					var ls_keyName = unescape(la_allCookies[i].split("=")[0]);
  956. 	
  957. 					if(ls_keyName.indexOf(this.prefix) != -1) {
  958. 						la_key.push(ls_keyName.replace(this.prefix, ''));
  959. 					}
  960. 				}
  961. 			}
  962.  
  963. 			if(ro_promise == null) {
  964. 				ro_promise = Promise.resolve(la_key);
  965. 			}
  966. 	
  967. 			// Return the promise.
  968. 			return ro_promise;
  969. 		};
  970. 	
  971. 		/**
  972. 		 * Adds a style element to the head of the page and return it.
  973. 		 * 
  974. 		 * @instance
  975. 		 * 
  976. 		 * @param	{String}	is_styleRules
  977. 		 *   The style rules to be set.
  978. 		 * @param	{?String}	[is_id=stylesheet not stored]
  979. 		 *   An id for the style set, to have the possibility to delete it.
  980. 		 * @param	{?boolean}	[ib_overwrite=false]
  981. 		 *   If a style with id should overwrite an existing style.
  982. 		 *
  983. 		 * @return	{boolean}
  984. 		 *    If the stylesheet was stored with the id.
  985. 		 */
  986. 		this.addStyle = function(is_styleRules, is_id, ib_overwrite) {
  987. 			var rb_storedWithId = false;
  988. 	
  989. 			if(ib_overwrite && ib_overwrite == true)
  990. 				this.removeStyle(is_id);
  991. 	
  992. 			if(!is_id || (is_id && !_go_styleSheets[is_id])) {
  993. 				var le_style = this.addElement('style', document.head, { 'type': 'text/css', 'innerHTML': is_styleRules });
  994. 	
  995. 				if(is_id) {
  996. 					_go_styleSheets[is_id] = le_style;
  997. 					rb_storedWithId = true;
  998. 				}
  999. 			}
  1000. 	
  1001. 			return rb_storedWithId;
  1002. 		};
  1003. 	
  1004. 		/**
  1005. 		 * Removes a style element set by the script.
  1006. 		 * 
  1007. 		 * @instance
  1008. 		 * 
  1009. 		 * @param	{String}	is_id
  1010. 		 *   The id of the stylesheet to delete.
  1011. 		 *
  1012. 		 * @return	{boolean}
  1013. 		 *    If the stylesheet could be deleted.
  1014. 		 */
  1015. 		this.removeStyle = function(is_id) {
  1016. 			var rb_removed = false;
  1017. 	
  1018. 			if(is_id && _go_styleSheets[is_id]) {
  1019. 				document.head.removeChild(_go_styleSheets[is_id]);
  1020. 	
  1021. 				delete	_go_styleSheets[is_id];
  1022. 	
  1023. 				rb_removed = true;
  1024. 			}
  1025. 	
  1026. 			return rb_removed;
  1027. 		};
  1028. 		
  1029. 		/**
  1030. 		 * Makes a cross-site XMLHttpRequest.
  1031. 		 * 
  1032. 		 * @instance
  1033. 		 * 
  1034. 		 * @param	{Object}	io_args
  1035. 		 *   The arguments the request needs. (specified here: {@link http://wiki.greasespot.net/GM_xmlhttpRequest GM_xmlhttpRequest})
  1036. 		 * 
  1037. 		 * @return	{Promise}
  1038. 		 *   A Promise which resolves to the response text (in case of an synchronous request) or a boolean false / JSON string indicating an error.
  1039. 		 */
  1040. 		this.xhr = function(io_args) {
  1041. 			var ro_promise;
  1042. 			
  1043. 			// Whether the link fetches json data
  1044. 			var lb_isJSON = (io_args.url.search(/\.json$/i) != -1);
  1045. 	
  1046. 			// Check if all required data is given.
  1047. 			if(!io_args.method || !io_args.url || !io_args.onload) {
  1048. 				ro_promise = Promise.resolve(false);
  1049. 	
  1050. 			// If the use of GM_xmlhttpRequest is possible, use it.
  1051. 			} else if(_gb_canUseGmXhr) {
  1052. 				var lm_response = GM_xmlhttpRequest(io_args);
  1053. 				ro_promise = Promise.resolve(lm_response.responseText);
  1054. 				
  1055. 			// If the use of GM.xmlHttpRequest is possible, use it.
  1056. 			} else if(_gb_canUseGmXhrNew) {
  1057. 				/*
  1058. 				 * GM 4.0 does not return a promise for the GM.xmlHttpRequest => synchronous requests will fail, asynchronous requests don't care at all.
  1059. 				 */
  1060. 				ro_promise = new Promise(function(resolve, reject) {
  1061. 					var lb_synchronous = !!io_args.synchronous;
  1062. 					delete io_args.synchronous;
  1063. 					
  1064. 					var lf_originalOnload = io_args.onload;
  1065. 					io_args.onload = function(im_result) {
  1066. 						// In the synchronous call case: resolve in callback.
  1067. 						if(lb_synchronous === true) {
  1068. 							resolve(im_result);
  1069. 						} else {
  1070. 							lf_originalOnload(im_result);
  1071. 						}
  1072. 					};
  1073.  
  1074. 					var lo_responseObject = GM.xmlHttpRequest(io_args);
  1075. 					
  1076. 					// In the asynchronous call case: resolve directly.
  1077. 					if(lb_synchronous === false) {
  1078. 						resolve(lo_responseObject);
  1079. 					}
  1080. 				}).then(function(io_response) {
  1081. 					return io_response && io_response.responseText ? io_response.responseText : '';
  1082. 				});
  1083. 				
  1084.  
  1085. 			// Otherwise show a hint for the missing possibility to fetch the data.
  1086. 			} else {
  1087. 				// Otherwise if it is JSON.
  1088. 				if(lb_isJSON) {
  1089. 					io_args.onload('{ "is_error": true }');
  1090. 					ro_promise = Promise.resolve('{ "is_error": true }');
  1091. 	
  1092. 				// Otherwise.
  1093. 				} else {
  1094. 					ro_promise = Promise.resolve(false);
  1095. 				}
  1096. 			}
  1097. 	
  1098. 			// Return the responseText.
  1099. 			return ro_promise;
  1100. 		};
  1101. 		
  1102. 		/**
  1103. 		 * Returns the content of a resource parsed with JSON.parse.
  1104. 		 * 
  1105. 		 * @instance
  1106. 		 * 
  1107. 		 * @param	{String}	is_name
  1108. 		 *   The name of the resource to parse.
  1109. 		 * @param	{String}	is_xhrUrl
  1110. 		 *   The resource to fetch the resource file from if the use of <code>GM_getResourceText</code> is not possible.
  1111. 		 *   
  1112. 		 * @return	{Object}
  1113. 		 *   A Promise which resolves to the parsed resource.
  1114. 		 */
  1115. 		this.getResourceParsed = function(is_name, is_xhrUrl) {
  1116. 			var lo_promise;
  1117. 	
  1118. 			// Function for safer parsing.
  1119. 			var lf_safeParse = function(is_key, im_value) {
  1120. 				// If the value is a function, return just the string, so it is not executable.
  1121. 				if(typeof im_value === 'function' || Object.prototype.toString.apply(im_value) === '[object function]') {
  1122. 					return im_value.toString();
  1123. 				}
  1124.  
  1125. 				return im_value;
  1126. 			};
  1127. 	
  1128. 			// If the use of the default GM_getRessourceText is possible, use it.
  1129. 			if(_gb_canUseGmRessource) {
  1130. 				lo_promise = Promise.resolve(GM_getResourceText(is_name));
  1131. 	
  1132. 			// Otherwise perform a xmlHttpRequest (and cache the response).
  1133. 			} else {
  1134. 				var ls_key = 'core_cachedResource_' + is_name;
  1135. 				lo_promise = go_self.myGM.getValue(ls_key, null).then(function(io_cached) {
  1136. 					if(io_cached && io_cached.forScriptVersion == go_script.version) {
  1137. 						return io_cached.resourceContent;
  1138. 					}
  1139. 					
  1140. 					return go_self.myGM.xhr({
  1141. 						method:			'GET',
  1142. 						url:			is_xhrUrl,
  1143. 						headers:		{ 'User-agent': navigator.userAgent, 'Accept': 'text/html' },
  1144. 						synchronous:	true,
  1145. 						onload:			function(im_response) { return false; }
  1146. 					}).then(function(is_responseText) {
  1147. 						// Cache the response.
  1148. 						go_self.myGM.setValue(ls_key, {
  1149. 							forScriptVersion:	go_script.version,
  1150. 							resourceContent:	is_responseText,
  1151. 						});
  1152. 						return is_responseText;
  1153. 					});
  1154. 				});
  1155. 			}
  1156. 	
  1157. 			return lo_promise.then(function(is_responseText) { return JSON.parse(is_responseText, lf_safeParse); });
  1158. 		};
  1159. 		
  1160. 		/**
  1161. 		 * Gets the first matching child element by a (css) query and returns it.
  1162. 		 * 
  1163. 		 * @instance
  1164. 		 * 
  1165. 		 * @param	{String}	is_query
  1166. 		 *   The query for the element.
  1167. 		 * @param	{?Element}	[ie_parent=document]
  1168. 		 *   The parent element.
  1169. 		 *
  1170. 		 * @return	{Element}
  1171. 		 *   The element.
  1172. 		 */
  1173. 		this.$ = function(is_query, ie_parent) {
  1174. 			return this.$$(is_query, ie_parent)[0];
  1175. 		};
  1176. 	
  1177. 		/**
  1178. 		 * Gets all matching child elements by a (css) query and returns them.
  1179. 		 * 
  1180. 		 * @instance
  1181. 		 * 
  1182. 		 * @param	{String}	is_query
  1183. 		 *   The query for the elements.
  1184. 		 * @param	{?Element}	[ie_parent=document]
  1185. 		 *   The parent element.
  1186. 		 *
  1187. 		 * @return	{Array.<Element>}
  1188. 		 *   The elements.
  1189. 		 */
  1190. 		this.$$ = function(is_query, ie_parent) {
  1191. 			var le_parent = ie_parent || document;
  1192. 			
  1193. 			// Return the elements as array, not as element list.
  1194. 			return Array.prototype.slice.call(le_parent.querySelectorAll(is_query));
  1195. 		};
  1196. 		
  1197. 		/**
  1198. 		 * Returns the value of the selected option of a select field.
  1199. 		 *
  1200. 		 * @param	{String}	is_id
  1201. 		 *   The last part of the id of the element.
  1202. 		 * @param	{?boolean}	[ib_hasNoPrefix=false]
  1203. 		 *   If the id has no prefix.
  1204. 		 * @param	{?boolean}	[ib_addNoSelect=false]
  1205. 		 *   If there should be no "Select" at the end of the id.
  1206. 		 *
  1207. 		 * @return	{String}
  1208. 		 *   The value.
  1209. 		 */
  1210. 		this.getSelectValue = function(is_id, ib_hasNoPrefix, ib_addNoSelect) {
  1211. 			var le_select = this.$('#' + (ib_hasNoPrefix ? '' : this.prefix) + is_id + (ib_addNoSelect ? '' : 'Select'));
  1212. 	
  1213. 			return le_select.options[le_select.selectedIndex].value;
  1214. 		};
  1215. 		
  1216. 		/**
  1217. 		 * Returns the value of the selected radio button of a radio button group.
  1218. 		 *
  1219. 		 * @param	{String}	is_name
  1220. 		 *   The last part of the name of the element.
  1221. 		 * @param	{?boolean}	[ib_hasNoPrefix=false]
  1222. 		 *   If the name has no prefix.
  1223. 		 *
  1224. 		 * @return	{String}
  1225. 		 *   The value.
  1226. 		 */
  1227. 		this.getRadioValue = function(is_name, ib_hasNoPrefix) {
  1228. 			var le_radios	= this.$$('input[name="' + (ib_hasNoPrefix ? '' : this.prefix) + is_name + '"]');
  1229. 			var rs_value	= '';
  1230. 			
  1231. 			for(var i = 0; i < le_radios.length; i++) {
  1232. 				if(le_radios[i].checked) {
  1233. 					rs_value = le_radios[i].value;
  1234. 					break;
  1235. 				}
  1236. 			}
  1237. 			
  1238. 			return rs_value;
  1239. 		};
  1240. 		
  1241. 		/**
  1242. 		 * Creates a new element and adds it to a parent.
  1243. 		 * 
  1244. 		 * @instance
  1245. 		 * 
  1246. 		 * @param	{String}				is_type
  1247. 		 *   The type of the new element.
  1248. 		 * @param	{Element}				ie_parent
  1249. 		 *   The parent of the new element.
  1250. 		 * @param	{?IkariamCore~myGM~NewElementOptions}	[io_options]
  1251. 		 *   Options for the new element like id, class(es), style, type etc.
  1252. 		 * @param	{?(boolean|IkariamCore~myGM~HasPrefix)}	[im_hasPrefix={id: true, classes: false}]
  1253. 		 *   If a prefix should be used.
  1254. 		 * @param	{?Element}				[ie_nextSibling=end of parent]
  1255. 		 *   The next sibling of the element.
  1256. 		 *
  1257. 		 * @return	{Element}
  1258. 		 *   The new element.
  1259. 		 */
  1260. 		this.addElement = function(is_type, ie_parent, io_options, im_hasPrefix, ie_nextSibling) {
  1261. 			var re_newElement = document.createElement(is_type);
  1262. 			
  1263. 			if(!!io_options === true) {
  1264. 				this.forEach(io_options, function(is_key, im_property) {
  1265. 					var ls_prefix = '';
  1266. 					
  1267. 					if('id' === is_key && !(im_hasPrefix === false || (im_hasPrefix && im_hasPrefix.id === false))) {
  1268. 						ls_prefix = go_self.myGM.prefix;
  1269. 					}
  1270. 					
  1271. 					if('class' === is_key) {
  1272. 						if(im_hasPrefix === true || (im_hasPrefix && im_hasPrefix.classes === true))
  1273. 							ls_prefix = go_self.myGM.prefix;
  1274. 						
  1275. 						if(im_property !== '')
  1276. 							re_newElement.classList.add(ls_prefix + im_property);
  1277. 						
  1278. 						return;
  1279. 					}
  1280. 					
  1281. 					if('classes' === is_key) {
  1282. 						if(im_hasPrefix === true || (im_hasPrefix && im_hasPrefix.classes === true))
  1283. 							ls_prefix = go_self.myGM.prefix;
  1284. 						
  1285. 						for(var i = 0; i < im_property.length; i++) {
  1286. 							if(im_property[i] != '')
  1287. 								re_newElement.classList.add(ls_prefix + im_property[i]);
  1288. 						}
  1289. 						
  1290. 						return;
  1291. 					}
  1292. 					
  1293. 					if('style' === is_key) {
  1294. 						for(var i = 0; i < im_property.length; i++) {
  1295. 							re_newElement.style[im_property[i][0]] = im_property[i][1];
  1296. 						}
  1297. 						
  1298. 						return;
  1299. 					}
  1300. 					
  1301. 					if('click' === is_key || 'focus' === is_key) {
  1302. 						re_newElement.addEventListener(is_key, im_property, false);
  1303. 						
  1304. 						return;
  1305. 					}
  1306. 					
  1307. 					if('innerHTML' === is_key) {
  1308. 						re_newElement[is_key] = im_property;
  1309. 						
  1310. 						return;
  1311. 					}
  1312. 					
  1313. 					re_newElement.setAttribute(is_key, ls_prefix + im_property);
  1314. 				});
  1315. 			}
  1316. 	
  1317. 			ie_parent.insertBefore(re_newElement, ie_nextSibling);
  1318. 	
  1319. 			return re_newElement;
  1320. 		};
  1321. 		
  1322. 		/**
  1323. 		 * Removes an element from its parent.
  1324. 		 * 
  1325. 		 * @instance
  1326. 		 * 
  1327. 		 * @param	{(Element|Array.<Element>)}	im_toRemove
  1328. 		 *   The element to remove.
  1329. 		 */
  1330. 		this.removeElement = function(im_toRemove) {
  1331. 			if(!!im_toRemove === false)
  1332. 				return;
  1333. 			
  1334. 			var la_toRemove = im_toRemove;
  1335. 			
  1336. 			if(Array.isArray(im_toRemove) === false)
  1337. 				la_toRemove = [im_toRemove];
  1338. 			
  1339. 			for(var i = 0; i < la_toRemove.length; i++) {
  1340. 				la_toRemove[i].parentNode.removeChild(la_toRemove[i]);
  1341. 			}
  1342. 		};
  1343. 		
  1344. 		/**
  1345. 		 * Creates new checkboxes and adds it to a parent.
  1346. 		 * 
  1347. 		 * @instance
  1348. 		 * 
  1349. 		 * @param	{Element}	ie_parent
  1350. 		 *   The parent of the new checkboxes.
  1351. 		 * @param	{Array.<IkariamCore~myGM~NewCheckboxData>}	ia_cbData
  1352. 		 *   The data of the checkboxes.
  1353. 		 */
  1354. 		this.addCheckboxes = function(ie_parent, ia_cbData) {
  1355. 			for(var i = 0; i < ia_cbData.length; i++) {
  1356. 				var le_wrapper = this.addElement('div', ie_parent, { 'class': 'cbWrapper' });
  1357. 				
  1358. 				var ls_label = typeof ia_cbData[i].label == 'string' ? ia_cbData[i].label : go_self.Language.$(ia_cbData[i].label.id);
  1359. 				var la_options = {
  1360. 					'id':		ia_cbData[i]['id'] + 'Cb',
  1361. 					'class':	'checkbox',
  1362. 					'type':		'checkbox',
  1363. 					'title':	ls_label
  1364. 				};
  1365. 				
  1366. 				if(!!ia_cbData[i]['checked'] === true)
  1367. 					la_options['checked'] = 'checked';
  1368. 				
  1369. 				this.addElement('input', le_wrapper, la_options);
  1370. 			}
  1371. 		};
  1372. 		
  1373. 		/**
  1374. 		 * Creates a new radio button group and adds it to a parent table.
  1375. 		 * 
  1376. 		 * @instance
  1377. 		 * 
  1378. 		 * @param	{Element}		ie_parentTable
  1379. 		 *   The parent table of the new select field.
  1380. 		 * @param	{String}		is_name
  1381. 		 *   The last part of the name of the radio button group.
  1382. 		 * @param	{(String|int)}	im_checked
  1383. 		 *   The value of the selected option.
  1384. 		 * @param	{Array.<IkariamCore~myGM~ValueAndLabel>}	ia_options
  1385. 		 *   An array with the names an values of the options.
  1386. 		 * @param	{String}		is_labelText
  1387. 		 *   The text of the select label.
  1388. 		 */
  1389. 		this.addRadios = function(ie_parentTable, is_name, im_checked, ia_options, is_labelText) {
  1390. 			var le_row			= this.addElement('tr', ie_parentTable);
  1391. 			var le_labelCell	= this.addElement('td', le_row, { 'class': 'vertical_top' });
  1392. 			var le_radioCell	= this.addElement('td', le_row, { 'class': 'left' });
  1393. 			
  1394. 			var ls_labelText = typeof is_labelText == 'string' ? is_labelText : go_self.Language.$(is_labelText.id);
  1395. 			this.addElement('span', le_labelCell, { 'innerHTML': ls_labelText });
  1396. 			
  1397. 			for(var i = 0; i < ia_options.length; i++) {
  1398. 				var le_wrapper = this.addElement('div', le_radioCell, { 'class': 'radioWrapper' });
  1399. 				
  1400. 				var ls_optionLabel = typeof ia_options[i].label == 'string' ? ia_options[i].label : go_self.Language.$(ia_options[i].label.id);
  1401. 				this.addElement('input', le_wrapper, {
  1402. 					'class':	'checkbox',
  1403. 					'type':		'radio',
  1404. 					'name':		this.prefix + is_name,
  1405. 					'value':	ia_options[i].value,
  1406. 					'title':	ls_optionLabel,
  1407. 					'checked':	ia_options[i].value == im_checked ? 'checked' : ''
  1408. 				});
  1409. 			}
  1410. 		};
  1411. 		
  1412. 		/**
  1413. 		 * Creates a new select field and adds it to a parent table.
  1414. 		 * 
  1415. 		 * @instance
  1416. 		 * 
  1417. 		 * @param	{Element}		ie_parentTable
  1418. 		 *   The parent table of the new select field.
  1419. 		 * @param	{String}		is_id
  1420. 		 *   The last part of the id of the select field.
  1421. 		 * @param	{(String|int)}	im_selected
  1422. 		 *   The value of the selected option.
  1423. 		 * @param	{Array.<IkariamCore~myGM~ValueAndLabel>}	ia_options
  1424. 		 *   An array with the names an values of the options.
  1425. 		 * @param	{String}		is_labelText
  1426. 		 *   The text of the select label.
  1427. 		 */
  1428. 		this.addSelect = function(ie_parentTable, is_id, im_selected, ia_options, is_labelText) {
  1429. 			var le_row			= this.addElement('tr', ie_parentTable);
  1430. 			var le_labelCell	= this.addElement('td', le_row);
  1431. 			var le_selectCell	= this.addElement('td', le_row, { 'class': 'left' });
  1432. 			
  1433. 			var ls_labelText = typeof is_labelText == 'string' ? is_labelText : go_self.Language.$(is_labelText.id);
  1434. 			this.addElement('span', le_labelCell, { 'innerHTML': ls_labelText });
  1435. 			
  1436. 			var le_wrapper = this.addElement('div', le_selectCell, {
  1437. 				'id':		is_id + 'SelectContainer',
  1438. 				'classes':	['select_container', 'size175'],
  1439. 				'style':	[['position', 'relative']]
  1440. 			});
  1441. 			var le_select = this.addElement('select', le_wrapper, { 'id': is_id + 'Select', 'class': 'dropdown' });
  1442. 			
  1443. 			for(var i = 0; i < ia_options.length; i++) {
  1444. 				var ls_optionLabel = typeof ia_options[i].label == 'string' ? ia_options[i].label : go_self.Language.$(ia_options[i].label.id);
  1445. 				var le_option = this.addElement('option', le_select, { 'value': ia_options[i].value, 'innerHTML': ls_optionLabel });
  1446. 				
  1447. 				if(le_option.value == im_selected) {
  1448. 					le_option.selected = 'selected';
  1449. 				}
  1450. 			}
  1451. 		};
  1452. 	
  1453. 		/**
  1454. 		 * Creates a button and adds it to a parent.
  1455. 		 * 
  1456. 		 * @instance
  1457. 		 * 
  1458. 		 * @param	{Element}	ie_parent
  1459. 		 *   The parent element.
  1460. 		 * @param	{String}	is_value
  1461. 		 *   The value of the button.
  1462. 		 * @param	{function}	if_callback
  1463. 		 *   A callback which should be called when the user clicks on the button.
  1464. 		 * @param	{boolean}	[ib_parentIsWrapper=false]
  1465. 		 *   If the element provided as parent is also the button wrapper.
  1466. 		 */
  1467. 		this.addButton = function(ie_parent, is_value, if_callback, ib_parentIsWrapper) {
  1468. 			var le_buttonWrapper = ie_parent;
  1469. 			
  1470. 			if(ib_parentIsWrapper !== true)
  1471. 				le_buttonWrapper = this.addElement('div', ie_parent, { 'class': 'centerButton' });
  1472.  
  1473. 			var ls_value = typeof is_value == 'string' ? is_value : go_self.Language.$(is_value.id);
  1474. 			var re_button = this.addElement('input', le_buttonWrapper, {
  1475. 				'class':	'button',
  1476. 				'type':		'button',
  1477. 				'value':	ls_value,
  1478. 				'click':	if_callback
  1479. 			});
  1480. 			
  1481. 			return re_button;
  1482. 		};
  1483. 		
  1484. 		/**
  1485. 		 * Shows a notification to the user. You can either create a notification field or an input / output field. If the
  1486. 		 * field should be an input field, the field is given to the callbacks as parameter. The abort button is only shown
  1487. 		 * if the abort callback is set. It is also possible to have two body parts or just one body part. This functionality
  1488. 		 * is set by the notification text.
  1489. 		 * 
  1490. 		 * @instance
  1491. 		 * 
  1492. 		 * @param	{IkariamCore~myGM~NotificationText}	im_text
  1493. 		 *   The notification texts.
  1494. 		 * @param	{?IkariamCore~myGM~NotificationCallbacks}	[im_callback]
  1495. 		 *   The callbacks for confirm and abort.
  1496. 		 * @param	{IkariamCore~myGM~NotificationBodyOptions}		[io_options]
  1497. 		 *   Options for the body.
  1498. 		 * 
  1499. 		 * @return	{int}
  1500. 		 *   The notification id.
  1501. 		 */
  1502. 		this.notification = function(im_text, im_callback, io_options) {
  1503. 			_gi_notificationId++;
  1504. 			var lo_options = io_options || {};
  1505. 			
  1506. 			// Set a local notification id to be able to have more than 1 notification panels.
  1507. 			var ri_notificationId = _gi_notificationId;
  1508. 			
  1509. 			// Function to close the notification panel.
  1510. 			var lf_closePanel = function() {
  1511. 				go_self.myGM.removeElement([
  1512. 					go_self.myGM.$('#' + go_self.myGM.prefix + 'notificationBackground' + ri_notificationId),
  1513. 					go_self.myGM.$('#' + go_self.myGM.prefix + 'notificationPanelContainer' + ri_notificationId)
  1514. 				]);
  1515. 			};
  1516. 			
  1517. 			// Create the background and the container.
  1518. 			this.addElement('div', document.body, { 'id': 'notificationBackground' + ri_notificationId, 'class': 'notificationBackground' }, true);
  1519. 			var le_panelContainer	= this.addElement('div', document.body, { 'id': 'notificationPanelContainer' + ri_notificationId, 'class': 'notificationPanelContainer' }, true);
  1520. 			var le_panel			= this.addElement('div', le_panelContainer, { 'id': 'notificationPanel' + ri_notificationId, 'class': 'notificationPanel' }, true);
  1521. 	
  1522. 			// Create the notification panel header.
  1523. 			var ls_headerText = im_text.header ? im_text.header : go_self.Language.$('core.notification.header');
  1524. 			_createNotificationPanelHeader(ri_notificationId, le_panel, ls_headerText, lf_closePanel);
  1525. 			
  1526. 			// Create the notification panel body.
  1527. 			var lo_bodyTexts = {
  1528. 				body:	im_text.body,
  1529. 				top:	im_text.bodyTop ? im_text.bodyTop : '',
  1530. 				bottom:	im_text.bodyBottom ? im_text.bodyBottom : ''
  1531. 			};
  1532. 			var le_body = _createNotificationPanelBody(ri_notificationId, le_panel, lo_options, lo_bodyTexts);
  1533. 			
  1534. 			// Create the notification panel footer.
  1535. 			_createNotificationPanelFooter(ri_notificationId, le_panel);
  1536. 			
  1537. 			// Create the buttons.
  1538. 			var lo_buttonTexts = {
  1539. 				confirm:	im_text.confirm ? im_text.confirm : null,
  1540. 				abort:		im_text.abort ? im_text.abort : null
  1541. 			};
  1542. 			var lo_buttonCallbacks = {
  1543. 				close:		lf_closePanel,
  1544. 				confirm:	im_callback && im_callback.confirm ? im_callback.confirm : null,
  1545. 				abort:		im_callback && im_callback.abort ? im_callback.abort : null
  1546. 			};
  1547. 			_createNotificationPanelButtons(ri_notificationId, le_panel, le_body, lo_buttonTexts, lo_buttonCallbacks);
  1548. 			
  1549. 			return ri_notificationId;
  1550. 		};
  1551. 		
  1552. 		/**
  1553. 		 * Toogle the show / hide Button image and title.
  1554. 		 * 
  1555. 		 * @instance
  1556. 		 * 
  1557. 		 * @param  {Element}	ie_button
  1558. 		 *   The button to toggle.
  1559. 		 */
  1560. 		this.toggleShowHideButton = function(ie_button) {
  1561. 			ie_button.classList.toggle('minimizeImg');
  1562. 			ie_button.classList.toggle('maximizeImg');
  1563. 			
  1564. 			ie_button.title = (ie_button.title == go_self.Language.$('general.fold')) ? go_self.Language.$('general.expand') : go_self.Language.$('general.fold');
  1565. 		};
  1566. 		
  1567. 		/**
  1568. 		 * Runs a callback on every property of an object which is not in the prototype.
  1569. 		 * 
  1570. 		 * @instance
  1571. 		 * 
  1572. 		 * @param	{Object}	io_object
  1573. 		 *   The Object where forEach should be used.
  1574. 		 * @param	{IkariamCore~myGM~ForEachCallback}	if_callback
  1575. 		 *   The callback which should be called.
  1576. 		 */
  1577. 		this.forEach = function(io_object, if_callback) {
  1578. 			for(var ls_key in io_object) {
  1579. 				if(Object.prototype.hasOwnProperty.call(io_object, ls_key)) {
  1580. 					if_callback(ls_key, io_object[ls_key]);
  1581. 				}
  1582. 			}
  1583. 		};
  1584. 		
  1585. 		/**
  1586. 		 * Merges objects.
  1587. 		 * 
  1588. 		 * @instance
  1589. 		 * 
  1590. 		 * @param	{...Object}	arguments
  1591. 		 *   All objects to merge into each other.
  1592. 		 * 
  1593. 		 * @return	{Object}
  1594. 		 *   The merged object.
  1595. 		 */
  1596. 		this.merge = function() {
  1597. 			var ro_merged = {};
  1598. 			
  1599. 			for(var i = 0; i < arguments.length; i++) {
  1600. 				go_self.myGM.forEach(arguments[i], function(is_key, im_value) {
  1601. 					if(typeof ro_merged[is_key] === 'object' && typeof im_value === 'object')
  1602. 						go_self.myGM.merge(ro_merged[is_key], im_value);
  1603. 					else
  1604. 						ro_merged[is_key] = im_value;
  1605. 				});
  1606. 			}
  1607. 			
  1608. 			return ro_merged;
  1609. 		};
  1610. 		
  1611. 		/*--------------------*
  1612. 		 * Set some settings. *
  1613. 		 *--------------------*/
  1614. 		
  1615. 		// Set the notification style.
  1616. 		this.addStyle(
  1617. 				"." + this.prefix + "notificationBackground					{ z-index: 1000000000000; position: fixed; visibility: visible; top: 0px; left: 0px; width: 100%; height: 100%; padding: 0; background-color: #000; opacity: .7; } \
  1618. 				 ." + this.prefix + "notificationPanelContainer				{ z-index: 1000000000001; position: fixed; visibility: visible; top: 100px; left: 50%; width: 500px; height: 370px; margin-left: -250px; padding: 0; text-align: left; color: #542C0F; font: 12px Arial,Helvetica,sans-serif; } \
  1619. 				 ." + this.prefix + "notificationPanel						{ position: relative; top: 0px; left: 0px; background-color: transparent; border: 0 none; overflow: hidden; } \
  1620. 				 ." + this.prefix + "notificationPanelHeader				{ height: 39px; background: none repeat scroll 0 0 transparent; font-weight: bold; line-height: 2; white-space: nowrap; } \
  1621. 				 ." + this.prefix + "notificationPanelHeaderL				{ height: 39px; background-image: url('skin/layout/notes_top_left.png'); background-position: left top; background-repeat: no-repeat; } \
  1622. 				 ." + this.prefix + "notificationPanelHeaderR				{ height: 39px; background-image: url('skin/layout/notes_top_right.png'); background-position: right top; background-repeat: no-repeat; } \
  1623. 				 ." + this.prefix + "notificationPanelHeaderM				{ height: 39px; margin: 0 14px 0 38px; padding: 12px 0 0; background-image: url('skin/layout/notes_top.png'); background-position: left top; background-repeat: repeat-x; color: #811709; line-height: 1.34em; } \
  1624. 				 ." + this.prefix + "notificationPanelBody					{ max-height: 311px; height: 100%; background: none repeat scroll 0 0 transparent; } \
  1625. 				 ." + this.prefix + "notificationPanelBodyL					{ height: 100%; background-image: url('skin/layout/notes_left.png'); background-position: left top; background-repeat: repeat-y; } \
  1626. 				 ." + this.prefix + "notificationPanelBodyR					{ height: 100%; background-image: url('skin/layout/notes_right.png'); background-position: right top; background-repeat: repeat-y; } \
  1627. 				 ." + this.prefix + "notificationPanelBodyM					{ height: 100%; background-color: #F7E7C5; background-image: none;  margin: 0 6px; padding: 0 10px; font-size: 14px; } \
  1628. 				 ." + this.prefix + "notificationPanelBodyMTop				{ max-height: 100px; line-height: 2; } \
  1629. 				 ." + this.prefix + "notificationPanelBodyMTop b			{ line-height: 3.5; font-size:110%; } \
  1630. 				 ." + this.prefix + "notificationPanelBodyM a				{ color: #811709; font-weight: bold; } \
  1631. 				 ." + this.prefix + "notificationPanelBodyM h2				{ font-weight: bold; } \
  1632. 				 ." + this.prefix + "notificationPanelBodyMContent			{ max-height: 270px; padding: 10px; background-color: #FFF7E1; border: 1px dotted #C0C0C0; font: 14px Arial,Helvetica,sans-serif; color: #000000; border-collapse: separate; overflow-y:auto; } \
  1633. 				 ." + this.prefix + "notificationPanelBodyMBottom			{ max-height: 170px; padding: 10px; background-color: #FFF7E1; border: 1px dotted #C0C0C0; font: 14px Arial,Helvetica,sans-serif; color: #000000; border-collapse: separate; overflow-y:auto; } \
  1634. 				 textarea." + this.prefix + "notificationPanelBodyMContent	{ height: 270px; width: 445px; resize: none; } \
  1635. 				 textarea." + this.prefix + "notificationPanelBodyMBottom	{ height: 170px; width: 445px; resize: none; } \
  1636. 				 ." + this.prefix + "notificationPanelBodyPlaceholder		{ height: 20px; } \
  1637. 				 ." + this.prefix + "notificationPanelFooter				{ height: 20px; background: none repeat scroll 0 0 transparent; } \
  1638. 				 ." + this.prefix + "notificationPanelFooterL				{ height: 100%; background-image: url('skin/layout/notes_left.png'); background-position: left top; background-repeat: repeat-y; border: 0 none; } \
  1639. 				 ." + this.prefix + "notificationPanelFooterR				{ height: 21px; background-image: url('skin/layout/notes_br.png'); background-position: right bottom; background-repeat: no-repeat; } \
  1640. 				 ." + this.prefix + "notificationPanelFooterM				{ background-color: #F7E7C5; border-bottom: 3px solid #D2A860; border-left: 2px solid #D2A860; margin: 0 23px 0 3px; padding: 3px 0 2px 3px; font-size: 77%; } \
  1641. 				 ." + this.prefix + "notificationPanelClose					{ cursor: pointer; position: absolute; top: 12px; right: 8px; width: 17px; height: 17px; background-image: url('skin/layout/notes_close.png'); } \
  1642. 				 ." + this.prefix + "notificationPanelButtonWrapper			{ bottom: -4px; position: absolute; margin: 10px auto; width: 100%; text-align: center; } \
  1643. 				 ." + this.prefix + "notificationPanelButton				{ background: url('skin/input/button.png') repeat-x scroll 0 0 #ECCF8E; border-color: #C9A584 #5D4C2F #5D4C2F #C9A584; border-style: double; border-width: 3px; cursor: pointer; display: inline; font-weight: bold; margin: 0px 5px; padding: 2px 10px; text-align: center; font-size: 12px; width: 100px; } \
  1644. 				 ." + this.prefix + "notificationPanelButton:hover			{ color: #B3713F; } \
  1645. 				 ." + this.prefix + "notificationPanelButton:active			{ border-color: #5D4C2F #C9A584 #C9A584 #5D4C2F; border-style: double; border-width: 3px; padding: 3px 10px 1px; } \
  1646. 				 ." + this.prefix + "notificationPanelButtonConfirm			{  } \
  1647. 				 ." + this.prefix + "notificationPanelButtonAbort			{  }",
  1648. 				'notification', true
  1649. 			);
  1650. 		
  1651. 		// Add the buttons for toggle buttons used styles.
  1652. 		this.addStyle(
  1653. 				".minimizeImg, .maximizeImg		{ background: url('skin/interface/window_control_sprite.png') no-repeat scroll 0 0 transparent; cursor: pointer; display: block; height: 18px; width: 18px; } \
  1654. 				 .minimizeImg					{ background-position: -144px 0; } \
  1655. 				 .minimizeImg:hover				{ background-position: -144px -19px; } \
  1656. 				 .maximizeImg					{ background-position: -126px 0; } \
  1657. 				 .maximizeImg:hover				{ background-position: -126px -19px; }",
  1658. 				'toggleShowHideButton', true
  1659. 			);
  1660. 		
  1661. 		// Fixe the tab scroll to prevent the scroll left / right button to have a widht more than 40px.
  1662. 		this.addStyle(
  1663. 				"#container .tabmenu .tab													{ width: unset; } \
  1664. 				 #container .tabmenu .tab.tabPrevPage, #container .tabmenu .tab.tabNextPage	{ width: 40px; }",
  1665. 				'fixTabScroll', true
  1666. 			);
  1667. 		
  1668. 		/*---------------------------------------------------------------------*
  1669. 		 * Types for documentation purposes (e.g. callback functions, objects) *
  1670. 		 *---------------------------------------------------------------------*/
  1671. 		
  1672. 		/**
  1673. 		 * Confirm / abort callback for a notification with an input text field.
  1674. 		 * 
  1675. 		 * @callback	IkariamCore~myGM~ConfirmAbortWithInput
  1676. 		 * 
  1677. 		 * @param	{Element}	textarea
  1678. 		 *   The textarea element which contains the user input.
  1679. 		 */
  1680. 		
  1681. 		/**
  1682. 		 * Confirm / abort callback for a notification without an input text field.
  1683. 		 * 
  1684. 		 * @callback	IkariamCore~myGM~ConfirmAbortWithoutInput
  1685. 		 */
  1686. 		
  1687. 		/**
  1688. 		 * Callbacks to confirm / abort a notification.
  1689. 		 * 
  1690. 		 * @typedef	IkariamCore~myGM~NotificationCallbacks
  1691. 		 * 
  1692. 		 * @property	{?(IkariamCore~myGM~ConfirmAbortWithInput|IkariamCore~myGM~ConfirmAbortWithoutInput)}	[confirm=close panel]	- The callback for the confirm button.
  1693. 		 * @property	{?(IkariamCore~myGM~ConfirmAbortWithInput|IkariamCore~myGM~ConfirmAbortWithoutInput)}	[abort=close panel]	- The callback for the abort button.
  1694. 		 */
  1695. 		
  1696. 		/**
  1697. 		 * Callbacks for the buttons of the notification panel.
  1698. 		 * 
  1699. 		 * @typedef	IkariamCore~myGM~NotificationButtonCallbacks
  1700. 		 * 
  1701. 		 * @private
  1702. 		 * @inner
  1703. 		 * 
  1704. 		 * @mixes	IkariamCore~myGM~NotificationCallbacks
  1705. 		 * 
  1706. 		 * @property	{IkariamCore~myGM~ConfirmAbortWithoutInput}		close	- The callback to close the panel.
  1707. 		 */
  1708. 		
  1709. 		/**
  1710. 		 * Options for the notification body.
  1711. 		 * 
  1712. 		 * @typedef	{Object}	IkariamCore~myGM~NotificationBodyOptions
  1713. 		 * 
  1714. 		 * @property	{boolean}	[textarea=false]	- If the body should be a textarea.
  1715. 		 * @property	{boolean}	[readonly=false]	- If the textarea is readonly. Only used if textarea=true.
  1716. 		 * @property	{boolean}	[autofocus=false]	- If the textarea content is autoselected on click. Only used if textarea=true.
  1717. 		 */
  1718. 		
  1719. 		/**
  1720. 		 * Text for the notification body. Either body or top AND bottom must be specified.
  1721. 		 * 
  1722. 		 * @typedef	{Object}	IkariamCore~myGM~NotificationBodyText
  1723. 		 * 
  1724. 		 * @property	{?String}	[body]		- Text if there is only one text in the body.
  1725. 		 * @property	{?String}	[top]		- Upper text if the body is splitted.
  1726. 		 * @property	{?String}	[bottom]	- Lower text if the body is splitted.
  1727. 		 */
  1728. 		
  1729. 		/**
  1730. 		 * Text for the notification panel buttons.
  1731. 		 * 
  1732. 		 * @typedef	{Object}	IkariamCore~myGM~NotificationButtonsText
  1733. 		 * 
  1734. 		 * @property	{?String}	[confirm=core.notification.button.confirm]	- Text for the confirm button.
  1735. 		 * @property	{?String}	[abort=core.notification.button.abort]		- Text for the abort button.
  1736. 		 */
  1737. 		
  1738. 		/**
  1739. 		 * Texts for the notification panel.
  1740. 		 * 
  1741. 		 * @typedef	IkariamCore~myGM~NotificationText
  1742. 		 * 
  1743. 		 * @mixes	IkariamCore~myGM~NotificationBodyText
  1744. 		 * @mixes	IkariamCore~myGM~NotificationButtonsText
  1745. 		 * 
  1746. 		 * @property	{?String}	[header=core.notification.header]	- The notification panel header.
  1747. 		 */
  1748. 		
  1749. 		/**
  1750. 		 * CSS Styles for an element.<br>
  1751. 		 * Structure of the array: <code>[ [ &lt;styleName&gt;, &lt;styleValue&gt; ] ]</code>
  1752. 		 * 
  1753. 		 * @typedef	{Array.<Array.<String>>}	IkariamCore~myGM~CssStyles
  1754. 		 */
  1755. 		
  1756. 		/**
  1757. 		 * Options for a new element.
  1758. 		 * 
  1759. 		 * @typedef	{Object}	IkariamCore~myGM~NewElementOptions
  1760. 		 * 
  1761. 		 * @property	{String}	[id]		- The id of the element.
  1762. 		 * @property	{String}	[class]		- A single class of the element.
  1763. 		 * @property	{String[]}	[classes]	- Multiple classes for the element.
  1764. 		 * @property	{IkariamCore~myGM~CssStyles}	[style]	- Styles for the element.
  1765. 		 * @property	{function}	[click]		- An onclick callback.
  1766. 		 * @property	{function}	[focus]		- An onfocus callback.
  1767. 		 * @property	{String}	[*]			- All other element options.
  1768. 		 */
  1769. 		
  1770. 		/**
  1771. 		 * Define if id and classes should have a prefix.
  1772. 		 * 
  1773. 		 * @typedef	{Object}	IkariamCore~myGM~HasPrefix
  1774. 		 * 
  1775. 		 * @property	{boolean}	[id=true]		- If the id should have a prefix.
  1776. 		 * @property	{boolean}	[classes=false]	- If the classes should have a prefix.
  1777. 		 */
  1778. 		
  1779. 		/**
  1780. 		 * Data for a new checkbox.
  1781. 		 * 
  1782. 		 * @typedef	{Object}	IkariamCore~myGM~NewCheckboxData
  1783. 		 * 
  1784. 		 * @property	{String}	id		- The id of the checkbox.
  1785. 		 * @property	{String}	label	- The label of the checkbox.
  1786. 		 * @property	{boolean}	checked	- If the checkbox is checked.
  1787. 		 */
  1788.  
  1789. 		/**
  1790. 		 * Data set consisting of value and label.
  1791. 		 * 
  1792. 		 * @typedef	{Object}	IkariamCore~myGM~ValueAndLabel
  1793. 		 * 
  1794. 		 * @property	{(String|int)}	value	- The value of the data set.
  1795. 		 * @property	{String}		label	- The label of the data set.
  1796. 		 */
  1797. 		
  1798. 		/**
  1799. 		 * Callback for a forEach iteration on an object.
  1800. 		 * 
  1801. 		 * @callback	IkariamCore~myGM~ForEachCallback
  1802. 		 * 
  1803. 		 * @param	{String}	propertyKey
  1804. 		 *   The key of the property of the object.
  1805. 		 * @param	{*}			propertyValue
  1806. 		 *   The value of the property.
  1807. 		 */
  1808. 	}
  1809. 	
  1810. 	/**
  1811. 	 * myGM for cross-browser compatibility of the GM_* functions. (use myGM.* instead of GM_*)<br>
  1812. 	 * Also there are general used functions stored.
  1813. 	 * 
  1814. 	 * @instance
  1815. 	 * 
  1816. 	 * @type	IkariamCore~myGM
  1817. 	 */
  1818. 	this.myGM = new myGM();
  1819. 	
  1820. 	go_self.con.logTimeStamp('IkariamCore.myGM created');
  1821. 	
  1822. 	/**
  1823. 	 * Instantiate a new set of localization functions.
  1824. 	 * 
  1825. 	 * @inner
  1826. 	 * 
  1827. 	 * @class
  1828. 	 * @classdesc	Functions for localizing the script.
  1829. 	 */
  1830. 	function Language() {
  1831. 		/*--------------------------------------------*
  1832. 		 * Private variables, functions and settings. *
  1833. 		 *--------------------------------------------*/
  1834. 		
  1835. 		/**
  1836. 		 * Whether the Language module was initialized.
  1837. 		 * 
  1838. 		 * @private
  1839. 		 * @inner
  1840. 		 * 
  1841. 		 * @type	boolean
  1842. 		 */
  1843. 		_gb_initialized = false;
  1844. 		
  1845. 		/**
  1846. 		 * Mapping for countries where the used language is the same, but the url is different (e.g. us -> USA and en -> Great Britain)
  1847. 		 * 
  1848. 		 * @private
  1849. 		 * @inner
  1850. 		 * 
  1851. 		 * @type	Object.<String, String>
  1852. 		 */
  1853. 		var _go_codeMapping = {
  1854. 			ar: 'es',
  1855. 			br: 'pt',
  1856. 			mx: 'es',
  1857. 			us: 'en'
  1858. 		};
  1859. 		
  1860. 		/**
  1861. 		 * Default Ikariam language code for this server.
  1862. 		 * 
  1863. 		 * @private
  1864. 		 * @inner
  1865. 		 * 
  1866. 		 * @default	en
  1867. 		 * 
  1868. 		 * @type	String
  1869. 		 */
  1870. 		var _gs_ikaCode = (function() {
  1871. 			var rs_uri = top.location.host.match(/^s[0-9]+-([a-zA-Z]+)\.ikariam\.gameforge\.com$/)[1];
  1872. 			
  1873. 			if(!!_go_codeMapping[rs_uri] === true)
  1874. 				rs_uri = _go_codeMapping[rs_uri];
  1875. 			
  1876. 			if(!rs_uri === true)
  1877. 				rs_uri = 'en';
  1878. 			
  1879. 			return rs_uri;
  1880. 		})();
  1881. 		
  1882. 		/**
  1883. 		 * Default language code - code of language registered as default.
  1884. 		 * 
  1885. 		 * @private
  1886. 		 * @inner
  1887. 		 * 
  1888. 		 * @default	en
  1889. 		 * 
  1890. 		 * @type	String
  1891. 		 */
  1892. 		var _gs_defaultCode = 'en';
  1893. 		
  1894. 		/**
  1895. 		 * Used language code.
  1896. 		 * 
  1897. 		 * @private
  1898. 		 * @inner
  1899. 		 * 
  1900. 		 * @default	en
  1901. 		 * 
  1902. 		 * @type	String
  1903. 		 */
  1904. 		var _gs_usedCode = _gs_defaultCode;
  1905. 		
  1906. 		/**
  1907. 		 * Used language texts. Used if a translation is requested.
  1908. 		 * 
  1909. 		 * @private
  1910. 		 * @inner
  1911. 		 * 
  1912. 		 * @type	json
  1913. 		 */
  1914. 		var _go_usedText = {};
  1915. 		
  1916. 		/**
  1917. 		 * Default language text. To be used if the used language is not available.
  1918. 		 * 
  1919. 		 * @private
  1920. 		 * @inner
  1921. 		 * 
  1922. 		 * @type	json
  1923. 		 */
  1924. 		var _go_defaultText = {};
  1925. 		
  1926. 		/**
  1927. 		 * All languages which are registered with their storage type (resource, in-script-object).
  1928. 		 * 
  1929. 		 * @private
  1930. 		 * @inner
  1931. 		 * 
  1932. 		 * @type	Object.<String, Array.<IkariamCore~Language~LanguageSettings>>
  1933. 		 */
  1934. 		var _go_registeredLangs = {};
  1935. 		
  1936. 		/**
  1937. 		 * "Translation" of all possible language codes to the corresponding language.
  1938. 		 * 
  1939. 		 * @TODO	Translate when required!
  1940. 		 * 
  1941. 		 * @private
  1942. 		 * @inner
  1943. 		 * 
  1944. 		 * @type	Object.<String, String>
  1945. 		 */
  1946. 		var _go_codeTranslation = {
  1947. 			ae: 'Arabic',		// ... Arabic
  1948. 			bg: 'Bulgarian',	// ... Bulgarian
  1949. 			cz: 'Czech',		// ... Czech
  1950. 			de: 'Deutsch',		// German
  1951. 			dk: 'Danish',		// ... Danish
  1952. 			en: 'English',		// English
  1953. 			es: 'Español',		// Spanish
  1954. 			fi: 'Finish',		// ... Finish
  1955. 			fr: 'Français',		// French
  1956. 			gr: 'Ελληνικά',		// Greek
  1957. 			hu: 'Hungarian',	// ... Hungarian
  1958. 			il: 'Hebrew',		// ... Hebrew
  1959. 			it: 'Italiano',		// Italian
  1960. 			lt: 'Lithuanian',	// ... Lithuanian
  1961. 			lv: 'Latviešu',		// Latvian
  1962. 			nl: 'Nederlands',	// Dutch
  1963. 			no: 'Norwegian',	// ... Norwegian
  1964. 			pl: 'Polski',		// Polish
  1965. 			pt: 'Portugese',	// ... Portugese
  1966. 			ro: 'Romanian',		// ... Romanian
  1967. 			rs: 'Serbian',		// ... Serbian
  1968. 			ru: 'Русский',		// Russian
  1969. 			se: 'Svenska',		// Swedisch
  1970. 			si: 'Slovene',		// ... Slovene
  1971. 			sk: 'Slovak',		// ... Slovak
  1972. 			tr: 'Türkçe',		// Turkish
  1973. 			tw: 'Chinese',		// ... Chinese
  1974. 		};
  1975. 		
  1976. 		/**
  1977. 		 * Initialize the core language files.
  1978. 		 * 
  1979. 		 * @private
  1980. 		 * @inner
  1981. 		 * 
  1982. 		 * @return	{Promise}
  1983. 		 *   A Promise which resolves once the languages are set.
  1984. 		 */
  1985. 		var _initialize = async function() {
  1986. 			var la_language = [
  1987. 				{ code: 'de', settings: {"settings": {"kiloSep":".","decSep":",","ltr":true}}, translations: {"core": {"update": {"notPossible": {"header": "Keine Aktualisierung möglich","text": "Es ist nicht möglich, nach Aktualisierungen für %$1 zu suchen. Bitte prüfe selbst auf Aktualisierungen für das Script. Die Momentan installierte Version ist %$2. Diese Nachricht wird in vier Wochen wieder angezeigt."},"possible": {"header": "Aktualisierung verfügbar","text": "Es ist eine Aktualisierung für %$1 verfügbar.<br>Zur Zeit ist Version %$2 installiert. Die neueste Version ist %$3.","history": "Versionshistorie","noHistory": "Keine Versionshistorie verfügbar.","type": {"feature": "Neuerung(en)","change": "Änderung(en)","bugfix": "Bugfix(e)","language": "Sprache(n)","core": "Ikariam Core","other": "Sonstige"},"button": {"install": "Installieren","hide": "Verbergen"}},"noNewExists": {"header": "Keine Aktualisierung verfügbar","text": "Es ist keine Aktualisierung für %$1 verfügbar. Die neueste Version %$2 ist installiert."}},"notification": {"header": "Informationen","button": {"confirm": "OK","abort": "Abbrechen"}},"optionPanel": {"save": "Einstellungen speichern!","section": {"update": {"title": "Aktualisierungen","label": {"interval": {"description": "In folgenden Zeitabständen nach Aktualisierungen suchen:","option": {"never": "Nie","hour": "1 Stunde","hour12": "12 Stunden","day": "1 Tag","day3": "3 Tage","week": "1 Woche","week2": "2 Wochen","week4": "4 Wochen"}},"notifyLevel": {"description": "Benachrichtige über neue Versionen bis zu diesem Level:","option": {"all": "Alle Versionen","major": "Hauptversionen (x)","minor": "Nebenversionen (x.x)","patch": "Revisionen (x.x.x)"}},"manual": "Nach Aktualisierungen für \"%$1\" suchen!"}},"optionPanelOptions": {"title": "Optionsfenster","label": {"import": "Optionen importieren","export": "Optionen exportieren","reset": "Optionen zurücksetzen","importNotification": {"header": "Importieren","explanation": "Füge das JSON zum importieren in das Feld unten ein und klicke \"OK\". Die Optionen werden dann importiert. Bitte sorge dafür, dass kein Zeichen fehlt, da sonst der Import nicht funktionieren wird."},"exportNotification": {"header": "Exportieren","explanation": "Bitte kopiere das JSON unten. Du kannst es danach auf jedem beliebigen PC importieren, um die Optionen dort zu erhalten. Bitte sorge dafür, dass kein Zeichen fehlt, da sonst der Import nicht funktionieren wird."},"importError": {"header": "Fehler beim importieren!","explanation": "Während dem importieren der Optionen trat ein Fehler auf. Es scheint, dass das JSON fehlerhaft ist. Bitte validiere es (beispielsweise mit <a href=\"http://jsonlint.com/\" target=\"_blank\">JSONLint</a>)."},"resetNotification": {"header": "Optionen zurücksetzen","explanation": "Bist du dir sicher, dass du alle Optionen auf ihren Standardwert zurücksetzen möchtest?"}}}}}},"general": {"successful": "Dein Befehl wurde ausgeführt.","error": "Es gab einen Fehler in deiner Anfrage!","fold": "Einklappen","expand": "Ausklappen","ctrl": "Strg","alt": "Alt","shift": "Umschalt","yes": "Ja","no": "Nein"}} },
  1988. 				{ code: 'gr', settings: {"settings": {"kiloSep":",","decSep":".","ltr":true}}, translations: {"core": {"update": {"notPossible": {"header": "Καμιά διαθέσιμη Ενημέρωση","text": "Δεν είναι δυνατός ο έλεγχος ενημερώσεων για τον κώδικα %$1. Ελέγξτε χειροκίνητα για Ενημερώσεις για τον κώδικα. Η πραγματικά εγκατεστημένη έκδοση είναι η %$2. Αυτό το μήνυμα θα εμφανιστεί ξανά σε 4 εβδομάδες."},"possible": {"header": "Διαθέσιμη Ενημέρωση","text": "Υπάρχει μια διαθέσιμη ενημέρωση για τον κώδικα %$1.<br>Προς το παρόν, υπάρχει εγκατεστημένη η έκδοση %$2. Η νεότερη ΄έκδοση είναι η %$3.","history": "Ιστορικό Έκδοσης","noHistory": "Κανένα ιστορικό έκδοσης διαθέσιμο.","type": {"feature": "Χαρακτηριστικό(ά)","change": "Αλλαγή(ές)","bugfix": "Διόρθωση(εις) σφάλματος(ων)","language": "Γλώσσα(ες)","core": "Πυρήνας Ikariam","other": "Άλλο"},"button": {"install": "Εγκατάσταση","hide": "Απόκρυψη"}},"noNewExists": {"header": "Καμιά διαθέσιμη Ενημέρωση","text": "Δεν υπάρχει καμιά νέα έκδοση διαθέσιμη για τον κώδικα %$1. Η νεότερη έκδοση %$2 είναι εγκατεστημένη."}},"notification": {"header": "Ειδοποίηση κώδικα","button": {"confirm": "Εντάξει","abort": "Παραίτηση"}},"optionPanel": {"save": "Αποθήκευση ρυθμίσεων!","section": {"update": {"title": "Ενημέρωση","label": {"interval": {"description": "Χρόνος επανάληψης για ενημερώσεις:","option": {"never": "Ποτέ","hour": "1 ώρα","hour12": "12 ώρες","day": "1 ημέρα","day3": "3 ημέρες","week": "1 εβδομάδα","week2": "2 εβδομάδες","week4": "4 εβδομάδες"}},"notifyLevel": {"description": "Ειδοποίηση για νέες εκδόσεις μέχρι αυτό το επίπεδο:","option": {"all": "Όλες οι εκδόσεις","major": "Βασική (x)","minor": "Δευτερεύουσα (x.x)","patch": "Διόρθωση (x.x.x)"}},"manual": "Αναζήτηση για ενημερώσεις για «%$1»!"}},"optionPanelOptions": {"title": "Πίνακας Επιλογών","label": {"import": "Εισαγωγή των επιλογών του κώδικα","export": "Εξαγωγή των επιλογών κώδικα","reset": "Επαναφορά των επιλογών κώδικα","importNotification": {"header": "Εισαγωγή","explanation": "Εισάγετε το JSON σας για εισαγωγή στην περιοχή παρακάτω και πατήστε Εντάξει. Οι επιλογές θα εισαχθούν μετά. Σιγουρέψτε ότι κανένας χαρακτήρας δεν λείπει. Διαφορετικά, η εισαγωγή δεν θα λειτουργήσει."},"exportNotification": {"header": "Εξαγωγή","explanation": "Αντιγράψτε το JSON παρακάτω. Μπορείτε να το εισάγετε σε οποιοδήποτε υπολογιστή για να μεταφέρετε τις επιλογές εκεί. Σιγουρέψτε ότι κανένας χαρακτήρας δεν λείπει. Διαφορετικά η εισαγωγή δεν θα λειτουργήσει."},"importError": {"header": "Σφάλμα εισαγωγής!","explanation": "Υπήρξε κάποιο σφάλμα κατά την εισαγωγή των επιλογών. Φαίνεται ότι το JSON είναι κατεστραμένο. Please Επικυρώστε το (π.χ. με το <a href=\"http://jsonlint.com/\" target=\"_blank\">JSONLint</a>)."},"resetNotification": {"header": "Επαναφορά επιλογών","explanation": "Θέλετε, σίγουρα, να επαναφέρετε όλες τις επιλογές του κώδικα στην προεπιλεγμένη τιμή;"}}}}}},"general": {"successful": "Η εντολή σας έχει δρομολογηθεί.","error": "Υπήρξε ένα σφάλμα στο αίτημα σας.","fold": "Δίπλωμα","expand": "Επέκταση","ctrl": "Ctrl","alt": "Alt","shift": "Shift","yes": "Ναι","no": "Όχι"}} },
  1989. 				{ code: 'en', settings: {"settings": {"kiloSep":",","decSep":".","ltr":true}}, translations: {"core": {"update": {"notPossible": {"header":"No Update possible","text":"It is not possible to check for updates for %$1. Please check manually for Updates for the script. The actual installed version is %$2. This message will appear again in four weeks."},"possible": {"header":"Update available","text":"There is an update for %$1 available.<br>At the moment there is version %$2 installed. The newest version is %$3.","history":"Version History","noHistory":"No version history available.","type": {"feature":"Feature(s)","change":"Change(s)","bugfix":"Bugfix(es)","language":"Language(s)","core":"Ikariam Core","other":"Other"},"button": {"install":"Install","hide":"Hide"}},"noNewExists": {"header":"No Update available","text":"There is no new version for %$1 available. The newest version %$2 is installed."}},"notification": {"header":"Script notification","button": {"confirm":"OK","abort":"Abort"}},"optionPanel": {"save":"Save settings!","section": {"update": {"title":"Update","label": {"interval": {"description": "Interval to search for updates:","option": {"never":"Never","hour":"1 hour","hour12":"12 hours","day":"1 day","day3":"3 days","week":"1 week","week2":"2 weeks","week4":"4 weeks"}},"notifyLevel": {"description": "Notify on new script versions up to this level:","option": {"all":"All Versions","major":"Major (x)","minor":"Minor (x.x)","patch":"Patch (x.x.x)"}},"manual":"Search for updates for \"%$1\"!"}},"optionPanelOptions": {"title":"Option Panel","label": {"import":"Import the script options","export":"Export the script options","reset":"Reset the script options","importNotification": {"header":"Import","explanation":"Put your JSON to import in the area below and click OK. The options will be imported then. Please ensure that no character is missing. Otherwise the import will not work."},"exportNotification": {"header":"Export","explanation":"Please copy the JSON below. You can import it on any computer to get the options there. Please ensure that no character is missing. Otherwise the import will not work."},"importError": {"header":"Import error!","explanation":"There was an error while importing the options. It seems that the JSON is broken. Please validate it (e.g. with <a href=\"http://jsonlint.com/\" target=\"_blank\">JSONLint</a>)."},"resetNotification": {"header":"Reset options","explanation":"Are you sure to reset all script options to their default value?"}}}}}},"general": {"successful":"Your order has been carried out.","error":"There was an error in your request.","fold":"Fold","expand":"Expand","ctrl":"Ctrl","alt":"Alt","shift":"Shift","yes":"Yes","no":"No"}} },
  1990. 				{ code: 'fr', settings: {"settings": {"kiloSep":",","decSep":".","ltr":true}}, translations: {"core": {"update": {"notPossible": {"header": "Pas de Mettre de jour possible","text": ""},"possible": {"header": "Update utilisable","text": "","history": "","noHistory": "","type": {"feature": "","change": "","bugfix": "","language": "langue(s)","core": "","other": "autre"},"button": {"install": "","hide": ""}},"noNewExists": {"header": "Pas de Mettre de jour utilisable","text": ""}},"notification": {"header": "","button": {"confirm": "OK","abort": "Abandon"}},"optionPanel": {"save": "","section": {"update": {"title": "Mettre de Jour","label": {"interval": {"description": "","option": {"never": "Jamais","hour": "1 heure","hour12": "12 heures","day": "1 jour","day3": "3 jour","week": "1 semaine","week2": "2 semaines","week4": "4 semaines"}},"notifyLevel": {"description": "","option": {"all": "","major": "","minor": "","patch": ""}},"manual": ""}},"optionPanelOptions": {"title": "","label": {"import": "","export": "","reset": "","importNotification": {"header": "","explanation": ""},"exportNotification": {"header": "","explanation": ""},"importError": {"header": "","explanation": ""},"resetNotification": {"header": "","explanation": ""}}}}}},"general": {"successful": "","error": "","fold": "","expand": "","ctrl": "Ctrl","alt": "Alt","shift": "","yes": "Oui","no": "Non"}} },
  1991. 				{ code: 'it', settings: {"settings": {"kiloSep":",","decSep":".","ltr":true}}, translations: {"core": {"update": {"notPossible": {"header": "niente da aggiornare","text": "Non è possibile verificare la disponibilità di aggiornamenti per %$1. Si prega di controllare manualmente gli aggiornamenti per lo script. La versione attuale installata è %$2. Questo messaggio apparirà di nuovo in quattro settimane."},"possible": {"header": "Aggiornamento disponibile","text": "C'è un aggiornamento per %$1 disponibile. <br> Al momento è la versione %$2 installato. L'ultima versione è %$3.","history": "Cronologia delle versioni","noHistory": "","type": {"feature": "","change": "Cambiamenti","bugfix": "","language": "lingue","core": "Ikariam Core","other": "altri"},"button": {"install": "installare","hide": "nascondere"}},"noNewExists": {"header": "Nessun aggiornamento disponibile","text": "Non ci sono nuova versione disponibile per %$1. La nuova versione %$2 è installato."}},"notification": {"header": "Informazioni degli script","button": {"confirm": "OK","abort": "abortire"}},"optionPanel": {"save": "Salva impostazioni!","section": {"update": {"title": "Aggiornamenti","label": {"interval": {"description": "Intervallo per la ricerca di aggiornamenti:","option": {"never": "mai","hour": "1 ora","hour12": "12 ore","day": "1 giorno","day3": "3 giorni","week": "1 settimana","week2": "2 settimane","week4": "4 settimane"}},"notifyLevel": {"description": "Notifica nuove versioni di script fino a questo livello:","option": {"all": "tutte le versioni","major": "Versione principale (x)","minor": "Versioni minori (x.x)","patch": ""}},"manual": "Cerca aggiornamenti per \"%$1\"!"}},"optionPanelOptions": {"title": "Finestra delle opzioni","label": {"import": "Importare le opzioni di script","export": "le opzioni di esportazione degli script","reset": "Aggiorna le opzioni di script","importNotification": {"header": "importazione","explanation": "Metti il JSON importare nella zona sotto e fare clic su OK. Le opzioni saranno importati poi. Fate attenzione che non manca di carattere. In caso contrario, l'importazione non funziona."},"exportNotification": {"header": "esportazione","explanation": "Si prega di copiare il JSON sotto. È possibile importare su qualsiasi computer per ottenere le opzioni lì. Assicurarsi fatto nessun personaggio manca. In caso contrario, l'importazione non funziona."},"importError": {"header": "","explanation": "Si è verificato un errore durante l'importazione delle opzioni. Sembra che il JSON è rotto. Si prega di confermare che (ad esempio con  <a href=\"http://jsonlint.com/\" target=\"_blank\">JSONLint</a>)."},"resetNotification": {"header": "Azzera opzioni","explanation": "Sei sicuro di voler ripristinare tutte le opzioni di script per il loro valore di default?"}}}}}},"general": {"successful": "Tuo ordine è stato effettuato","error": "C'è stato un errore nella tua richiesta.","fold": "","expand": "","ctrl": "","alt": "","shift": "","yes": "sì","no": "No"}} },
  1992. 				{ code: 'lv', settings: {"settings": {"kiloSep":",","decSep":".","ltr":true}}, translations: {"core": {"update": {"notPossible": {"header": "Nav iespējams atjaunināt","text": "Nav iespējams pārbaudīt atjauninājumu pieejamību %$1. Lūdzu, pārbaudiet manuāli skripta atjauninājumus. Pašlaik ir uzstādīta versija %$2. Šis paziņojums atkal parādīsies pēc četrām nedēļām."},"possible": {"header": "Ir pieejams atjauninājums","text": "Ir pieejams %$1 atjauninājums.<br>Pašlaik ir uzstādīta versija %$2. Jaunākā versija ir %$3.","history": "Versijas vēsture:","noHistory": "","type": {"feature": "Jaunumi","change": "Izmaiņas","bugfix": "Kļūdu labojumi","language": "Valodas","core": "Ikariam Core","other": "Citi"},"button": {"install": "Instalēt","hide": "Paslēpt"}},"noNewExists": {"header": "Nav pieejams atjauninājums","text": "Nav pieejama jauna versija %$1. Jaunākā versija %$2 ir jau uzstādīta."}},"notification": {"header": "Skripta paziņojumi","button": {"confirm": "OK","abort": "Atcelt"}},"optionPanel": {"save": "Saglabāt iestatījumus!","section": {"update": {"title": "Atjauninājumi","label": {"interval": {"description": "Intervāls starp atjauninājumu meklēšanu:","option": {"never": "Nekad","hour": "1 stunda","hour12": "12 stundas","day": "1 diena","day3": "3 dienas","week": "1 nedēļa","week2": "2 nedēļas","week4": "4 nedēļas"}},"notifyLevel": {"description": "","option": {"all": "Visas versijas","major": "","minor": "","patch": ""}},"manual": "Meklēt atjauninājumus \"%$1\"!"}},"optionPanelOptions": {"title": "Opcijas","label": {"import": "Importēt skripta opcijas","export": "Eksportēt skripta opcijas","reset": "Atiestatīt skripta opcijas","importNotification": {"header": "Importēt","explanation": ""},"exportNotification": {"header": "Eksportēt","explanation": ""},"importError": {"header": "Importēšanas kļūda!","explanation": ""},"resetNotification": {"header": "Atstatīšanas opcijas","explanation": ""}}}}}},"general": {"successful": "Jūsu rīkojums ir izpildīts.","error": "Jūsu veiktajā pieprasījumā radās kļūda.","fold": "Samazināt","expand": "Paplašināt","ctrl": "Ctrl","alt": "Alt","shift": "Shift","yes": "Jā","no": "Nē"}} },
  1993. 				{ code: 'ru', settings: {"settings": {"kiloSep":",","decSep":".","ltr":true}}, translations: {"core": {"update": {"notPossible": {"header": "У Вас последняя версия скрипта","text": "Невозможно проверить наличие обновлений для %$1. Пожалуйста, проверьте наличие обновлений для скрипта вручную. У Вас установлена версия %$2. Это сообщение появится снова в течение четырех недель."},"possible": {"header": "Доступно обновление","text": "Существует обновления для версии %$1.<br>На данный момент установлена версия %$2. Новейшая версия - %$3.","history": "История версий","noHistory": "Нет истории версий.","type": {"feature": "Особенность(и)","change": "Изменение(я)","bugfix": "Исправление(я)","language": "Язык(и)","core": "Ikariam Core","other": "Другое"},"button": {"install": "Установить","hide": "Скрыть"}},"noNewExists": {"header": "Нет доступных обновлений","text": "У Вас последняя версия скрипта %$1. Новейшая версия - %$2 уже установлена."}},"notification": {"header": "Уведомление скрипта","button": {"confirm": "OK","abort": "Отменить"}},"optionPanel": {"save": "Сохранить настройки!","section": {"update": {"title": "Обновить","label": {"interval": {"description": "Интервал поиска обновлений:","option": {"never": "Никогда","hour": "1 час","hour12": "12 часов","day": "1 день","day3": "3 дня","week": "1 неделя","week2": "2 недели","week4": "4 недели"}},"notifyLevel": {"description": "Уведомлять о новых версиях скрипта до этого уровня:","option": {"all": "Все версии","major": "Мажорная версия (x)","minor": "Минорная версия (x.x)","patch": "Патч или заплатка (x.x.x)"}},"manual": "Поиск обновлений для \"%$1\"!"}},"optionPanelOptions": {"title": "Панель настроек","label": {"import": "Импорт настроек скрипта","export": "Экспорт настроек скрипта","reset": "Сброс настройки скрипта","importNotification": {"header": "Импорт","explanation": "Для импорта настроек скопируйте содержание JSON файла-импорта в поле ниже и нажмите кнопку ОК. Пожалуйста, проверьте, что бы ни один символ не был пропущен. В противном случае импорт работать не будет."},"exportNotification": {"header": "Экспорт","explanation": "Пожалуйста, скопируйте текст из поля ниже в JSON файл-импорта. Вы можете импортировать его на любом компьютере, чтобы восстановить Ваши настройки. Пожалуйста, проверьте, что бы ни один символ не был пропущен. В противном случае импорт работать не будет."},"importError": {"header": "Ошибка импорта","explanation": "Во время импорта настроек произошла ошибка. Возможно JSON файл-импорта поврежден. Пожалуйста, проверьте его (например, с помощью <a href=\"http://jsonlint.com/\" target=\"_blank\">JSONLint</a>)."},"resetNotification": {"header": "Сброс настроек","explanation": "Вы уверены, что хотите сбросить настройки скрипта к их значению по умолчанию?"}}}}}},"general": {"successful": "Ваш приказ был выполнен.","error": "Ошибка в запросе.","fold": "Свернуть","expand": "Развернуть","ctrl": "Ctrl","alt": "Alt","shift": "Shift","yes": "Да","no": "Нет"}} },
  1994. 				{ code: 'tr', settings: {"settings": {"kiloSep":",","decSep":".","ltr":true}}, translations: {"core": {"update": {"notPossible": {"header": "","text": ""},"possible": {"header": "Güncelleştirme mevcut","text": "","history": "Sürüm Geçmişi","noHistory": "Versiyon geçmişi bulunmamakta.","type": {"feature": "Özellik(ler)","change": "Değişiklik(ler)","bugfix": "","language": "Dil(ler)","core": "","other": "Diğer"},"button": {"install": "Kur","hide": "Gizle"}},"noNewExists": {"header": "","text": "Versiyon %$1 için yeni sürüm bulunmamaktadır. En yeni sürüm %$2 yüklendi."}},"notification": {"header": "","button": {"confirm": "ONAY","abort": "İptal et"}},"optionPanel": {"save": "Ayarları kaydet!","section": {"update": {"title": "Güncelle","label": {"interval": {"description": "","option": {"never": "","hour": "1 saat","hour12": "12 saat","day": "1 gün","day3": "3 gün","week": "1 hafta","week2": "2 hafta","week4": "4 hafta"}},"notifyLevel": {"description": "","option": {"all": "Tüm Versiyonlar","major": "","minor": "","patch": "Yama (x.x.x)"}},"manual": "\"%$1\" için güncelleştirmeleri ara!"}},"optionPanelOptions": {"title": "Ayarlar Paneli","label": {"import": "","export": "","reset": "","importNotification": {"header": "İçe aktar","explanation": ""},"exportNotification": {"header": "Dışa aktar","explanation": ""},"importError": {"header": "İçe aktarım hatası!","explanation": ""},"resetNotification": {"header": "","explanation": ""}}}}}},"general": {"successful": "","error": "İsteğiniz gerçekleştirilirken bir hata meydana geldi.","fold": "","expand": "Genişlet","ctrl": "Ctrl","alt": "","shift": "","yes": "Evet","no": "Hayır"}} }
  1995. 			];
  1996. 			for(var i = 0; i < la_language.length; i++) {
  1997. 				await _addLanguageText(la_language[i].code, la_language[i].translations);
  1998. 				await _addLanguageText(la_language[i].code, la_language[i].settings);
  1999. 			}
  2000. 			
  2001. 			_gb_initialized = true;
  2002. 		};
  2003. 		
  2004. 		/**
  2005. 		 * Set the default language text for the script.
  2006. 		 * 
  2007. 		 * @private
  2008. 		 * @inner
  2009. 		 * 
  2010. 		 * @return	{Promise}
  2011. 		 *   A Promise which resolves once the default text is set.
  2012. 		 */
  2013. 		var _setDefaultText = async function() {
  2014. 			var lo_merged = await _mergeTexts(_gs_defaultCode);
  2015. 			
  2016. 			if(lo_merged.is_empty === true || lo_merged.not_set === true)
  2017. 				_go_defaultText = {};
  2018. 			else
  2019. 				_go_defaultText = lo_merged;
  2020. 		};
  2021. 		
  2022. 		/**
  2023. 		 * Set the chosen language text for the script.
  2024. 		 * 
  2025. 		 * @private
  2026. 		 * @inner
  2027. 		 * 
  2028. 		 * @param	{String}	is_languageCode
  2029. 		 *   The code of the last selected language.
  2030. 		 * 
  2031. 		 * @return	{Promise}
  2032. 		 *   A Promise which resolves once the language text is set.
  2033. 		 */
  2034. 		var _setText = async function(is_languageCode) {
  2035. 			if(is_languageCode === _gs_defaultCode)
  2036. 				await _setDefaultText();
  2037. 			
  2038. 			if(!!_go_registeredLangs[_gs_ikaCode] === true)
  2039. 				_gs_usedCode = _gs_ikaCode;
  2040. 			
  2041. 			if(is_languageCode === _gs_usedCode) {
  2042. 				var lo_merged = await _mergeTexts(is_languageCode);
  2043. 				
  2044. 				if(lo_merged.is_empty === true || lo_merged.not_set === true)
  2045. 					_go_usedText = _go_defaultText;
  2046. 				else
  2047. 					_go_usedText = lo_merged;
  2048. 			}
  2049. 		};
  2050. 		
  2051. 		/**
  2052. 		 * Merges the texts for a given language.
  2053. 		 * 
  2054. 		 * @private
  2055. 		 * @inner
  2056. 		 * 
  2057. 		 * @param	{String}	is_languageCode
  2058. 		 *   The code of the language to merge.
  2059. 		 *   
  2060. 		 * @return	{Promise}
  2061. 		 *   A Promise which resolves to the merged texts.
  2062. 		 */
  2063. 		var _mergeTexts = async function(is_languageCode) {
  2064. 			var ro_merged = {};
  2065. 			
  2066. 			if(!!_go_registeredLangs[is_languageCode] === true) {
  2067. 				var lb_initial = true;
  2068. 				
  2069. 				for(var i = 0; i < _go_registeredLangs[is_languageCode].length; i++) {
  2070. 					var lo_element = _go_registeredLangs[is_languageCode][i];
  2071. 					
  2072. 					if(lo_element.type === 'resource') {
  2073. 						var lo_resource = await go_self.myGM.getResourceParsed(lo_element.data.name, lo_element.data.url);
  2074. 						
  2075. 						if(!lo_resource.is_error === true) {
  2076. 							ro_merged = go_self.myGM.merge(ro_merged, lo_resource);
  2077. 							lb_initial = false;
  2078. 						}
  2079. 					} else if(lo_element.type === 'json') {
  2080. 						ro_merged = go_self.myGM.merge(ro_merged, lo_element.data);
  2081. 						lb_initial = false;
  2082. 					}
  2083. 				}
  2084. 				
  2085. 				if(lb_initial === true)
  2086. 					ro_merged = { is_empty: true };
  2087. 			} else {
  2088. 				ro_merged = { not_set: true };
  2089. 			}
  2090. 			
  2091. 			return ro_merged;
  2092. 		};
  2093. 		
  2094. 		/**
  2095. 		 * Return a string which is defined by its placeholder. If the string contains variables defined with %$nr,
  2096. 		 * they are replaced with the content of the array at this index.
  2097. 		 * 
  2098. 		 * @private
  2099. 		 * @inner
  2100. 		 * 
  2101. 		 * @param	{String}		is_name
  2102. 		 *   The name of the placeholder.
  2103. 		 * @param	{?Array.<*>}	[ia_variables]
  2104. 		 *   An array containing variables to replace the placeholders in the language string.
  2105. 		 * @param	{?boolean}		[ib_useDefault=false]
  2106. 		 *   If the default language should be used instead of the selected.
  2107. 		 * 
  2108. 		 * @return	{String}
  2109. 		 *   The text.
  2110. 		 */
  2111. 		var _getText = function(is_name, ia_variables, ib_useDefault) {
  2112. 			// Set the text to the placeholder.
  2113. 			var rs_text = is_name;
  2114. 	
  2115. 			// Split the placeholder.
  2116. 			var la_parts = is_name.split('.');
  2117. 	
  2118. 			if(!!la_parts === true) {
  2119. 				// Set ls_text to the "next level".
  2120. 				var ls_text = _go_usedText ? _go_usedText[la_parts[0]] : null;
  2121. 				
  2122. 				if(ib_useDefault === true)
  2123. 					ls_text = _go_defaultText ? _go_defaultText[la_parts[0]] : null;
  2124. 	
  2125. 				// Loop over all parts.
  2126. 				for(var i = 1; i < la_parts.length; i++) {
  2127. 					// If the "next level" exists, set txt to it.
  2128. 					if(ls_text && typeof ls_text[la_parts[i]] != 'undefined') {
  2129. 						ls_text = ls_text[la_parts[i]];
  2130. 					} else {
  2131. 						ls_text = rs_text;
  2132. 						break;
  2133. 					}
  2134. 				}
  2135. 	
  2136. 				// If the text type is not an object, a function or undefined.
  2137. 				if(typeof ls_text != 'object' && typeof ls_text != 'function' && typeof ls_text != 'undefined')
  2138. 					rs_text = ls_text + '';
  2139. 				
  2140. 				if(!!ia_variables === true && Array.isArray(ia_variables) === true) {
  2141. 					for(var i = 0; i < ia_variables.length; i++) {
  2142. 						var lr_regex = new RegExp('%\\$' + (i + 1), 'g');
  2143. 						rs_text = rs_text.replace(lr_regex, ia_variables[i] + '');
  2144. 					}
  2145. 				}
  2146. 			}
  2147. 			
  2148. 			if(ib_useDefault === true) {
  2149. 				return rs_text;
  2150. 			}
  2151. 			
  2152. 			if(rs_text == is_name || rs_text == "") {
  2153. 				go_self.con.info('Language.getText: No translation available for "' + is_name + '" in language ' + go_self.Language.usedLanguageCode);
  2154. 				rs_text = _getText(is_name, ia_variables, true);
  2155. 			}
  2156. 			
  2157. 			return rs_text;
  2158. 		};
  2159. 		
  2160. 		/**
  2161. 		 * Registers a new language without resource usage.
  2162. 		 * 
  2163. 		 * @private
  2164. 		 * @inner
  2165. 		 * 
  2166. 		 * @param	{String}	is_languageCode
  2167. 		 *   The code of the language.
  2168. 		 * @param	{json}		io_json
  2169. 		 *   JSON with the language data.
  2170. 		 * 
  2171. 		 * @return	{Promise}
  2172. 		 *   A Promise which resolves once the language text is added.
  2173. 		 */
  2174. 		var _addLanguageText = async function(is_languageCode, io_json) {
  2175. 			if(!_go_registeredLangs[is_languageCode] === true)
  2176. 				_go_registeredLangs[is_languageCode] = [];
  2177. 			
  2178. 			_go_registeredLangs[is_languageCode].push({
  2179. 				type:	'json',
  2180. 				data:	io_json
  2181. 			});
  2182. 			
  2183. 			await _setText(is_languageCode);
  2184. 		};
  2185. 		
  2186. 		/**
  2187. 		 * Registers a new language resource.
  2188. 		 * 
  2189. 		 * @private
  2190. 		 * @inner
  2191. 		 * 
  2192. 		 * @param	{String}	is_languageCode
  2193. 		 *   Code of the language.
  2194. 		 * @param	{String}	is_resourceName
  2195. 		 *   Name of the resource.
  2196. 		 * @param	{String}	is_resourceURL
  2197. 		 *   URL, if resources are not supported.
  2198. 		 * 
  2199. 		 * @return	{Promise}
  2200. 		 *   A Promise which resolves once the language resource is set.
  2201. 		 */
  2202. 		var _registerLanguageResource = async function(is_languageCode, is_resourceName, is_resourceURL) {
  2203. 			if(!_go_registeredLangs[is_languageCode] === true)
  2204. 				_go_registeredLangs[is_languageCode] = [];
  2205. 			
  2206. 			_go_registeredLangs[is_languageCode].push({
  2207. 				type:	'resource',
  2208. 				data:	{ name: is_resourceName, url: is_resourceURL }
  2209. 			});
  2210. 			
  2211. 			await _setText(is_languageCode);
  2212. 		};
  2213. 		
  2214. 		/*-------------------------------------------*
  2215. 		 * Public variables, functions and settings. *
  2216. 		 *-------------------------------------------*/
  2217. 		
  2218. 		/**
  2219. 		 * Code of the used language.
  2220. 		 * 
  2221. 		 * @instance
  2222. 		 * @readonly
  2223. 		 * @name	 usedLanguageCode
  2224. 		 * @memberof IkariamCore~Language
  2225. 		 * 
  2226. 		 * @type	{String}
  2227. 		 */
  2228. 		Object.defineProperty(this, 'usedLanguageCode', { get: function() {
  2229. 			return _gs_usedCode;
  2230. 		} });
  2231. 		
  2232. 		/**
  2233. 		 * Name of the used language.
  2234. 		 * 
  2235. 		 * @instance
  2236. 		 * @readonly
  2237. 		 * @name	 usedLanguageName
  2238. 		 * @memberof IkariamCore~Language
  2239. 		 * 
  2240. 		 * @type	{String}
  2241. 		 */
  2242. 		Object.defineProperty(this, 'usedLanguageName', { get: function() {
  2243. 			return _go_codeTranslation[_gs_usedCode];
  2244. 		} });
  2245. 		
  2246. 		/**
  2247. 		 * Set the default language.
  2248. 		 * 
  2249. 		 * @instance
  2250. 		 * 
  2251. 		 * @param	{String}	is_languageCode
  2252. 		 * 	 The code of the default language.
  2253. 		 * 
  2254. 		 * @return	{Promise}
  2255. 		 *   A Promise which resolves once the default language is set.
  2256. 		 */
  2257. 		this.setDefaultLanguage = async function(is_languageCode) {
  2258. 			if(_gb_initialized === false) {
  2259. 				await _initialize();
  2260. 			}
  2261. 			
  2262. 			_gs_defaultCode = is_languageCode;
  2263. 			
  2264. 			await _setDefaultText();
  2265. 		};
  2266. 		
  2267. 		/**
  2268. 		 * Registers a new language without resource usage.
  2269. 		 * 
  2270. 		 * @instance
  2271. 		 * 
  2272. 		 * @param	{String}	is_languageCode
  2273. 		 *   The code of the language.
  2274. 		 * @param	{json}		io_json
  2275. 		 *   JSON with the language data.
  2276. 		 * 
  2277. 		 * @return	{Promise}
  2278. 		 *   A Promise which resolves once the language text is added.
  2279. 		 */
  2280. 		this.addLanguageText = async function(is_languageCode, io_json) {
  2281. 			if(_gb_initialized === false) {
  2282. 				await _initialize();
  2283. 			}
  2284. 			
  2285. 			await _addLanguageText(is_languageCode, io_json, false);
  2286. 		};
  2287. 		
  2288. 		/**
  2289. 		 * Registers a new language resource.
  2290. 		 * 
  2291. 		 * @instance
  2292. 		 * 
  2293. 		 * @param	{String}	is_languageCode
  2294. 		 *   Code of the language.
  2295. 		 * @param	{String}	is_resourceName
  2296. 		 *   Name of the resource.
  2297. 		 * @param	{String}	is_resourceURL
  2298. 		 *   URL, if resources are not supported.
  2299. 		 * 
  2300. 		 * @return	{Promise}
  2301. 		 *   A Promise which resolves once the language resource is set.
  2302. 		 */
  2303. 		this.registerLanguageResource = async function(is_languageCode, is_resourceName, is_resourceURL) {
  2304. 			if(_gb_initialized === false) {
  2305. 				await _initialize();
  2306. 			}
  2307. 			
  2308. 			await _registerLanguageResource(is_languageCode, is_resourceName, is_resourceURL, false);
  2309. 		};
  2310. 		
  2311. 		/**
  2312. 		 * Return a string which is defined by its placeholder. If the string contains variables defined with %$nr,
  2313. 		 * they are replaced with the content of the array at this index.
  2314. 		 * 
  2315. 		 * @instance
  2316. 		 * 
  2317. 		 * @param	{String}		is_name
  2318. 		 *   The name of the placeholder.
  2319. 		 * @param	{?Array.<*>}	[ia_variables]
  2320. 		 *   An array containing variables to replace the placeholders in the language string.
  2321. 		 * 
  2322. 		 * @return	{String}
  2323. 		 *   The text.
  2324. 		 */
  2325. 		this.getText = function(is_name, ia_variables) {
  2326. 			return _getText(is_name, ia_variables);
  2327. 		};
  2328. 		
  2329. 		/**
  2330. 		 * Synonymous function for {@link IkariamCore~Language#getText}.<br>
  2331. 		 * 
  2332. 		 * @instance
  2333. 		 * 
  2334. 		 * @see		IkariamCore~Language#getText
  2335. 		 * 
  2336. 		 * @param	{String}		is_name
  2337. 		 *   The name of the placeholder.
  2338. 		 * @param	{?Array.<*>}	[ia_variables]
  2339. 		 *   An array containing variables to replace the placeholders in the language string.
  2340. 		 *
  2341. 		 * @return	{String}
  2342. 		 *   The text.
  2343. 		 */
  2344. 		this.$ = function(is_name, ia_variables) {
  2345. 			return this.getText(is_name, ia_variables);
  2346. 		};
  2347. 		
  2348. 		/*---------------------------------------------------------------------*
  2349. 		 * Types for documentation purposes (e.g. callback functions, objects) *
  2350. 		 *---------------------------------------------------------------------*/
  2351. 		
  2352. 		/**
  2353. 		 * Storage for language settings.
  2354. 		 * 
  2355. 		 * @callback	IkariamCore~Language~LanguageSettings
  2356. 		 * 
  2357. 		 * @private
  2358. 		 * @inner
  2359. 		 * 
  2360. 		 * @param	{String}	type
  2361. 		 *   The type of the language resources. Currently supported: resource, json
  2362. 		 * @param	{({name: String, url: String}|json)}	data
  2363. 		 *   The data required to fetch the translations of this language.
  2364. 		 */
  2365. 	}
  2366. 	
  2367. 	/**
  2368. 	 * Functions for localization of the script.
  2369. 	 * 
  2370. 	 * @instance
  2371. 	 * 
  2372. 	 * @type	IkariamCore~Language
  2373. 	 */
  2374. 	this.Language = new Language();
  2375. 	
  2376. 	this.con.logTimeStamp('IkariamCore.Language created');
  2377. 	
  2378. 	/**
  2379. 	 * Instantiate a new set of Ikariam specific functions.
  2380. 	 * 
  2381. 	 * @inner
  2382. 	 * 
  2383. 	 * @class
  2384. 	 * @classdesc	Ikariam specific functions.
  2385. 	 */
  2386. 	function Ikariam() {
  2387. 		/*-------------------------------------------*
  2388. 		 * Public variables, functions and settings. *
  2389. 		 *-------------------------------------------*/
  2390. 		
  2391. 		/**
  2392. 		 * Name of the shown view (world, island, town).
  2393. 		 * 
  2394. 		 * @instance
  2395. 		 * @readonly
  2396. 		 * @name	 view
  2397. 		 * @memberof IkariamCore~Ikariam
  2398. 		 * 
  2399. 		 * @type	{String}
  2400. 		 */
  2401. 		Object.defineProperty(this, 'view', { get: function() {
  2402. 			var ls_viewId = go_self.myGM.$('body').id;
  2403. 			
  2404. 			if(ls_viewId == 'worldmap_iso')
  2405. 				return 'world';
  2406. 			
  2407. 			if(ls_viewId == 'island')
  2408. 				return 'island';
  2409. 			
  2410. 			if(ls_viewId == 'city')
  2411. 				return 'town';
  2412. 			
  2413. 			return '';
  2414. 		} });
  2415. 		
  2416. 		/**
  2417. 		 * All possible view names.
  2418. 		 * 
  2419. 		 * @instance
  2420. 		 * @readonly
  2421. 		 * @name	 viewNames
  2422. 		 * @memberof IkariamCore~Ikariam
  2423. 		 * 
  2424. 		 * @type	{Array.<String>}
  2425. 		 */
  2426. 		Object.defineProperty(this, 'viewNames', { get: function() {
  2427. 			return ['world', 'island', 'town'];
  2428. 		} });
  2429. 		
  2430. 		/**
  2431. 		 * All possible resource names.
  2432. 		 * 
  2433. 		 * @instance
  2434. 		 * @readonly
  2435. 		 * @name	 resourceNames
  2436. 		 * @memberof IkariamCore~Ikariam
  2437. 		 * 
  2438. 		 * @type	{Array.<String>}
  2439. 		 */
  2440. 		Object.defineProperty(this, 'resourceNames', { get: function() {
  2441. 			return ['wood', 'wine', 'marble', 'glass', 'sulfur'];
  2442. 		} });
  2443. 		
  2444. 		/**
  2445. 		 * Code consisting of server id and country code.<br>
  2446. 		 * Structure: <code>&lt;country-code&gt;_&lt;server-id&gt;</code>
  2447. 		 * 
  2448. 		 * @instance
  2449. 		 * @readonly
  2450. 		 * @name	 serverCode
  2451. 		 * @memberof IkariamCore~Ikariam
  2452. 		 * 
  2453. 		 * @type	{String}
  2454. 		 */
  2455. 		Object.defineProperty(this, 'serverCode', { get: function() {
  2456. 			var la_code = top.location.host.match(/^s([0-9]+)-([a-zA-Z]+)\.ikariam\.gameforge\.com$/);
  2457. 			
  2458. 			if(!!la_code)
  2459. 				return la_code[2] + '_' + la_code[1];
  2460. 			
  2461. 			return 'undefined';
  2462. 		} });
  2463. 		
  2464. 		/**
  2465. 		 * Code consisting of player id, server id and country code.<br>
  2466. 		 * Structure: <code>&lt;country-code&gt;_&lt;server-id&gt;_&lt;player-id&gt;</code>
  2467. 		 * 
  2468. 		 * @instance
  2469. 		 * @readonly
  2470. 		 * @name	 playerCode
  2471. 		 * @memberof IkariamCore~Ikariam
  2472. 		 * 
  2473. 		 * @type	{String}
  2474. 		 */
  2475. 		Object.defineProperty(this, 'playerCode', { get: function() {
  2476. 			var ls_serverCode	= this.serverCode;
  2477. 			var ls_playerId		= go_self.ika.getModel().avatarId;
  2478. 			
  2479. 			if(ls_serverCode !== 'undefined')
  2480. 				return ls_serverCode + '_' + ls_playerId;
  2481. 			
  2482. 			return 'undefined';
  2483. 		} });
  2484. 		
  2485. 		/**
  2486. 		 * Parses a string number to an int value.
  2487. 		 * 
  2488. 		 * @instance
  2489. 		 * 
  2490. 		 * @param	{String}	is_text
  2491. 		 *   The number to format.
  2492. 		 *
  2493. 		 * @return	{int}
  2494. 		 *   The formatted value.
  2495. 		 */
  2496. 		this.getInt = function(is_text) {
  2497. 			var ls_text = is_text + '';
  2498. 			return parseInt(ls_text.replace(/(\.|,)/g, ''));
  2499. 		};
  2500. 		
  2501. 		/**
  2502. 		 * Formats a number to the format which is used in Ikariam.
  2503. 		 *
  2504. 		 * @param	{int}			ii_number
  2505. 		 *   The number to format.
  2506. 		 * @param	{?(boolean|Object.<String, boolean>)}	[im_addColor={ positive: false, negative: true }]
  2507. 		 *   If the number should be colored.
  2508. 		 * @param	{?boolean}		[ib_usePlusSign=false]
  2509. 		 *   If a plus sign should be used for positive numbers.
  2510. 		 * 
  2511. 		 * @return	{String}
  2512. 		 *   The formated number.
  2513. 		 */
  2514. 		this.formatToIkaNumber = function(ii_number, im_addColor, ib_usePlusSign) {
  2515. 			var rs_text = ii_number + '';
  2516. 	
  2517. 			// Set a seperator every 3 digits from the end.
  2518. 			rs_text = rs_text.replace(/(\d)(?=(\d{3})+\b)/g, '$1' + go_self.Language.$('settings.kiloSep'));
  2519. 	
  2520. 			if(ii_number < 0 && !(im_addColor == false || (im_addColor && im_addColor.negative == false))) {
  2521. 				rs_text = '<span class="red bold">' + rs_text + '</span>';
  2522. 			}
  2523. 	
  2524. 			if(ii_number > 0) {
  2525. 				rs_text = (ib_usePlusSign ? '+' : '') + rs_text;
  2526. 	
  2527. 				if(!!(im_addColor == true || (im_addColor && im_addColor.positive == true))) {
  2528. 					rs_text = '<span class="green bold">' + rs_text + '</span>';
  2529. 				}
  2530. 			}
  2531. 	
  2532. 			return rs_text;
  2533. 		};
  2534. 		
  2535. 		/**
  2536. 		 * Shows a hint to the user.
  2537. 		 * 
  2538. 		 * @instance
  2539. 		 * 
  2540. 		 * @param	{String}	is_located
  2541. 		 *   The location of the hint.<br>
  2542. 		 *   Possible values: <code>cityAdvisor</code>, <code>militaryAdvisor</code>, <code>researchAdvisor</code>, <code>diplomacyAdvisor</code>, <code>clickedElement</code>, <code>committedElement</code>
  2543. 		 * @param	{String}	is_type
  2544. 		 *   The type of the hint.<br>
  2545. 		 *   Possible values: <code>confirm</code>, <code>error</code>, <code>neutral</code>, <code>followMouse</code>
  2546. 		 * @param	{String}	is_text
  2547. 		 *   The hint text.
  2548. 		 * @param	{?String}	[is_bindTo=null]
  2549. 		 *   The JQuery selector of the element the tooltip should be bound to (only used if location = committedElement).
  2550. 		 * @param	{?boolean}	[ib_hasAutoWidth=false]
  2551. 		 *   If the message has auto width (only used if type = followMouse).
  2552. 		 */
  2553. 		this.showTooltip = function(is_located, is_type, is_text, is_bindTo, ib_hasAutoWidth) {
  2554. 			// Get the message location.
  2555. 			var li_location = -1;
  2556. 			switch(is_located) {
  2557. 				case 'cityAdvisor':
  2558. 					li_location = 1;
  2559. 				  break;
  2560. 	
  2561. 				case 'militaryAdvisor':
  2562. 					li_location = 2;
  2563. 				  break;
  2564. 	
  2565. 				case 'researchAdvisor':
  2566. 					li_location = 3;
  2567. 				  break;
  2568. 	
  2569. 				case 'diplomacyAdvisor':
  2570. 					li_location = 4;
  2571. 				  break;
  2572. 	
  2573. 				case 'clickedElement':
  2574. 					li_location = 5;
  2575. 				  break;
  2576. 	
  2577. 				case 'committedElement':
  2578. 					li_location = 6;
  2579. 				  break;
  2580. 			}
  2581. 	
  2582. 			// Get the message type.
  2583. 			var li_type = -1;
  2584. 			switch(is_type) {
  2585. 				case 'confirm':
  2586. 					li_type = 10;
  2587. 				  break;
  2588. 	
  2589. 				case 'error':
  2590. 					li_type = 11;
  2591. 				  break;
  2592. 	
  2593. 				case 'neutral':
  2594. 					li_type = 12;
  2595. 				  break;
  2596. 	
  2597. 				case 'followMouse':
  2598. 					li_type = 13;
  2599. 				  break;
  2600. 			}
  2601. 			
  2602. 			go_self.ika.controller.tooltipController.bindBubbleTip(li_location, li_type, is_text, null, is_bindTo, ib_hasAutoWidth);
  2603. 		};
  2604. 		
  2605. 		/**
  2606. 		 * Creates new checkboxes in Ikariam style and adds them to a parent.
  2607. 		 * 
  2608. 		 * @instance
  2609. 		 * 
  2610. 		 * @see	IkariamCore~myGM#addCheckboxes
  2611. 		 * 
  2612. 		 * @param	{Element}	ie_parent
  2613. 		 *   The parent of the new checkboxes.
  2614. 		 * @param	{Array.<IkariamCore~myGM~NewCheckboxData>}	ia_cbData
  2615. 		 *   An array containing the data of each checkbox.
  2616. 		 */
  2617. 		this.addCheckboxes = function(ie_parent, ia_cbData) {
  2618. 			go_self.myGM.addCheckboxes(ie_parent, ia_cbData);
  2619. 			
  2620. 			// Replace the checkboxes for better appearance.
  2621. 			go_self.ika.controller.replaceCheckboxes();
  2622. 		};
  2623. 		
  2624. 		/**
  2625. 		 * Creates a new radio button group in ikariam style and adds it to a parent table.
  2626. 		 * 
  2627. 		 * @instance
  2628. 		 * 
  2629. 		 * @see	IkariamCore~myGM#addRadios
  2630. 		 * 
  2631. 		 * @param	{Element}		ie_parentTable
  2632. 		 *   The parent table of the new select field.
  2633. 		 * @param	{String}		is_name
  2634. 		 *   The last part of the name of the radio button group.
  2635. 		 * @param	{(String|int)}	im_checked
  2636. 		 *   The value of the selected option.
  2637. 		 * @param	{Array.<IkariamCore~myGM~ValueAndLabel>}	ia_options
  2638. 		 *   An array with the names an values of the options.
  2639. 		 * @param	{String}		is_labelText
  2640. 		 *   The text of the select label.
  2641. 		 */
  2642. 		this.addRadios = function(ie_parentTable, is_name, im_checked, ia_options, is_labelText) {
  2643. 			go_self.myGM.addRadios(ie_parentTable, is_name, im_checked, ia_options, is_labelText);
  2644. 			
  2645. 			// Replace the radiobuttons for better appearance.
  2646. 			go_self.ika.controller.replaceCheckboxes();
  2647. 		};
  2648. 		
  2649. 		/**
  2650. 		 * Creates a new select field in ikariam style and adds it to a parent table.
  2651. 		 * 
  2652. 		 * @instance
  2653. 		 * 
  2654. 		 * @see	IkariamCore~myGM#addSelect
  2655. 		 * 
  2656. 		 * @param	{Element}		ie_parentTable
  2657. 		 *   The parent table of the new select field.
  2658. 		 * @param	{String}		is_id
  2659. 		 *   The last part of the id of the select field.
  2660. 		 * @param	{(String|int)}	im_selected
  2661. 		 *   The value of the selected option.
  2662. 		 * @param	{Array.<IkariamCore~myGM~ValueAndLabel>}	ia_options
  2663. 		 *   An array with the names an values of the options.
  2664. 		 * @param	{String}		is_labelText
  2665. 		 *   The text of the select label.
  2666. 		 */
  2667. 		this.addSelect = function(ie_parentTable, is_id, im_selected, ia_options, is_labelText) {
  2668. 			go_self.myGM.addSelect(ie_parentTable, is_id, im_selected, ia_options, is_labelText);
  2669. 			
  2670. 			// Replace the dropdown for better appearance.
  2671. 			go_self.ika.controller.replaceDropdownMenus();
  2672. 		};
  2673. 	}
  2674. 	
  2675. 	/**
  2676. 	 * Ikariam specific functions like converting a number from Ikariam format to int.
  2677. 	 * 
  2678. 	 * @instance
  2679. 	 * 
  2680. 	 * @type	IkariamCore~Ikariam
  2681. 	 */
  2682. 	this.Ikariam = new Ikariam();
  2683. 	
  2684. 	this.con.logTimeStamp('IkariamCore.Ikariam created');
  2685. 	
  2686. 	/**
  2687. 	 * Instantiate the handler.
  2688. 	 * 
  2689. 	 * @inner
  2690. 	 * 
  2691. 	 * @class
  2692. 	 * @classdesc	Handler for callbacks for processing DOM modification events.
  2693. 	 */
  2694. 	function Observer() {
  2695. 		/*--------------------------------------------*
  2696. 		 * Private variables, functions and settings. *
  2697. 		 *--------------------------------------------*/
  2698. 		
  2699. 		/**
  2700. 		 * Storage for MutationObserver.
  2701. 		 * 
  2702. 		 * @private
  2703. 		 * @inner
  2704. 		 * 
  2705. 		 * @type	MutationObserver
  2706. 		 */ 
  2707. 		var _go_MutationObserver = MutationObserver || WebKitMutationObserver;
  2708. 		
  2709. 		/**
  2710. 		 * If the MutationObserver can be used or if an workaround must be used.
  2711. 		 * 
  2712. 		 * @private
  2713. 		 * @inner
  2714. 		 * 
  2715. 		 * @type	boolean
  2716. 		 */ 
  2717. 		var _gb_canUseObserver = !!_go_MutationObserver;
  2718. 		
  2719. 		/**
  2720. 		 * List to store the created observers.
  2721. 		 * 
  2722. 		 * @private
  2723. 		 * @inner
  2724. 		 * 
  2725. 		 * @type	Object.<String, MutationObserver>
  2726. 		 */
  2727. 		var _go_observerList = {};
  2728. 		
  2729. 		/*-------------------------------------------*
  2730. 		 * Public variables, functions and settings. *
  2731. 		 *-------------------------------------------*/
  2732. 		
  2733. 		/**
  2734. 		 * Adds a new observer for DOM modification events. If it is possible use MutationObservers. More about the 
  2735. 		 * Mutation observer can be found here: {@link https://developer.mozilla.org/en-US/docs/DOM/MutationObserver Mutation Observer on MDN}.<br>
  2736. 		 * If it's not possible to use a MutationObserver a DOMSubtreeModified or DOMAttrModified event listener is used.
  2737. 		 * 
  2738. 		 * @instance
  2739. 		 * 
  2740. 		 * @param	{String}		is_id
  2741. 		 *   The id to store the observer.
  2742. 		 * @param	{element}		ie_target
  2743. 		 *   The target to observe.
  2744. 		 * @param	{Array.<*>}		io_options
  2745. 		 *   Options for the observer. All possible options can be found here: {@link https://developer.mozilla.org/en-US/docs/DOM/MutationObserver#MutationObserverInit MutationObserver on MDN}
  2746. 		 * @param	{IkariamCore~Observer~MutationCallback}		if_callback
  2747. 		 *   The callback for the mutation observer.<br>
  2748. 		 * @param	{IkariamCore~Observer~NoMutationCallback}	if_noMutationObserverCallback
  2749. 		 *   The callback if the use of the mutation observer is not possible and DOMAttrModified / DOMSubtreeModified is used instead.<br>
  2750. 		 */
  2751. 		this.add = function(is_id, ie_target, io_options, if_callback, if_noMutationObserverCallback) {
  2752. 			var lo_observer;
  2753. 			
  2754. 			if(!!ie_target) {
  2755. 				// If the MutationObserver can be used, do so.
  2756. 				if(_gb_canUseObserver) {
  2757. 					lo_observer = new _go_MutationObserver(if_callback);
  2758. 					lo_observer.observe(ie_target, io_options);
  2759. 					
  2760. 					if(!_go_observerList[is_id]) {
  2761. 						_go_observerList[is_id] = lo_observer;
  2762. 					} else {
  2763. 						go_self.con.warn('Observer.add: Id "' + is_id + '" already used for observer, please choose another one!');
  2764. 					}
  2765. 				
  2766. 				// Otherwise use the event listener.
  2767. 				} else {
  2768. 					if(io_options.attributes) {
  2769. 						ie_target.addEventListener('DOMAttrModified', if_noMutationObserverCallback, false);
  2770. 					}
  2771. 					
  2772. 					if(io_options.characterData || io_options.childList || io_options.subtree) {
  2773. 						ie_target.addEventListener('DOMSubtreeModified', if_noMutationObserverCallback, false);
  2774. 					}
  2775. 				}
  2776. 			} else {
  2777. 				go_self.con.warn('Observer.add: Observer target not defined! id: ' + is_id);
  2778. 			}
  2779. 		};
  2780. 		
  2781. 		/**
  2782. 		 * Removes the observer given by the id. If the use of MutationObserver is not possible, this function can not be used.
  2783. 		 * 
  2784. 		 * @instance
  2785. 		 * 
  2786. 		 * @param	{String}	is_id
  2787. 		 *   The id of the observer to remove.
  2788. 		 */
  2789. 		this.remove = function(is_id) {
  2790. 			// If the observer is set.
  2791. 			if(_gb_canUseObserver && _go_observerList[is_id]) {
  2792. 				var lo_observer = _go_observerList[is_id];
  2793. 				lo_observer.disconnect();
  2794. 				
  2795. 				delete _go_observerList[is_id];
  2796. 			} else if(!_gb_canUseObserver) {
  2797. 				go_self.con.warn('Observer.remove: It is not possible to use MutationObservers so Observer.remove can not be used.');
  2798. 			}
  2799. 		};
  2800. 		
  2801. 		/*---------------------------------------------------------------------*
  2802. 		 * Types for documentation purposes (e.g. callback functions, objects) *
  2803. 		 *---------------------------------------------------------------------*/
  2804. 		
  2805. 		/**
  2806. 		 * The callback for the mutation observer.
  2807. 		 * 
  2808. 		 * @callback	IkariamCore~Observer~MutationCallback
  2809. 		 * 
  2810. 		 * @param	{MutationRecord}	mutations
  2811. 		 *   The mutations which occurred.
  2812. 		 */
  2813. 		
  2814. 		/**
  2815. 		 * The callback if no mutation observer could be used.
  2816. 		 * 
  2817. 		 * @callback	IkariamCore~Observer~NoMutationCallback
  2818. 		 */
  2819. 	}
  2820. 		
  2821. 	/**
  2822. 	 * Handler for callbacks after modification of DOM elements.
  2823. 	 * 
  2824. 	 * @instance
  2825. 	 * 
  2826. 	 * @type	IkariamCore~Observer
  2827. 	 */
  2828. 	this.Observer = new Observer();
  2829. 	
  2830. 	this.con.logTimeStamp('IkariamCore.Observer created');
  2831. 	
  2832. 	/**
  2833. 	 * Instantiate a new set of refresh functions.
  2834. 	 * 
  2835. 	 * @inner
  2836. 	 * 
  2837. 	 * @class
  2838. 	 * @classdesc	Handles functions that should run on Ikariam popups and after actualizations of the page data.
  2839. 	 */
  2840. 	function RefreshHandler() {
  2841. 		/*--------------------------------------------*
  2842. 		 * Private variables, functions and settings. *
  2843. 		 *--------------------------------------------*/
  2844. 		
  2845. 		/**
  2846. 		 * Storage for the actualization callbacks.<br>
  2847. 		 * Architecture:<br>
  2848. 		 * <pre>_go_callbacks = {
  2849. 		 *     popupId: {
  2850. 		 *         callbackId: callback
  2851. 		 *     }
  2852. 		 * }</pre>
  2853. 		 * 
  2854. 		 * @private
  2855. 		 * @inner
  2856. 		 * 
  2857. 		 * @type	Object.<String, Object.<String, function>>
  2858. 		 */
  2859. 		var _go_callbacks = {};
  2860. 		
  2861. 		/**
  2862. 		 * Handles the call of the callback functions for the actualization.
  2863. 		 * 
  2864. 		 * @private
  2865. 		 * @inner
  2866. 		 */
  2867. 		var _handleActualisation = function() {
  2868. 			// Run the callbacks for every reload.
  2869. 			if(_go_callbacks['*']) {
  2870. 				go_self.myGM.forEach(_go_callbacks['*'], function(is_key, if_callback) {
  2871. 					if_callback();
  2872. 				});
  2873. 			}
  2874. 			
  2875. 			// If the script was already executed on this popup.
  2876. 			var lb_isAlreadyExecutedPopup	= !!go_self.myGM.$('#' + go_self.myGM.prefix + 'alreadyExecutedPopup');
  2877. 			var le_popup					= go_self.myGM.$('.templateView');
  2878. 	
  2879. 			if(le_popup && !lb_isAlreadyExecutedPopup) {
  2880. 				// Run the callbacks for every popup opening.
  2881. 				if(_go_callbacks['%']) {
  2882. 					go_self.myGM.forEach(_go_callbacks['%'], function(is_key, if_callback) {
  2883. 						if_callback();
  2884. 					});
  2885. 				}
  2886. 				
  2887. 				go_self.myGM.addElement('input', go_self.myGM.$('.mainContent', le_popup), { 'id': 'alreadyExecutedPopup', 'type': 'hidden' });
  2888. 				
  2889. 				var ls_popupId = le_popup ? le_popup.id.replace('_c', '') : '';
  2890. 				
  2891. 				if(_go_callbacks[ls_popupId]) {
  2892. 					go_self.myGM.forEach(_go_callbacks[ls_popupId], function(is_key, if_callback) {
  2893. 						if_callback();
  2894. 					});
  2895. 				}
  2896. 			}
  2897. 		};
  2898. 		
  2899. 		/**
  2900. 		 * Callback for MutationObserver for calling the popup handler.
  2901. 		 * 
  2902. 		 * @private
  2903. 		 * @inner
  2904. 		 * 
  2905. 		 * @param	{MutationRecord}	la_mutations
  2906. 		 *   All recorded mutations.
  2907. 		 */
  2908. 		var _callback = function(la_mutations) {
  2909. 			la_mutations.forEach(function(io_mutation) {
  2910. 				if(io_mutation.target.getAttribute('style').search(/display: none/i) != -1) {
  2911. 					// Timeout to have access to GM_ funtions.
  2912. 					setTimeout(_handleActualisation, 0);
  2913. 				}
  2914. 			});
  2915. 		};
  2916. 		
  2917. 		/**
  2918. 		 * Callback for calling the popup handler if the MutationObserver could not be used.
  2919. 		 * 
  2920. 		 * @private
  2921. 		 * @inner
  2922. 		 * 
  2923. 		 * @param	{Event}	io_event
  2924. 		 *   The called event.
  2925. 		 */
  2926. 		var _callbackNoMutationObserver = function(io_event) {
  2927. 			if(io_event.attrChange == MutationEvent.MODIFICATION) {
  2928. 				if(io_event.attrName.IC.trim() == 'style' && io_event.newValue.search(/display: none/i) != -1) {
  2929. 					// Timeout to have access to GM_ funtions.
  2930. 					setTimeout(_handleActualisation, 0);
  2931. 				}
  2932. 			}
  2933. 		};
  2934. 		
  2935. 		/*-------------------------------------------*
  2936. 		 * Public variables, functions and settings. *
  2937. 		 *-------------------------------------------*/
  2938. 		
  2939. 		/**
  2940. 		 * Add a new popup handler.
  2941. 		 * 
  2942. 		 * @instance
  2943. 		 * 
  2944. 		 * @param	{(String|Array.<String>)}	im_popupId
  2945. 		 *   The id(s) of the popup(s) where the callback should be called (without '_c' at the end).<br>
  2946. 		 *   Set to '*' for calling at every actualization, not just popups. Set to '%' for calling on every popup.
  2947. 		 * @param	{String}	is_callbackId
  2948. 		 *   The id of the callback. This must be unique for a popup.
  2949. 		 * @param	{function}	if_callback
  2950. 		 *   The callback which should be called.</code>
  2951. 		 */
  2952. 		this.add = function(im_popupId, is_callbackId, if_callback) {
  2953. 			if(Array.isArray(im_popupId) === true) {
  2954. 				for(var i = 0; i < im_popupId.length; i++) {
  2955. 					this.add(im_popupId[i], is_callbackId, if_callback);
  2956. 				}
  2957. 				
  2958. 				return;
  2959. 			}
  2960. 			
  2961. 			if(!_go_callbacks[im_popupId]) {
  2962. 				_go_callbacks[im_popupId] = {};
  2963. 			}
  2964. 			
  2965. 			if(!_go_callbacks[im_popupId][is_callbackId]) {
  2966. 				_go_callbacks[im_popupId][is_callbackId] = if_callback;
  2967. 			} else {
  2968. 				go_self.con.warn('RefreshHandler.add: Id set "' + im_popupId + '|' + is_callbackId + '" already used for observer, please choose another one!');
  2969. 			}
  2970. 		};
  2971. 		
  2972. 		/**
  2973. 		 * Removes a popup handler.
  2974. 		 * 
  2975. 		 * @instance
  2976. 		 * 
  2977. 		 * @param	{(String|Array.<String>)}	im_popupId
  2978. 		 *   The id(s) of the popup(s) where the callback was called (without '_c' at the end).
  2979. 		 *   Set to '*' for callbacks on every actualisation, not just popups. Set to '%' for callbacks on every popup.
  2980. 		 * @param	{String}	is_callbackId
  2981. 		 *   The id of the callback. This must be unique for a popup.
  2982. 		 */
  2983. 		this.remove = function(im_popupId, is_callbackId) {
  2984. 			if(Array.isArray(im_popupId) === true) {
  2985. 				for(var i = 0; i < im_popupId.length; i++) {
  2986. 					this.remove(im_popupId[i], is_callbackId);
  2987. 				}
  2988. 				
  2989. 				return;
  2990. 			}
  2991. 			
  2992. 			if(_go_callbacks[im_popupId] && _go_callbacks[im_popupId][is_callbackId]) {
  2993. 				delete	_go_callbacks[im_popupId][is_callbackId];
  2994. 			}
  2995. 		};
  2996. 		
  2997. 		/*----------------------------------------------------*
  2998. 		 * Register the observer and handle popups on startup *
  2999. 		 *----------------------------------------------------*/
  3000. 		
  3001. 		// Add the observer for the popups.
  3002. 		go_self.Observer.add('actualisationHandler', go_self.myGM.$('#loadingPreview'), { attributes: true, attributeFilter: ['style'] }, _callback, _callbackNoMutationObserver);
  3003. 		
  3004. 		// Execute the handler on popups which are shown on startup.
  3005. 		setTimeout(_handleActualisation, 1000);
  3006. 	}
  3007. 	
  3008. 	/**
  3009. 	 * Handler for functions that should run on Ikariam popups.
  3010. 	 * 
  3011. 	 * @instance
  3012. 	 * 
  3013. 	 * @type	IkariamCore~RefreshHandler
  3014. 	 */
  3015. 	this.RefreshHandler = new RefreshHandler();
  3016. 	
  3017. 	this.con.logTimeStamp('IkariamCore.RefreshHandler created');
  3018. 	
  3019. 	/**
  3020. 	 * Instantiate a new set of options / settings functions.
  3021. 	 * 
  3022. 	 * @inner
  3023. 	 * 
  3024. 	 * @class
  3025. 	 * @classdesc	Handles options the user can set, provides a "panel" for them to change them.
  3026. 	 */
  3027. 	function Options() {
  3028. 		/*--------------------------------------------*
  3029. 		 * Private variables, functions and settings. *
  3030. 		 *--------------------------------------------*/
  3031. 		
  3032. 		/**
  3033. 		 * Enum for the level of specificity an option can have.
  3034. 		 * 
  3035. 		 * @private
  3036. 		 * @inner
  3037. 		 * @readonly
  3038. 		 * 
  3039. 		 * @enum	{IkariamCore~Options~SpecificityLevelEnum}
  3040. 		 */
  3041. 		var _gec_SpecificityLevel = Object.freeze({
  3042. 			GLOBAL:	'1',
  3043. 			SERVER:	'2',
  3044. 			PLAYER:	'3'
  3045. 		});
  3046. 		
  3047. 		/**
  3048. 		 * Storage for option wrapper visibility.
  3049. 		 * 
  3050. 		 * @private
  3051. 		 * @inner
  3052. 		 * 
  3053. 		 * @type	Array.<boolean>
  3054. 		 */
  3055. 		var _go_optionWrapperVisibility = {};
  3056. 		
  3057. 		/**
  3058. 		 * Storage for option wrappers.
  3059. 		 * 
  3060. 		 * @private
  3061. 		 * @inner
  3062. 		 * 
  3063. 		 * @type	Object
  3064. 		 */
  3065. 		var _go_wrapper = {};
  3066. 		
  3067. 		/**
  3068. 		 * Storage for option wrapper order. (Order in which the wrappers are shown)
  3069. 		 * 
  3070. 		 * @private
  3071. 		 * @inner
  3072. 		 * 
  3073. 		 * @type	Array.<String>
  3074. 		 */
  3075. 		var _ga_wrapperOrder = new Array();
  3076. 		
  3077. 		/**
  3078. 		 * Storage for the saved options. Gets filled on startup.
  3079. 		 * 
  3080. 		 * @private
  3081. 		 * @inner
  3082. 		 * 
  3083. 		 * @type	Object
  3084. 		 */
  3085. 		var _go_savedOptions = null;
  3086. 		
  3087. 		/**
  3088. 		 * Storage for the options.
  3089. 		 * 
  3090. 		 * @private
  3091. 		 * @inner
  3092. 		 * 
  3093. 		 * @type	Object
  3094. 		 */
  3095. 		var _go_options = {};
  3096. 		
  3097. 		/**
  3098. 		 * Storage for the id of the next <code>&lt;hr&gt;</code> element to create.
  3099. 		 * 
  3100. 		 * @private
  3101. 		 * @inner
  3102. 		 * 
  3103. 		 * @type	int
  3104. 		 */
  3105. 		var _gi_lineId = 0;
  3106. 		
  3107. 		/**
  3108. 		 * Returns the prefix string for a level of specificity.
  3109. 		 * 
  3110. 		 * @private
  3111. 		 * @inner
  3112. 		 * 
  3113. 		 * @param	{int}	ii_specificityLevel
  3114. 		 *   The specificity level (One of values of {@link IkariamCore~Options~SpecificityLevelEnum})
  3115. 		 *   
  3116. 		 * @return	{String}
  3117. 		 *   The prefix for this level of specificity.
  3118. 		 */
  3119. 		var _getSpecificityPrefix = function(ii_specificityLevel) {
  3120. 			var rv_specificityPrefix = '';
  3121. 			
  3122. 			switch(ii_specificityLevel) {
  3123. 				case _gec_SpecificityLevel.GLOBAL:
  3124. 					rv_specificityPrefix = '';
  3125. 				  break;
  3126. 				
  3127. 				case _gec_SpecificityLevel.SERVER:
  3128. 					rv_specificityPrefix = go_self.Ikariam.serverCode;
  3129. 				  break;
  3130. 				
  3131. 				case _gec_SpecificityLevel.PLAYER:
  3132. 					rv_specificityPrefix = go_self.Ikariam.playerCode;
  3133. 				  break;
  3134. 			}
  3135. 			
  3136. 			return rv_specificityPrefix;
  3137. 		};
  3138. 		
  3139. 		/**
  3140. 		 * Add a element to a wrapper. ("generic function")
  3141. 		 * 
  3142. 		 * @private
  3143. 		 * @inner
  3144. 		 * 
  3145. 		 * @param	{String}		is_type
  3146. 		 *   The type of the element. Used for replacement - only elements with same type can be replaced.
  3147. 		 * @param	{String}		is_id
  3148. 		 *   The id of the element.
  3149. 		 * @param	{String}		is_wrapperId
  3150. 		 *   The id of the wrapper for the element.
  3151. 		 * @param	{(String|int)}	im_table
  3152. 		 *   The id of the table in the wrapper where the element should be added.
  3153. 		 * @param	{IkariamCore~Options~CreateCallback}	if_create
  3154. 		 *   Callback to create the element.
  3155. 		 * @param	{IkariamCore~Options~AddElementOptions}	io_options
  3156. 		 *   Options for the element.
  3157. 		 * 
  3158. 		 * @return	{Promise}
  3159. 		 *   A Promise which resolves once the element is added.
  3160. 		 */
  3161. 		var _addElement = async function(is_type, is_id, is_wrapperId, im_table, if_create, io_options) {
  3162. 			if(_go_savedOptions === null) {
  3163. 				_go_savedOptions = await go_self.myGM.getValue('optionPanel_options', {});
  3164. 			}
  3165. 			
  3166. 			if(_go_wrapper[is_wrapperId]) {
  3167. 				if(_go_wrapper[is_wrapperId].elements[is_id] && io_options.replace !== true) {
  3168. 					go_self.con.warn('Options.addElement: Element with id "' + is_id + '" already defined. Wrapper id: ' + is_wrapperId);
  3169. 				} else if(io_options.replace === true && _go_wrapper[is_wrapperId].elements[is_id] && _go_wrapper[is_wrapperId].elements[is_id].type === is_type) {
  3170. 					go_self.con.warn('Options.addElement: Element with id "' + is_id + '" not replaced. ' +
  3171. 							'Different type (old: ' + _go_wrapper[is_wrapperId].elements[is_id].type + ', new: ' + is_type + '). Wrapper id: ' + is_wrapperId);
  3172. 				} else {
  3173. 					var lo_options = io_options;
  3174. 					
  3175. 					if(lo_options.replace === true && !_go_wrapper[is_wrapperId].elements[is_id]) {
  3176. 						delete lo_options.replace;
  3177. 						go_self.con.info('Options.addElement: Element with id "' + is_id + '" not existant. Element was created instead of replaced. Wrapper id: ' + is_wrapperId);
  3178. 					}
  3179. 					
  3180. 					var lo_newElement = { table: im_table + '', create: if_create, specificity: (!!lo_options.specificity === true ? lo_options.specificity : _gec_SpecificityLevel.GLOBAL) };
  3181. 					if(lo_options.replace === true)
  3182. 						lo_newElement.specificity = _go_wrapper[is_wrapperId].elements[is_id].specificity;
  3183. 					
  3184. 					var ls_specificityPrefix = _getSpecificityPrefix(lo_newElement.specificity);
  3185. 					
  3186. 					if(!!lo_options.createOptions === true)
  3187. 						lo_newElement.options = lo_options.createOptions;
  3188. 					
  3189. 					if(lo_options.defaultValue !== undefined) {
  3190. 						lo_newElement.defaultValue	= lo_options.defaultValue;
  3191. 						
  3192. 						if(_go_savedOptions[is_wrapperId] && (_go_savedOptions[is_wrapperId][is_id] || _go_savedOptions[is_wrapperId][is_id] === false)) {
  3193. 							_go_options[is_wrapperId][is_id] = _go_savedOptions[is_wrapperId][is_id];
  3194. 							
  3195. 							if(ls_specificityPrefix.length > 0 && !_go_options[is_wrapperId][is_id][ls_specificityPrefix] && _go_options[is_wrapperId][is_id][ls_specificityPrefix] !== false) {
  3196. 								_go_options[is_wrapperId][is_id][ls_specificityPrefix] = lo_options.defaultValue;
  3197. 							}
  3198. 						} else {
  3199. 							if(ls_specificityPrefix.length > 0) {
  3200. 								_go_options[is_wrapperId][is_id] = {};
  3201. 								_go_options[is_wrapperId][is_id][ls_specificityPrefix] = lo_options.defaultValue;
  3202. 							} else {
  3203. 								_go_options[is_wrapperId][is_id] = lo_options.defaultValue;
  3204. 							}
  3205. 						}
  3206. 					}
  3207. 					
  3208. 					if(!!lo_options.saveCallback === true)
  3209. 						lo_newElement.save	= lo_options.saveCallback;
  3210. 					
  3211. 					if(!!lo_options.changeCallback === true) {
  3212. 						lo_newElement.changeCallback = lo_options.changeCallback;
  3213. 						
  3214. 						// Run the callback also when registering.
  3215. 						setTimeout(function() {
  3216. 							var lm_value = _go_options[is_wrapperId][is_id];
  3217. 							if(ls_specificityPrefix.length > 0)
  3218. 								lm_value = lm_value[ls_specificityPrefix];
  3219. 							lo_options.changeCallback(lm_value, lm_value);
  3220. 						}, 0);
  3221. 					}
  3222. 					
  3223. 					_go_wrapper[is_wrapperId].elements[is_id] = lo_newElement;
  3224. 					
  3225. 					if(lo_options.replace !== true) {
  3226. 						_go_wrapper[is_wrapperId].elementOrder.IC.insert(is_id, lo_options.position);
  3227. 					}
  3228. 				}
  3229. 			} else {
  3230. 				go_self.con.warn('Options.addElement: Wrapper with id "' + is_wrapperId + '" not defined. Element id: ' + is_id);
  3231. 			}
  3232. 		};
  3233. 		
  3234. 		/**
  3235. 		 * Save the content of <code>_go_options</code>.
  3236. 		 * 
  3237. 		 * @private
  3238. 		 * @inner
  3239. 		 * 
  3240. 		 * @param	{boolean}	showNoSuccessHint
  3241. 		 *   If the success hint should not be shown.
  3242. 		 */
  3243. 		var _saveOptions = function(ib_showNoSuccessHint) {
  3244. 			go_self.myGM.setValue('optionPanel_options', _go_options).then(function() {
  3245. 				_go_savedOptions = _go_options;
  3246. 				
  3247. 				if(!ib_showNoSuccessHint === true) {
  3248. 					go_self.Ikariam.showTooltip('cityAdvisor', 'confirm', go_self.Language.$('general.successful'));
  3249. 				}
  3250. 			});
  3251. 		};
  3252. 		
  3253. 		/**
  3254. 		 * Store the actual value of each option to <code>_option</code> and call <code>_saveOptions</code>.
  3255. 		 * 
  3256. 		 * @private
  3257. 		 * @inner
  3258. 		 */
  3259. 		var _savePanelOptions = function() {
  3260. 			// Store the value of each option element.
  3261. 			go_self.myGM.forEach(_go_wrapper, function(is_wrapperId, io_wrapper) {
  3262. 				go_self.myGM.forEach(io_wrapper.elements, function(is_elementId, io_element) {
  3263. 					if(io_element.save) {
  3264. 						var ls_specificityPrefix	= _getSpecificityPrefix(io_element.specificity);
  3265. 						var lm_oldValue				= _go_options[is_wrapperId][is_elementId];
  3266. 						var lm_newValue				= io_element.save(is_wrapperId + is_elementId);
  3267. 						
  3268. 						if(ls_specificityPrefix.length > 0) {
  3269. 							lm_oldValue														= lm_oldValue[ls_specificityPrefix];
  3270. 							_go_options[is_wrapperId][is_elementId][ls_specificityPrefix]	= lm_newValue;
  3271. 						} else {
  3272. 							_go_options[is_wrapperId][is_elementId] = lm_newValue;
  3273. 						}
  3274. 						
  3275. 						if(lm_newValue != lm_oldValue && io_element.changeCallback) {
  3276. 							setTimeout(function() { io_element.changeCallback(lm_newValue, lm_oldValue); }, 0);
  3277. 						}
  3278. 					}
  3279. 				});
  3280. 			});
  3281. 			
  3282. 			_saveOptions();
  3283. 		};
  3284. 		
  3285. 		/**
  3286. 		 * Initializes the options tab for the script and adds the scroll function to the tab menu.
  3287. 		 * 
  3288. 		 * @private
  3289. 		 * @inner
  3290. 		 * 
  3291. 		 * @return	{Promise}
  3292. 		 *   A Promise which resolves to the options tab for the script.
  3293. 		 */
  3294. 		var _initializeOptionsTab = async function() {
  3295. 			var re_tabScriptOptions = go_self.myGM.$('#tab_options' + go_self.myGM.prefix);
  3296. 			
  3297. 			if(!re_tabScriptOptions) {
  3298. 				go_self.myGM.addStyle(
  3299. 						"#tab_options" + go_self.myGM.prefix + " hr								{ margin: 0; } \
  3300. 						 #tab_options" + go_self.myGM.prefix + " .scriptTextArea				{ resize: none; width: calc(100% - 2px); height: 75px; } \
  3301. 						 #tab_options" + go_self.myGM.prefix + " .scriptTextField				{ width: 173px;	} \
  3302. 						 #tab_options" + go_self.myGM.prefix + " .cbWrapper						{ margin: 0 0 0 10px; } \
  3303. 						 #tab_options" + go_self.myGM.prefix + " .radioWrapper:not(:last-child)	{ margin-bottom: 2px; }",
  3304. 					'scriptOptionsTab', true);
  3305. 				
  3306. 				var le_tabmenu			= go_self.myGM.$('#tabMenu');
  3307. 				var le_nextPageLink		= go_self.myGM.$('.tabNextPage', le_tabmenu);
  3308. 				var la_pagerInformation	= le_nextPageLink.getAttribute('onclick').match(/switchPage\(([0-9]*), this, ([0-9]*)\)/);
  3309. 				var li_pageNumber		= go_self.Ikariam.getInt(la_pagerInformation[1]);
  3310. 				var li_offset			= go_self.Ikariam.getInt(la_pagerInformation[2]);
  3311. 				var li_newIndex			= go_self.myGM.$$('.tab[index]', le_tabmenu).length + 1;
  3312. 				var li_newPageNumber	= Math.ceil(li_newIndex / li_offset);
  3313. 				if(li_pageNumber < li_newPageNumber)
  3314. 					le_nextPageLink.classList.remove('invisible');
  3315. 				
  3316. 				var la_tabClasses = ['tab'];
  3317. 				if(li_pageNumber !== li_newPageNumber)
  3318. 					la_tabClasses.push('invisible');
  3319. 				
  3320. 				go_self.myGM.addElement('li', le_tabmenu, {
  3321. 					'id':			'js_tab_options' + go_self.myGM.prefix,
  3322. 					'classes':		la_tabClasses,
  3323. 					'index':		li_newIndex,
  3324. 					'innerHTML':	'<b class="tab_options' + go_self.myGM.prefix + '">' + go_script.name + '</b>',
  3325. 					'onclick':		"$('#js_tab_options" + go_self.myGM.prefix + "').removeClass('selected'); switchTab('tab_options" + go_self.myGM.prefix + "');"
  3326. 				}, false, le_nextPageLink);
  3327. 				
  3328. 				re_tabScriptOptions	= go_self.myGM.addElement('div', go_self.myGM.$('#tabMenu').parentNode, {
  3329. 					'id':		'tab_options' + go_self.myGM.prefix, 
  3330. 					'style':	[['display', 'none']]
  3331. 				}, false);
  3332. 			}
  3333. 			
  3334. 			_go_optionWrapperVisibility = await go_self.myGM.getValue('optionPanel_optionWrapperVisibility', _go_optionWrapperVisibility);
  3335. 			
  3336. 			return re_tabScriptOptions;
  3337. 		};
  3338. 		
  3339. 		/**
  3340. 		 * Add a wrapper for options elements to the script option tab.
  3341. 		 * 
  3342. 		 * @private
  3343. 		 * @inner
  3344. 		 * 
  3345. 		 * @param	{Element}	ie_tab
  3346. 		 *   The tab to add the wrapper to.
  3347. 		 * @param	{String}	is_id
  3348. 		 *   The id of the wrapper.
  3349. 		 * @param	{String}	is_headerText
  3350. 		 *   The text for the wrapper header.
  3351. 		 * 
  3352. 		 * @return	{Element}
  3353. 		 *   The wrapper.
  3354. 		 */
  3355. 		var _createOptionsWrapper = function(ie_tab, is_id, is_headerText) {
  3356. 			/*
  3357. 			 * Function to toggle the visibility of an wrapper.
  3358. 			 */
  3359. 			var lf_toggle = async function() {
  3360. 				go_self.myGM.toggleShowHideButton(this);
  3361. 				
  3362. 				go_self.myGM.$('.content', this.parentNode.parentNode).classList.toggle('invisible');
  3363. 				
  3364. 				var ls_optionId = this.parentNode.parentNode.id.replace(go_self.myGM.prefix, '');
  3365. 				_go_optionWrapperVisibility[ls_optionId] = !_go_optionWrapperVisibility[ls_optionId];
  3366. 				await go_self.myGM.setValue('optionPanel_optionWrapperVisibility', _go_optionWrapperVisibility);
  3367. 	
  3368. 				// Adjust the size of the Scrollbar.
  3369. 				go_self.ika.controller.adjustSizes();
  3370. 			};
  3371. 			
  3372. 			var ls_headerText = typeof is_headerText == 'string' ? is_headerText : go_self.Language.$(is_headerText.id);
  3373. 			
  3374. 			var lb_showContent		= !!_go_optionWrapperVisibility[is_id];
  3375. 			var le_optionsWrapper	= go_self.myGM.addElement('div', ie_tab, {'id': is_id, 'class': 'contentBox01h' });
  3376. 			var le_optionsHeader	= go_self.myGM.addElement('h3', le_optionsWrapper, { 'class': 'header', 'innerHTML': ls_headerText });
  3377. 			go_self.myGM.addElement('div', le_optionsHeader, {
  3378. 				'class':	lb_showContent ? 'minimizeImg' : 'maximizeImg',
  3379. 				'style':	[['cssFloat', 'left']],
  3380. 				'title':	lb_showContent ? go_self.Language.$('general.fold') : go_self.Language.$('general.expand'),
  3381. 				'click':	lf_toggle
  3382. 			});
  3383. 			
  3384. 			var re_optionsWrapperContent = go_self.myGM.addElement('div', le_optionsWrapper, { 'classes': lb_showContent ? ['content'] : ['content', 'invisible'] });
  3385. 			go_self.myGM.addElement('div', le_optionsWrapper, { 'class': 'footer' });
  3386. 			
  3387. 			return re_optionsWrapperContent;
  3388. 		};
  3389. 		
  3390. 		/**
  3391. 		 * Show the option script tab.
  3392. 		 * 
  3393. 		 * @private
  3394. 		 * @inner
  3395. 		 * 
  3396. 		 * @return	{Promise}
  3397. 		 *   A Promise which resolves once the option panel is shown.
  3398. 		 */
  3399. 		var _showOptionPanel = async function() {
  3400. 			var le_tab = await _initializeOptionsTab();
  3401. 			
  3402. 			for(var i = 0; i < _ga_wrapperOrder.length; i++) {
  3403. 				var ls_wrapperId		= _ga_wrapperOrder[i];
  3404. 				var lo_wrapperOptions	= _go_wrapper[ls_wrapperId];
  3405. 				var le_wrapper 			= _createOptionsWrapper(le_tab, ls_wrapperId, lo_wrapperOptions.headerText);
  3406. 				var lo_tables			= {};
  3407. 				
  3408. 				for(var j = 0; j < lo_wrapperOptions.elementOrder.length; j++) {
  3409. 					var ls_elementId		= lo_wrapperOptions.elementOrder[j];
  3410. 					var lo_elementOptions	= lo_wrapperOptions.elements[ls_elementId];
  3411. 					
  3412. 					if(!lo_tables[lo_elementOptions.table]) {
  3413. 						var le_table						= go_self.myGM.addElement('table', le_wrapper, { 'classes': ['moduleContent', 'table01'] });
  3414. 						lo_tables[lo_elementOptions.table]	= go_self.myGM.addElement('tbody', le_table);
  3415. 					}
  3416. 					
  3417. 					var ls_specificityPrefix	= _getSpecificityPrefix(lo_elementOptions.specificity);
  3418. 					var lo_options				= lo_elementOptions.options ? lo_elementOptions.options : null;
  3419. 					var lm_value				= (_go_options[ls_wrapperId] && (_go_options[ls_wrapperId][ls_elementId] || _go_options[ls_wrapperId][ls_elementId] == false)) ? _go_options[ls_wrapperId][ls_elementId] : null;
  3420. 					
  3421. 					if(ls_specificityPrefix.length > 0)
  3422. 						lm_value = lm_value[ls_specificityPrefix];
  3423. 					
  3424. 					lo_elementOptions.create(lo_tables[lo_elementOptions.table], ls_wrapperId + ls_elementId, lm_value, lo_options);
  3425. 				}
  3426. 				
  3427. 				go_self.myGM.addButton(le_wrapper, go_self.Language.$('core.optionPanel.save'), function() { setTimeout(_savePanelOptions, 0); });
  3428. 			}
  3429. 		};
  3430. 		
  3431. 		/**
  3432. 		 * Show the notification for exporting the options.
  3433. 		 * 
  3434. 		 * @private
  3435. 		 * @inner
  3436. 		 */
  3437. 		var _exportOptionsShowNotification = function() {
  3438. 			var ls_options = JSON.stringify(_go_options);
  3439. 			
  3440. 			var lo_notificationText = {
  3441. 				header:		go_self.Language.$('core.optionPanel.section.optionPanelOptions.label.exportNotification.header'),
  3442. 				bodyTop:	go_self.Language.$('core.optionPanel.section.optionPanelOptions.label.exportNotification.explanation'),
  3443. 				bodyBottom:	ls_options
  3444. 			};
  3445. 			
  3446. 			go_self.myGM.notification(lo_notificationText, null, { textarea: true, readonly: true, autoselect: true });
  3447. 		};
  3448. 		
  3449. 		/**
  3450. 		 * Callback for importing the options.
  3451. 		 * 
  3452. 		 * @private
  3453. 		 * @inner
  3454. 		 * 
  3455. 		 * @param	{Element}	ie_textarea
  3456. 		 *   The textarea with the options string to import.
  3457. 		 */
  3458. 		var _importOptionsCallback = function(ie_textarea) {
  3459. 			var ls_options = ie_textarea.value;
  3460. 			
  3461. 			if(ls_options) {
  3462. 				// Function for safer parsing.
  3463. 				var lf_safeParse = function(is_key, im_value) {
  3464. 					if(typeof im_value === 'function' || Object.prototype.toString.apply(im_value) === '[object function]') {
  3465. 						return im_value.toString();
  3466. 					}
  3467. 	
  3468. 					return im_value;
  3469. 				};
  3470. 				
  3471. 				try {
  3472. 					var lo_parsed = JSON.parse(ls_options, lf_safeParse);
  3473. 					
  3474. 					// Store the values in the script.
  3475. 					go_self.myGM.forEach(lo_parsed, function(is_wrapperKey, io_elements) {
  3476. 						go_self.myGM.forEach(io_elements, function(is_elementKey, im_setting) {
  3477. 							if(_go_options[is_wrapperKey] && (_go_options[is_wrapperKey][is_elementKey] || _go_options[is_wrapperKey][is_elementKey] == false) && Array.isArray(im_setting) === false) {
  3478. 								if(typeof im_setting !== 'object') {
  3479. 									_go_options[is_wrapperKey][is_elementKey] = im_setting;
  3480. 								} else if(_getSpecificityPrefix(_go_wrapper[is_wrapperKey].elements[is_elementKey].specificity).length > 0) {
  3481. 									go_self.myGM.forEach(im_setting, function(is_serverKey, im_serverSetting) {
  3482. 										if(Array.isArray(im_serverSetting) === false && typeof im_serverSetting !== 'object')
  3483. 											_go_options[is_wrapperKey][is_elementKey] = im_setting;
  3484. 									});
  3485. 								}
  3486. 							}
  3487. 						});
  3488. 					});
  3489. 					
  3490. 					_saveOptions();
  3491. 				} catch(lo_error) {
  3492. 					var lo_notificationText = {
  3493. 						header:	go_self.Language.$('core.optionPanel.section.optionPanelOptions.label.importError.header'),
  3494. 						body:	go_self.Language.$('core.optionPanel.section.optionPanelOptions.label.importError.explanation')
  3495. 					};
  3496. 					
  3497. 					go_self.con.error(lo_error);
  3498. 					go_self.myGM.notification(lo_notificationText);
  3499. 				}
  3500. 			}
  3501. 		};
  3502. 		
  3503. 		/**
  3504. 		 * Show the notification for importing the options.
  3505. 		 * 
  3506. 		 * @private
  3507. 		 * @inner
  3508. 		 */
  3509. 		var _importOptionsShowNotification = function() {
  3510. 			var lo_notificationText = {
  3511. 				header:		go_self.Language.$('core.optionPanel.section.optionPanelOptions.label.importNotification.header'),
  3512. 				bodyTop:	go_self.Language.$('core.optionPanel.section.optionPanelOptions.label.importNotification.explanation')
  3513. 			};
  3514. 	
  3515. 			var lo_notificationCallback = {
  3516. 				confirm:	_importOptionsCallback
  3517. 			};
  3518. 			
  3519. 			go_self.myGM.notification(lo_notificationText, lo_notificationCallback, { textarea: true });
  3520. 		};
  3521. 		
  3522. 		/**
  3523. 		 * Callback for resetting the options.
  3524. 		 * 
  3525. 		 * @private
  3526. 		 * @inner
  3527. 		 */
  3528. 		var _resetOptionsCallback = function() {
  3529. 			_go_options = {};
  3530. 			
  3531. 			// Store the default values.
  3532. 			go_self.myGM.forEach(_go_wrapper, function(is_wrapperKey, io_wrapper) {
  3533. 				_go_options[is_wrapperKey] = {};
  3534. 				
  3535. 				go_self.myGM.forEach(io_wrapper.elements, function(is_elementKey, io_element) {
  3536. 					if(io_element.defaultValue || io_element.defaultValue == false) {
  3537. 						var ls_specificityPrefix = _getSpecificityPrefix(io_element.specificity);
  3538. 						
  3539. 						if(ls_specificityPrefix.length > 0) {
  3540. 							_go_options[is_wrapperKey][is_elementKey] = {};
  3541. 							_go_options[is_wrapperKey][is_elementKey][ls_specificityPrefix] = io_element.defaultValue;
  3542. 						} else {
  3543. 							_go_options[is_wrapperKey][is_elementKey] = io_element.defaultValue;
  3544. 						}
  3545. 					}
  3546. 				});
  3547. 			});
  3548. 			
  3549. 			_saveOptions();
  3550. 		};
  3551. 		
  3552. 		/**
  3553. 		 * Show the notification for resetting the options.
  3554. 		 * 
  3555. 		 * @private
  3556. 		 * @inner
  3557. 		 */
  3558. 		var _resetOptionsShowNotification = function() {
  3559. 			var lo_notificationText = {
  3560. 				header:	go_self.Language.$('core.optionPanel.section.optionPanelOptions.label.resetNotification.header'),
  3561. 				body:	go_self.Language.$('core.optionPanel.section.optionPanelOptions.label.resetNotification.explanation')
  3562. 			};
  3563. 	
  3564. 			var lo_notificationCallback = {
  3565. 				confirm:	_resetOptionsCallback,
  3566. 				abort:		function() { return; }
  3567. 			};
  3568. 			
  3569. 			go_self.myGM.notification(lo_notificationText, lo_notificationCallback);
  3570. 		};
  3571. 		
  3572. 		/**
  3573. 		 * Create the export options link.
  3574. 		 * 
  3575. 		 * @private
  3576. 		 * @inner
  3577. 		 * 
  3578. 		 * @param	{Element}	ie_parent
  3579. 		 *   Parent element for the link.
  3580. 		 */
  3581. 		var _exportOptions = function(ie_parent) {
  3582. 			this.myGM.addElement('a', ie_parent, {
  3583. 				'href':			'javascript:;',
  3584. 				'innerHTML':	this.Language.$('core.optionPanel.section.optionPanelOptions.label.export'),
  3585. 				'click':		_exportOptionsShowNotification
  3586. 			});
  3587. 		};
  3588. 		
  3589. 		/**
  3590. 		 * Create the import options link.
  3591. 		 * 
  3592. 		 * @private
  3593. 		 * @inner
  3594. 		 * 
  3595. 		 * @param	{Element}	ie_parent
  3596. 		 *   Parent element for the link.
  3597. 		 */
  3598. 		var _importOptions = function(ie_parent) {
  3599. 			this.myGM.addElement('a', ie_parent, {
  3600. 				'href':			'javascript:;',
  3601. 				'innerHTML':	this.Language.$('core.optionPanel.section.optionPanelOptions.label.import'),
  3602. 				'click':		_importOptionsShowNotification
  3603. 			});
  3604. 		};
  3605. 		
  3606. 		/**
  3607. 		 * Create the reset options link.
  3608. 		 * 
  3609. 		 * @private
  3610. 		 * @inner
  3611. 		 * 
  3612. 		 * @param	{Element}	ie_parent
  3613. 		 *   Parent element for the link.
  3614. 		 */
  3615. 		var _resetOptions = function(ie_parent) {
  3616. 			this.myGM.addElement('a', ie_parent, {
  3617. 				'href':			'javascript:;',
  3618. 				'innerHTML':	this.Language.$('core.optionPanel.section.optionPanelOptions.label.reset'),
  3619. 				'click':		_resetOptionsShowNotification
  3620. 			});
  3621. 		};
  3622. 		
  3623. 		/*-------------------------------------------*
  3624. 		 * Public variables, functions and settings. *
  3625. 		 *-------------------------------------------*/
  3626. 		
  3627. 		/**
  3628. 		 * Enum for the level of specificity an option can have.
  3629. 		 * 
  3630. 		 * @instance
  3631. 		 * @readonly
  3632. 		 * @name	 SpecificityLevel
  3633. 		 * @memberof IkariamCore~Options
  3634. 		 * 
  3635. 		 * @enum	{IkariamCore~Options~SpecificityLevelEnum}
  3636. 		 */
  3637. 		Object.defineProperty(this, 'SpecificityLevel', { get: function() {
  3638. 			return _gec_SpecificityLevel;
  3639. 		} });
  3640. 		
  3641. 		/**
  3642. 		 * Add a wrapper to the list.
  3643. 		 * 
  3644. 		 * @instance
  3645. 		 * 
  3646. 		 * @param	{String}	is_id
  3647. 		 *   The id of the wrapper.
  3648. 		 * @param	{String}	is_headerText
  3649. 		 *   The text for the wrapper header.
  3650. 		 * @param	{int}		ii_position
  3651. 		 *   The position of the wrapper on the options tab. (optional)
  3652. 		 */
  3653. 		this.addWrapper = function(is_id, is_headerText, ii_position) {
  3654. 			if(_go_wrapper[is_id]) {
  3655. 				go_self.con.warn('Options.addWrapper: Wrapper with id "' + is_id + '" defined two times.');
  3656. 			} else {
  3657. 				_go_wrapper[is_id]	= { headerText: is_headerText, elements: {}, elementOrder: new Array() };
  3658. 				_go_options[is_id]	= {};
  3659. 				_ga_wrapperOrder.IC.insert(is_id, ii_position);
  3660. 			}
  3661. 		};
  3662. 		
  3663. 		/**
  3664. 		 * Add a new checkbox to the options tab.
  3665. 		 * 
  3666. 		 * @instance
  3667. 		 * 
  3668. 		 * @param	{String}		is_id
  3669. 		 *   The id of the checkbox.
  3670. 		 * @param	{String}		is_wrapperId
  3671. 		 *   The id of the wrapper.
  3672. 		 * @param	{(String|int)}	im_block
  3673. 		 *   The block of the wrapper, the checkbox belongs to.
  3674. 		 * @param	{boolean}		ib_defaultChecked
  3675. 		 *   If the checkbox is checked by default.
  3676. 		 * @param	{String}		im_label
  3677. 		 *   The text for the label.
  3678. 		 * @param	{IkariamCore~Options~DefaultElementOptions}	io_options
  3679. 		 *   Options for the checkbox.
  3680. 		 */
  3681. 		this.addCheckbox = function(is_id, is_wrapperId, im_block, ib_defaultChecked, is_label, io_options) {
  3682. 			/*
  3683. 			 * Function to save the checkbox value.
  3684. 			 */
  3685. 			var lf_save = function(is_elementId) {
  3686. 				return go_self.myGM.$('#' + go_self.myGM.prefix + is_elementId + 'Cb').checked;
  3687. 			};
  3688. 			
  3689. 			/*
  3690. 			 * Function to create the checkbox.
  3691. 			 */
  3692. 			var lf_create = function(ie_parentTable, is_elementId, ib_value, io_createOptions) {
  3693. 				var le_row		= go_self.myGM.addElement('tr', ie_parentTable);
  3694. 				var le_parent	= go_self.myGM.addElement('td', le_row, { 'colSpan': '2', 'class': 'left' });
  3695. 				
  3696. 				go_self.Ikariam.addCheckboxes(le_parent, [{ id: is_elementId, label: io_createOptions.label, checked: ib_value }]);
  3697. 			};
  3698. 			
  3699. 			var lo_options = {
  3700. 				createOptions:	{ label: is_label },
  3701. 				defaultValue:	ib_defaultChecked,
  3702. 				specificity:	io_options.specificity,
  3703. 				saveCallback:	lf_save,
  3704. 				changeCallback:	io_options.changeCallback,
  3705. 				position:		io_options.position,
  3706. 				replace:		io_options.replace
  3707. 			};
  3708. 			
  3709. 			_addElement('checkbox', is_id, is_wrapperId, im_block, lf_create, lo_options);
  3710. 		};
  3711. 		
  3712. 		/**
  3713. 		 * Add a new set of radio buttons to the options tab.
  3714. 		 * 
  3715. 		 * @instance
  3716. 		 * 
  3717. 		 * @param	{String}		is_id
  3718. 		 *   The id of the checkbox.
  3719. 		 * @param	{String}		is_wrapperId
  3720. 		 *   The id of the wrapper.
  3721. 		 * @param	{(String|int)}	im_block
  3722. 		 *   The block of the wrapper, the checkbox belongs to.
  3723. 		 * @param	{(String|int)}	im_defaultChecked
  3724. 		 *   The value selected by default.
  3725. 		 * @param	{String}		is_label
  3726. 		 *   The text for the label.<br>
  3727. 		 * @param	{IkariamCore~myGM~ValueAndLabel}			im_radioValues
  3728. 		 *   An array with the names an values of the options.
  3729. 		 * @param	{IkariamCore~Options~DefaultElementOptions}	io_options
  3730. 		 *   Options for the radio buttons.
  3731. 		 */
  3732. 		this.addRadios = function(is_id, is_wrapperId, im_block, im_defaultChecked, is_label, im_radioValues, io_options) {
  3733. 			/*
  3734. 			 * Function to save the radiobutton value.
  3735. 			 */
  3736. 			var lf_save = function(is_elementId) {
  3737. 				return go_self.myGM.getRadioValue(is_elementId);
  3738. 			};
  3739. 			
  3740. 			/*
  3741. 			 * Function to create the radiobuttons.
  3742. 			 */
  3743. 			var lf_create = function(ie_parentTable, is_elementId, im_value, io_createOptions) {
  3744. 				go_self.Ikariam.addRadios(ie_parentTable, is_elementId, im_value, io_createOptions.options, io_createOptions.label);
  3745. 			};
  3746. 			
  3747. 			var lo_options = {
  3748. 				createOptions:	{ label: is_label, options: im_radioValues },
  3749. 				defaultValue:	im_defaultChecked,
  3750. 				specificity:	io_options.specificity,
  3751. 				saveCallback:	lf_save,
  3752. 				changeCallback:	io_options.changeCallback,
  3753. 				position:		io_options.position,
  3754. 				replace:		io_options.replace
  3755. 			};
  3756. 			
  3757. 			_addElement('radio', is_id, is_wrapperId, im_block, lf_create, lo_options);
  3758. 		};
  3759. 		
  3760. 		
  3761. 		/**
  3762. 		 * Add a new select field to the options tab.
  3763. 		 * 
  3764. 		 * @instance
  3765. 		 * 
  3766. 		 * @param	{String}		is_id
  3767. 		 *   The id of the select field.
  3768. 		 * @param	{String}		is_wrapperId
  3769. 		 *   The id of the wrapper.
  3770. 		 * @param	{(String|int)}	im_block
  3771. 		 *   The block of the wrapper, the select field belongs to.
  3772. 		 * @param	{(String|int)}	im_defaultSelected
  3773. 		 *   The value of the option selected by default.
  3774. 		 * @param	{String}		is_label
  3775. 		 *   The text for the label.
  3776. 		 * @param	{IkariamCore~myGM~ValueAndLabel}			im_selectOptions
  3777. 		 *   An array with the labels and values of the options.
  3778. 		 * @param	{IkariamCore~Options~DefaultElementOptions}	io_options
  3779. 		 *   Options for the select field.
  3780. 		 */
  3781. 		this.addSelect = function(is_id, is_wrapperId, im_block, im_defaultSelected, is_label, im_selectOptions, io_options) {
  3782. 			/*
  3783. 			 * Function to save the select value.
  3784. 			 */
  3785. 			var lf_save = function(is_elementId) {
  3786. 				return go_self.myGM.getSelectValue(is_elementId);
  3787. 			};
  3788. 			
  3789. 			/*
  3790. 			 * Function to create the select.
  3791. 			 */
  3792. 			var lf_create = function(ie_parentTable, is_elementId, im_value, io_createOptions) {
  3793. 				go_self.Ikariam.addSelect(ie_parentTable, is_elementId, im_value, io_createOptions.options, io_createOptions.label);
  3794. 			};
  3795. 			
  3796. 			var lo_options = {
  3797. 				createOptions:	{ label: is_label, options: im_selectOptions },
  3798. 				defaultValue:	im_defaultSelected,
  3799. 				specificity:	io_options.specificity,
  3800. 				saveCallback:	lf_save,
  3801. 				changeCallback:	io_options.changeCallback,
  3802. 				position:		io_options.position,
  3803. 				replace:		io_options.replace
  3804. 			};
  3805. 			
  3806. 			_addElement('select', is_id, is_wrapperId, im_block, lf_create, lo_options);
  3807. 		};
  3808. 		
  3809. 		
  3810. 		/**
  3811. 		 * Add a new textfield to the options tab.
  3812. 		 * 
  3813. 		 * @instance
  3814. 		 * 
  3815. 		 * @param	{String}		is_id
  3816. 		 *   The id of the textfield.
  3817. 		 * @param	{String}		is_wrapperId
  3818. 		 *   The id of the wrapper.
  3819. 		 * @param	{(String|int)}	im_block
  3820. 		 *   The block of the wrapper, the textfield belongs to.
  3821. 		 * @param	{String}		is_defaultValue
  3822. 		 *   Default value of the textfield.
  3823. 		 * @param	{String}		is_label
  3824. 		 *   The text for the label.
  3825. 		 * @param	{IkariamCore~Options~TextFieldOptions}		io_options
  3826. 		 *   Options for the textfield.
  3827. 		 */
  3828. 		this.addTextField = function(is_id, is_wrapperId, im_block, is_defaultValue, is_label, io_options) {
  3829. 			/*
  3830. 			 * Function to save the textfield value.
  3831. 			 */
  3832. 			var lf_save = function(is_elementId) {
  3833. 				return go_self.myGM.$('#' + go_self.myGM.prefix + is_elementId + 'TextField').value;
  3834. 			};
  3835. 			
  3836. 			/*
  3837. 			 * Function to create the textfield.
  3838. 			 */
  3839. 			var lf_create = function(ie_parentTable, is_elementId, is_value, io_createOptions) {
  3840. 				var le_row				= go_self.myGM.addElement('tr', ie_parentTable);
  3841. 				var le_labelCell		= go_self.myGM.addElement('td', le_row);
  3842. 				var le_textFieldCell	= go_self.myGM.addElement('td', le_row, { 'class': 'left' });
  3843. 				
  3844. 				var ls_label = typeof io_createOptions.label == 'string' ? io_createOptions.label : go_self.Language.$(io_createOptions.label.id);
  3845.  
  3846. 				go_self.myGM.addElement('span', le_labelCell, { 'innerHTML': ls_label });
  3847. 				
  3848. 				var lo_options = {
  3849. 					'id':		is_elementId + 'TextField',
  3850. 					'classes':	['textfield', 'scriptTextField'],
  3851. 					'type':		'text',
  3852. 					'value':	is_value
  3853. 				};
  3854. 				
  3855. 				if(!!io_createOptions.maxlength === true)
  3856. 					lo_options['maxLength'] = io_createOptions.maxLength + '';
  3857. 					
  3858. 				if(!!io_createOptions.style === true)
  3859. 					lo_options['style'] = io_createOptions.style;
  3860. 				
  3861. 				go_self.myGM.addElement('input', le_textFieldCell, lo_options);
  3862. 			};
  3863. 			
  3864. 			var lo_options = {
  3865. 				createOptions:	{ label: is_label, maxLength: io_options.maxLength, style: io_options.style },
  3866. 				defaultValue:	is_defaultValue,
  3867. 				specificity:	io_options.specificity,
  3868. 				saveCallback:	lf_save,
  3869. 				changeCallback:	io_options.changeCallback,
  3870. 				position:		io_options.position,
  3871. 				replace:		io_options.replace
  3872. 			};
  3873. 			
  3874. 			_addElement('textfield', is_id, is_wrapperId, im_block, lf_create, lo_options);
  3875. 		};
  3876. 		
  3877. 		
  3878. 		/**
  3879. 		 * Add a new textarea to the options tab.
  3880. 		 * 
  3881. 		 * @instance
  3882. 		 * 
  3883. 		 * @param	{String}		is_id
  3884. 		 *   The id of the textarea.
  3885. 		 * @param	{String}		is_wrapperId
  3886. 		 *   The id of the wrapper.
  3887. 		 * @param	{(String|int)}	im_block
  3888. 		 *   The block of the wrapper, the textarea belongs to.
  3889. 		 * @param	{String}		is_defaultValue
  3890. 		 *   Default value of the textarea.
  3891. 		 * @param	{String}		is_label
  3892. 		 *   The text for the label.
  3893. 		 * @param	{IkariamCore~Options~TextAreaOptions}	io_options
  3894. 		 *   Options for the textarea.
  3895. 		 */
  3896. 		this.addTextArea = function(is_id, is_wrapperId, im_block, is_defaultValue, is_label, io_options) {
  3897. 			/*
  3898. 			 * Function to save the textarea value.
  3899. 			 */
  3900. 			var lf_save = function(ls_elementId) {
  3901. 				return go_self.myGM.$('#' + go_self.myGM.prefix + ls_elementId + 'TextArea').value;
  3902. 			};
  3903. 			
  3904. 			/*
  3905. 			 * Function to create the textarea.
  3906. 			 */
  3907. 			var lf_create = function(ie_parentTable, is_elementId, is_value, io_createOptions) {
  3908. 				var ls_label = typeof io_createOptions.label == 'string' ? io_createOptions.label : go_self.Language.$(io_createOptions.label.id);
  3909. 				
  3910. 				var le_labelRow		= go_self.myGM.addElement('tr', ie_parentTable);
  3911. 				var le_labelCell	= go_self.myGM.addElement('td', le_labelRow, { 'colSpan': '2', 'class': 'left' });
  3912. 				go_self.myGM.addElement('p', le_labelCell, { 'innerHTML': ls_label });
  3913. 				
  3914. 				var le_textAreaRow		= go_self.myGM.addElement('tr', ie_parentTable);
  3915. 				var le_textAreaCell		= go_self.myGM.addElement('td', le_textAreaRow, { 'colSpan': '2', 'class': 'left' });
  3916. 				
  3917. 				var lo_options = {
  3918. 					'id':			is_elementId + 'TextArea',
  3919. 					'classes':		['textfield', 'scriptTextArea'],
  3920. 					'innerHTML':	is_value
  3921. 				};
  3922. 				
  3923. 				if(!!io_createOptions.style === true)
  3924. 					lo_options['style'] = io_createOptions.style;
  3925. 				
  3926. 				go_self.myGM.addElement('textarea', le_textAreaCell, lo_options);
  3927. 			};
  3928. 			
  3929. 			var lo_options = {
  3930. 				createOptions:	{ label: is_label, style: io_options.style },
  3931. 				defaultValue:	is_defaultValue,
  3932. 				specificity:	io_options.specificity,
  3933. 				saveCallback:	lf_save,
  3934. 				changeCallback:	io_options.changeCallback,
  3935. 				position:		io_options.position,
  3936. 				replace:		io_options.replace
  3937. 			};
  3938. 			
  3939. 			_addElement('textarea', is_id, is_wrapperId, im_block, lf_create, lo_options);
  3940. 		};
  3941. 		
  3942. 		
  3943. 		/**
  3944. 		 * Add HTML content to the options tab.
  3945. 		 * 
  3946. 		 * @instance
  3947. 		 * 
  3948. 		 * @param	{String}		is_id
  3949. 		 *   The id of the HTML content.
  3950. 		 * @param	{String}		is_wrapperId
  3951. 		 *   The id of the wrapper.
  3952. 		 * @param	{(String|int)}	im_block
  3953. 		 *   The block of the wrapper, the HTML content belongs to.
  3954. 		 * @param	{IkariamCore~Options~HtmlOptions}	io_options
  3955. 		 *   Options for the html code.
  3956. 		 */
  3957. 		this.addHTML = function(is_id, is_wrapperId, im_block, io_options) {
  3958. 			/*
  3959. 			 * Function to create the html.
  3960. 			 */
  3961. 			var lf_create = function(ie_parentTable, is_elementId, im_value, io_createOptions) {
  3962. 				var le_htmlRow	= go_self.myGM.addElement('tr', ie_parentTable);
  3963. 				
  3964. 				var lo_options = {
  3965. 					'colSpan':	'2',
  3966. 					'class':	'center'
  3967. 				};
  3968. 				
  3969. 				if(!!io_createOptions.html === true)
  3970. 					lo_options['innerHTML'] = io_createOptions.html;
  3971. 					
  3972. 				var le_htmlCell	= go_self.myGM.addElement('td', le_htmlRow, lo_options);
  3973. 				
  3974. 				if(!!io_createOptions.callback === true)
  3975. 					io_createOptions.callback.call(io_createOptions.thisReference, le_htmlCell);
  3976. 			};
  3977. 			
  3978. 			var lo_options = {
  3979. 				createOptions:	{ html: io_options.html, callback: io_options.callback, thisReference: io_options.thisReference },
  3980. 				position:		io_options.position,
  3981. 				replace:		io_options.replace
  3982. 			};
  3983. 			
  3984. 			_addElement('html', is_id, is_wrapperId, im_block, lf_create, lo_options);
  3985. 		};
  3986. 		
  3987. 		
  3988. 		/**
  3989. 		 * Add a new horizontal line to the options tab.
  3990. 		 * 
  3991. 		 * @instance
  3992. 		 * 
  3993. 		 * @param	{String}			is_wrapperId
  3994. 		 *   The id of the wrapper.
  3995. 		 * @param	{(String|int)}		im_block
  3996. 		 *   The block of the wrapper, the horizontal line belongs to.
  3997. 		 * @param	{int}				ii_position
  3998. 		 *   The position of the horizontal line in the wrapper. (optional)
  3999. 		 *   
  4000. 		 * @return	{String}
  4001. 		 *   The id of the horizontal line.
  4002. 		 */
  4003. 		this.addLine = function(is_wrapperId, im_block, ii_position) {
  4004. 			/*
  4005. 			 * Function to create the horizontal line.
  4006. 			 */
  4007. 			var lf_create = function(ie_parentTable, is_elementId, im_value, io_options) {
  4008. 				var le_row		= go_self.myGM.addElement('tr', ie_parentTable);
  4009. 				var le_lineCell	= go_self.myGM.addElement('td', le_row, { 'colSpan': '2', 'class': 'left' });
  4010. 				
  4011. 				go_self.myGM.addElement('hr', le_lineCell);
  4012. 			};
  4013. 			
  4014. 			var rs_id		= 'hr' + _gi_lineId;
  4015. 			var lo_options	= {
  4016. 				position:		ii_position
  4017. 			};
  4018. 			
  4019. 			_addElement('line', rs_id, is_wrapperId, im_block, lf_create, lo_options);
  4020. 			_gi_lineId++;
  4021. 			
  4022. 			return rs_id;
  4023. 		};
  4024. 		
  4025. 		
  4026. 		/**
  4027. 		 * Deletes an wrapper with all option elements contained in it.
  4028. 		 * 
  4029. 		 * @instance
  4030. 		 * 
  4031. 		 * @param	{String}	is_id
  4032. 		 *   Id of the wrapper to delete.
  4033. 		 */
  4034. 		this.deleteWrapper = function(is_id) {
  4035. 			if(!_go_wrapper[is_id]) {
  4036. 				go_self.con.info('Options.deleteWrapper: Wrapper with id "' + is_id + '" does not exist.');
  4037. 			} else {
  4038. 				delete _go_wrapper[is_id];
  4039. 				delete _go_options[is_id];
  4040. 				
  4041. 				var li_position = -1;
  4042. 				
  4043. 				for(var i = 0; i < _ga_wrapperOrder.length; i++) {
  4044. 					if(_ga_wrapperOrder[i] == is_id) {
  4045. 						li_position = i;
  4046. 						break;
  4047. 					}
  4048. 				}
  4049. 				
  4050. 				_ga_wrapperOrder.IC.remove(li_position);
  4051. 			}
  4052. 		};
  4053. 		
  4054. 		
  4055. 		/**
  4056. 		 * Deletes an option element.
  4057. 		 * 
  4058. 		 * @instance
  4059. 		 * 
  4060. 		 * @param	{String}	is_wrapperId
  4061. 		 *   The id of the wrapper containing the element.
  4062. 		 * @param	{String}	is_elementId
  4063. 		 *   The id of the element to delete.
  4064. 		 */
  4065. 		this.deleteElement = function(is_wrapperId, is_elementId) {
  4066. 			if(!(_go_wrapper[is_wrapperId] && _go_wrapper[is_wrapperId].elements[is_elementId])) {
  4067. 				go_self.con.info('Options.deleteElement: Element with id "' + is_wrapperId + '_' + is_elementId + '" does not exist.');
  4068. 			} else {
  4069. 				delete _go_wrapper[is_wrapperId].elements[is_elementId];
  4070. 				delete _go_options[is_wrapperId][is_elementId];
  4071. 				
  4072. 				var li_position = -1;
  4073. 				
  4074. 				for(var i = 0; i < _go_wrapper[is_wrapperId].elementOrder.length; i++) {
  4075. 					if(_go_wrapper[is_wrapperId].elementOrder[i] == is_elementId) {
  4076. 						li_position = i;
  4077. 						break;
  4078. 					}
  4079. 				}
  4080. 				
  4081. 				_go_wrapper[is_wrapperId].elementOrder.IC.remove(li_position);
  4082. 			}
  4083. 		};
  4084. 		
  4085. 		/**
  4086. 		 * Get the stored value of an option.
  4087. 		 * 
  4088. 		 * @instance
  4089. 		 * 
  4090. 		 * @param	{String}	is_wrapperId
  4091. 		 *   Id of the wrapper of the option element.
  4092. 		 * @param	{String}	is_optionId
  4093. 		 *   Id of the option element.
  4094. 		 * 
  4095. 		 * @return	{(String|int|boolean)}
  4096. 		 *   The stored value.
  4097. 		 */
  4098. 		this.getOption = function(is_wrapperId, is_optionId) {
  4099. 			var ls_specificityPrefix = '';
  4100. 			if(_go_wrapper[is_wrapperId] && _go_wrapper[is_wrapperId].elements[is_optionId])
  4101. 				ls_specificityPrefix = _getSpecificityPrefix(_go_wrapper[is_wrapperId].elements[is_optionId].specificity);
  4102. 				
  4103. 			if(_go_options[is_wrapperId] && (_go_options[is_wrapperId][is_optionId] || _go_options[is_wrapperId][is_optionId] == false)) {
  4104. 				if(ls_specificityPrefix.length > 0)
  4105. 					return _go_options[is_wrapperId][is_optionId][ls_specificityPrefix];
  4106. 				
  4107. 				return _go_options[is_wrapperId][is_optionId];
  4108. 			}
  4109. 			
  4110. 			go_self.con.warn('Options.getOption: Option with id "' + is_wrapperId + '_' + is_optionId + '" not defined.');
  4111. 			return null;
  4112. 		};
  4113. 		
  4114. 		/**
  4115. 		 * Set the stored value of an option.
  4116. 		 * 
  4117. 		 * @instance
  4118. 		 * 
  4119. 		 * @param	{String}				is_wrapperId
  4120. 		 *   Id of the wrapper of the option element.
  4121. 		 * @param	{String}				is_optionId
  4122. 		 *   Id of the option element.
  4123. 		 * @param	{(String|int|boolean)}	im_value
  4124. 		 *   The value to store.
  4125. 		 */
  4126. 		this.setOption = function(is_wrapperId, is_optionId, im_value) {
  4127. 			var ls_specificityPrefix = _getSpecificityPrefix(_go_wrapper[is_wrapperId].elements[is_optionId].specificity);
  4128. 			
  4129. 			if(_go_options[is_wrapperId] && (_go_options[is_wrapperId][is_optionId] || _go_options[is_wrapperId][is_optionId] == false)) {
  4130. 				if(ls_specificityPrefix.length > 0)
  4131. 					_go_options[is_wrapperId][is_optionId][ls_specificityPrefix] = im_value;
  4132. 				else
  4133. 					_go_options[is_wrapperId][is_optionId] = im_value;
  4134. 			} else {
  4135. 				go_self.con.warn('Options.setOption: Option with id "' + is_wrapperId + '_' + is_optionId + '" not yet defined. Value "' + im_value + '" not stored.');
  4136. 			}
  4137. 			
  4138. 			_saveOptions(true);
  4139. 		};
  4140. 		
  4141. 		/*----------------------------------------*
  4142. 		 * Register the show option panel handler *
  4143. 		 *----------------------------------------*/
  4144. 		
  4145. 		// Register the option handler to show the options in the option panel.
  4146. 		go_self.RefreshHandler.add(['options', 'optionsAccount', 'optionsNotification', 'optionsIPSharing'], 'showOptionPanel', _showOptionPanel);
  4147. 		
  4148. 		/*-------------------------------*
  4149. 		 * Add the option panel options. *
  4150. 		 *-------------------------------*/
  4151. 		
  4152. 		this.addWrapper('optionPanelOptions', { id: 'core.optionPanel.section.optionPanelOptions.title' });
  4153. 		this.addHTML('exportOptions', 'optionPanelOptions', 'links', { thisReference: go_self, callback: _exportOptions });
  4154. 		this.addHTML('importOptions', 'optionPanelOptions', 'links', { thisReference: go_self, callback: _importOptions });
  4155. 		this.addHTML('resetOptions', 'optionPanelOptions', 'links', { thisReference: go_self, callback: _resetOptions });
  4156. 		
  4157. 		/*---------------------------------------------------------------------*
  4158. 		 * Types for documentation purposes (e.g. callback functions, objects) *
  4159. 		 *---------------------------------------------------------------------*/
  4160. 		
  4161. 		/**
  4162. 		 * Callback to get the value of an option from the element.
  4163. 		 * 
  4164. 		 * @callback	IkariamCore~Options~GetOption
  4165. 		 * 
  4166. 		 * @private
  4167. 		 * @inner
  4168. 		 * 
  4169. 		 * @param	{String}	elementId
  4170. 		 *   The id of the element which option should be retrieved.
  4171. 		 * 
  4172. 		 * @return	{(String|int|boolean)}
  4173. 		 *   The value of the option.
  4174. 		 */
  4175. 		
  4176. 		/**
  4177. 		 * Options for the generic <code>_addElement</code> function.
  4178. 		 * 
  4179. 		 * @typedef	IkariamCore~Options~AddElementOptions
  4180. 		 * 
  4181. 		 * @private
  4182. 		 * @inner
  4183. 		 * 
  4184. 		 * @mixes	IkariamCore~Options~DefaultElementOptions
  4185. 		 * 
  4186. 		 * @property	{?*}								[createOptions]	- Options to pass to the create element function.
  4187. 		 * @property	{?(String|int|boolean)}				[defaultValue]	- Default value of the option. Needed to enable loading of stored option!
  4188. 		 * @property	{?IkariamCore~Options~GetOption}	[saveCallback]	- Callback to get the value of an option from the element.
  4189. 		 */
  4190. 		
  4191. 		/**
  4192. 		 * Callback to create an option element.
  4193. 		 * 
  4194. 		 * @callback	IkariamCore~Options~CreateCallback
  4195. 		 * 
  4196. 		 * @private
  4197. 		 * @inner
  4198. 		 * 
  4199. 		 * @param	{Element}				parentTable
  4200. 		 *   The parent table of the option element.
  4201. 		 * @param	{String}				elementId
  4202. 		 *   The id of the option element.
  4203. 		 * @param	{(String|int|boolean)}	value
  4204. 		 *   The value of the option element.
  4205. 		 * @param	{*}						options
  4206. 		 *   Options needed to create this option element.
  4207. 		 */
  4208. 		
  4209. 		/**
  4210. 		 * Callback if the value of an option is changed.
  4211. 		 * 
  4212. 		 * @callback	IkariamCore~Options~ChangeCallback
  4213. 		 * 
  4214. 		 * @param	{(String|int|boolean)}	newValue
  4215. 		 *   The new value of the option.
  4216. 		 * @param	{(String|int|boolean)}	oldValue
  4217. 		 *   The old value of the option.
  4218. 		 */
  4219. 		
  4220. 		/**
  4221. 		 * Default options for elements.
  4222. 		 * 
  4223. 		 * @typedef	{Object}	IkariamCore~Options~DefaultElementOptions
  4224. 		 * 
  4225. 		 * @property	{?int}									[specificity=IkariamCore.SpecificityLevel.GLOBAL]	- If the option should be stored globally or for for each server / player specific. Not changable during replacement! Possible values: {@link IkariamCore~Options~SpecificityLevelEnum}
  4226. 		 * @property	{?IkariamCore~Options~ChangeCallback}	[changeCallback]									- Callback if the value of an option is changed.
  4227. 		 * @property	{?int}									[position=array.length]								- Position of the element in the element array. Not changable during replacement!
  4228. 		 * @property	{?boolean}								[replace=false]										- Replace the element with the same name if it has the same type.
  4229. 		 */
  4230. 		
  4231. 		/**
  4232. 		 * Options for text fields.
  4233. 		 * 
  4234. 		 * @typedef	{Object}	IkariamCore~Options~TextFieldOptions
  4235. 		 * 
  4236. 		 * @mixes	IkariamCore~Options~DefaultElementOptions
  4237. 		 * 
  4238. 		 * @property	{?int}							[maxLength]	- The maximum length of the input text.
  4239. 		 * @property	{?IkariamCore~myGM~CssStyles}	[style]		- Special styles to be applied to the element.
  4240. 		 */
  4241. 		
  4242. 		/**
  4243. 		 * Options for text areas.
  4244. 		 * 
  4245. 		 * @typedef	{Object}	IkariamCore~Options~TextAreaOptions
  4246. 		 * 
  4247. 		 * @mixes	IkariamCore~Options~DefaultElementOptions
  4248. 		 * 
  4249. 		 * @property	{?IkariamCore~myGM~CssStyles}	[style]	- Special styles to be applied to the element.
  4250. 		 */
  4251. 		
  4252. 		/**
  4253. 		 * Callback to run after setting the HTML string. Can also be used to create the HTML content.
  4254. 		 * 
  4255. 		 * @callback	IkariamCore~Options~HtmlCreateCallback
  4256. 		 * 
  4257. 		 * @param	{Element}	parent
  4258. 		 *   The parent element of the custom html.
  4259. 		 */
  4260. 		
  4261. 		/**
  4262. 		 * Options for custom html.
  4263. 		 * 
  4264. 		 * @typedef	{Object}	IkariamCore~Options~HtmlOptions
  4265. 		 * 
  4266. 		 * @property	{?String}									[html]					- HTML string to add to the wrapper.
  4267. 		 * @property	{?IkariamCore~Options~HtmlCreateCallback}	[callback]				- Callback to run after setting the HTML string. Can also be used to create the HTML content.
  4268. 		 * @property	{?*}										[thisReference]			- Reference to an object which should be referenced by <code>this</code> in the callback as it is not possible to use some objects. (e.g. go_self)
  4269. 		 * @property	{?int}										[position=array.length]	- Position of the element in the element array. Not changable during replacement!
  4270. 		 * @property	{?boolean}									[replace=false]			- Replace the element with the same name if it has the same type.
  4271. 		 */
  4272. 		
  4273. 		/**
  4274. 		 * Enum for the level of specificity an option can have.
  4275. 		 * 
  4276. 		 * @typedef	{Enum}	IkariamCore~Options~SpecificityLevelEnum
  4277. 		 * 
  4278. 		 * @property	{int}	GLOBAL - option is globally set.
  4279. 		 * @property	{int}	SERVER - option is set for each server specifically.
  4280. 		 * @property	{int}	PLAYER - option is set for each player specifically.
  4281. 		 */
  4282. 	}
  4283. 	
  4284. 	/**
  4285. 	 * Handler for options the user can set / change.
  4286. 	 * 
  4287. 	 * @instance
  4288. 	 * 
  4289. 	 * @type	IkariamCore~Options
  4290. 	 */
  4291. 	this.Options = new Options();
  4292. 	
  4293. 	this.con.logTimeStamp('IkariamCore.Options created');
  4294. 	
  4295. 	/**
  4296. 	 * Instantiate a new set of updating functions and start an initial update check.
  4297. 	 * 
  4298. 	 * @inner
  4299. 	 * 
  4300. 	 * @class
  4301. 	 * @classdesc	Functions for checking for updates for the script.
  4302. 	 */
  4303. 	function Updater() {
  4304. 		/*--------------------------------------------*
  4305. 		 * Private variables, functions and settings. *
  4306. 		 *--------------------------------------------*/
  4307. 		
  4308. 		/**
  4309. 		 * Stores if the update check was started by the user.
  4310. 		 * 
  4311. 		 * @private
  4312. 		 * @inner
  4313. 		 * 
  4314. 		 * @default false
  4315. 		 * 
  4316. 		 * @type	boolean
  4317. 		 */ 
  4318. 		var _gb_manualUpdate = false;
  4319. 		
  4320. 		/**
  4321. 		 * Types for entries in update history. Translations have to be provided as translation
  4322. 		 * in <code>core.update.possible.type.typeName</code><br>
  4323. 		 * Default values which are always set:<br>
  4324. 		 * "release" => release date<br>
  4325. 		 * "other" => entries which type is unknown
  4326. 		 * 
  4327. 		 * @private
  4328. 		 * @inner
  4329. 		 * 
  4330. 		 * @default ['feature', 'change', 'bugfix', 'language', 'core']
  4331. 		 * 
  4332. 		 * @type	Array.<String>
  4333. 		 */ 
  4334. 		var _ga_updateHistoryEntryTypes = ['feature', 'change', 'bugfix', 'language', 'core'];
  4335. 	
  4336. 		/**
  4337. 		 * Compares two versions and returns if there is a new version.
  4338. 		 * 
  4339. 		 * @private
  4340. 		 * @inner
  4341. 		 * 
  4342. 		 * @param	{String}	is_versionOld
  4343. 		 *   The old version number.
  4344. 		 * @param	{String}	is_versionNew
  4345. 		 *   The new version number.
  4346. 		 * @param	{?int}		[ii_maxPartsToCompare=infinite]
  4347. 		 *   The number of parts to compare at most.
  4348. 		 *
  4349. 		 * @return	{boolean}
  4350. 		 *   If a new version is available.
  4351. 		 */
  4352. 		var _newerVersion = function(is_versionOld, is_versionNew, ii_maxPartsToCompare) {
  4353. 			var rb_newVersion = false;
  4354. 	
  4355. 			is_versionOld += '';
  4356. 			is_versionNew += '';
  4357. 	
  4358. 			var la_versionOldParts = is_versionOld.split('.');
  4359. 			var la_versionNewParts = is_versionNew.split('.');
  4360. 	
  4361. 			var li_biggerNumberOfParts = la_versionOldParts.length > la_versionNewParts.length ? la_versionOldParts.length : la_versionNewParts.length;
  4362. 	
  4363. 			if(!ii_maxPartsToCompare || ii_maxPartsToCompare < 1) {
  4364. 				ii_maxPartsToCompare = li_biggerNumberOfParts + 1;
  4365. 			}
  4366. 	
  4367. 			for(var i = 0; i < li_biggerNumberOfParts; i++) {
  4368. 				var li_versionPartOld = parseInt(la_versionOldParts[i] || 0);
  4369. 				var li_versionPartNew = parseInt(la_versionNewParts[i] || 0);
  4370. 	
  4371. 				if(li_versionPartOld < li_versionPartNew) {
  4372. 					rb_newVersion = true;
  4373. 					break;
  4374. 				} else if(li_versionPartOld > li_versionPartNew || i == ii_maxPartsToCompare - 1) {
  4375. 					rb_newVersion = false;
  4376. 					break;
  4377. 				}
  4378. 			}
  4379. 	
  4380. 			return rb_newVersion;
  4381. 		};
  4382. 		
  4383. 		/**
  4384. 		 * Extract the update history from the metadata.
  4385. 		 * 
  4386. 		 * @private
  4387. 		 * @inner
  4388. 		 * 
  4389. 		 * @param	{Object.<String, Array.<String>>}	io_metadata
  4390. 		 *   Array with the formatted metadata.
  4391. 		 *
  4392. 		 * @return	{Object.<String, Object.<String, Array.<String>>>}
  4393. 		 *   The extracted update history.<br>
  4394. 		 *   Structure: <code>{ &lt;version&gt;: { &lt;type&gt;: [ &lt;notes&gt; ] }}</code>
  4395. 		 */
  4396. 		var _extractUpdateHistory = function(io_metadata) {
  4397. 			var ro_updateHistory = {};
  4398. 	
  4399. 			for(var i = 0; i < io_metadata['history'].length; i++) {
  4400. 				// Get the information from the update history data.
  4401. 				var la_history_entry = io_metadata['history'][i].match(/^(\S+)\s+(\S+)\s+(.*)$/);
  4402. 				
  4403. 				var ls_version		= la_history_entry[1];
  4404. 				var ls_type			= la_history_entry[2];
  4405. 				var ls_type_trimmed	= ls_type.IC.trim(':').toLowerCase();
  4406. 				var ls_info			= la_history_entry[3];
  4407. 	
  4408. 				if(!ro_updateHistory[ls_version]) {
  4409. 					ro_updateHistory[ls_version] = {};
  4410. 				}
  4411. 				
  4412. 				if(ls_type_trimmed == 'release') {
  4413. 					ro_updateHistory[ls_version]['release'] = ls_info;
  4414. 				} else if(_ga_updateHistoryEntryTypes.indexOf(ls_type_trimmed) > -1) {
  4415. 					if(!ro_updateHistory[ls_version][ls_type_trimmed]) {
  4416. 						ro_updateHistory[ls_version][ls_type_trimmed] = new Array(ls_info);
  4417. 					} else {
  4418. 						ro_updateHistory[ls_version][ls_type_trimmed].push(ls_info);
  4419. 					}
  4420. 				} else {
  4421. 					if(!ro_updateHistory[ls_version]['other']) {
  4422. 						ro_updateHistory[ls_version]['other'] = new Array(ls_type + " " + ls_info);
  4423. 					} else {
  4424. 						ro_updateHistory[ls_version]['other'].push(ls_type + " " + ls_info);
  4425. 					}
  4426. 				}
  4427. 			}
  4428. 	
  4429. 			// Return the update history.
  4430. 			return ro_updateHistory;
  4431. 		};
  4432. 		
  4433. 		/**
  4434. 		 * Format the update history using some HTML codes.
  4435. 		 * 
  4436. 		 * @private
  4437. 		 * @inner
  4438. 		 * 
  4439. 		 * @param	{Object.<String, Object.<String, Array.<String>>>}	io_updateHistory
  4440. 		 *   The update history.<br>
  4441. 		 *   Structure: <code>{ &lt;version&gt;: { &lt;type&gt;: [ &lt;notes&gt; ] }}</code>
  4442. 		 *
  4443. 		 * @return	{String}
  4444. 		 *   The formated update history.
  4445. 		 */
  4446. 		var _formatUpdateHistory = function(io_updateHistory) {
  4447. 			var rs_formattedUpdateHistory = '';
  4448. 			
  4449. 			for(var ls_version in io_updateHistory) {
  4450. 				if(Object.prototype.hasOwnProperty.call(io_updateHistory, ls_version)) {
  4451. 					rs_formattedUpdateHistory += '<h2>v' + ls_version + '</h2><span class="smallFont">' + io_updateHistory[ls_version]['release'] + '</span></small><br><table class="' + go_self.myGM.prefix + 'updateTable"><tbody>';
  4452. 		
  4453. 					for(var ls_type in io_updateHistory[ls_version]) {
  4454. 						if(Object.prototype.hasOwnProperty.call(io_updateHistory[ls_version], ls_type) && ls_type != 'release') {
  4455. 							rs_formattedUpdateHistory += '<tr><td class="' + go_self.myGM.prefix + 'updateDataType">' + go_self.Language.$('core.update.possible.type.' + ls_type) + '</td><td class="' + go_self.myGM.prefix + 'updateDataInfo"><ul>';
  4456. 			
  4457. 							for(var i = 0 ; i < io_updateHistory[ls_version][ls_type].length; i++) {
  4458. 								rs_formattedUpdateHistory += '<li>' + io_updateHistory[ls_version][ls_type][i] + '</li>';
  4459. 							}
  4460. 			
  4461. 							rs_formattedUpdateHistory += '</ul></td></tr>';
  4462. 						}
  4463. 					}
  4464. 		
  4465. 					rs_formattedUpdateHistory += '</tbody></table><br>';
  4466. 				}
  4467. 			}
  4468. 			
  4469. 			if(rs_formattedUpdateHistory.length === 0) {
  4470. 				rs_formattedUpdateHistory = '<b>' + go_self.Language.$('core.update.possible.noHistory') + '</b>';
  4471. 			} else {
  4472. 				rs_formattedUpdateHistory = '<b><u>' + go_self.Language.$('core.update.possible.history') + '</u></b><br><br>' + rs_formattedUpdateHistory;
  4473. 			}
  4474. 	
  4475. 			return rs_formattedUpdateHistory;
  4476. 		};
  4477. 		
  4478. 		/**
  4479. 		 * Show the update information panel.
  4480. 		 * 
  4481. 		 * @private
  4482. 		 * @inner
  4483. 		 * 
  4484. 		 * @param	{Object.<String, Array.<String>>}	io_metadata
  4485. 		 *   Array with formatted metadata.
  4486. 		 */
  4487. 		var _showUpdateInfo = function(io_metadata) {
  4488. 			var lo_updateHistory = _extractUpdateHistory(io_metadata);
  4489. 	
  4490. 			var lo_notificationText = {
  4491. 				header:		go_self.Language.$('core.update.possible.header'),
  4492. 				bodyTop:	go_self.Language.$('core.update.possible.text', ['<a href="https://greatest.deepsurf.us/scripts/' + go_script.id + '" target="_blank" >' + go_script.name + '</a>', go_script.version, io_metadata.version]) + '<br>&nbsp;',
  4493. 				bodyBottom:	_formatUpdateHistory(lo_updateHistory),
  4494. 				confirm:	go_self.Language.$('core.update.possible.button.install'),
  4495. 				abort:		go_self.Language.$('core.update.possible.button.hide')
  4496. 			};
  4497. 	
  4498. 			var lo_notificationCallback = {
  4499. 				confirm:	function() { go_self.win.top.location.href = 'https://greatest.deepsurf.us/scripts/' + go_script.id + '/code/' + go_script.id + '.user.js'; },
  4500. 				abort:		function() { go_self.myGM.setValue('updater_hideUpdate', io_metadata.version + ''); }
  4501. 			};
  4502. 	
  4503. 			go_self.myGM.notification(lo_notificationText, lo_notificationCallback);
  4504. 		};
  4505. 	
  4506. 		/**
  4507. 		 * Format the given metadata.
  4508. 		 * 
  4509. 		 * @private
  4510. 		 * @inner
  4511. 		 * 
  4512. 		 * @param	{String}	is_metadata
  4513. 		 *   The metadata to format.
  4514. 		 *
  4515. 		 * @return	{Object.<String, Array.<String>>}
  4516. 		 *   The formatted metadata.
  4517. 		 */
  4518. 		var _formatMetadata = function(is_metadata) {
  4519. 			var rs_metadata = new Array();
  4520. 	
  4521. 			// Extract the tags from the metadata.
  4522. 			var ls_innerMetadata = is_metadata.match(/\/\/ ==UserScript==((.|\n|\r)*?)\/\/ ==\/UserScript==/)[0];
  4523. 	
  4524. 			if(ls_innerMetadata) {
  4525. 				// Extract all tags.
  4526. 				var la_metadata_entries = ls_innerMetadata.match(/\/\/ @(.*?)(\n|\r)/g);
  4527. 	
  4528. 				for(var i = 0; i < la_metadata_entries.length; i++) {
  4529. 					// Extract the data from the tag.
  4530. 					var la_metadata_entry = la_metadata_entries[i].match(/\/\/ @(.*?)\s+(.*)/);
  4531. 	
  4532. 					if(!rs_metadata[la_metadata_entry[1]]) {
  4533. 						rs_metadata[la_metadata_entry[1]] = new Array(la_metadata_entry[2]);
  4534. 					} else {
  4535. 						rs_metadata[la_metadata_entry[1]].push(la_metadata_entry[2]);
  4536. 					}
  4537. 				}
  4538. 			}
  4539. 	
  4540. 			return rs_metadata;
  4541. 		};
  4542. 		
  4543. 		/*-------------------------------------------*
  4544. 		 * Public variables, functions and settings. *
  4545. 		 *-------------------------------------------*/
  4546. 		
  4547. 		/**
  4548. 		 * Check for updates for the script. Automatically done on every instantiation of {@link IkariamCore}
  4549. 		 * if the period from the last update is bigger than the check interval.
  4550. 		 * 
  4551. 		 * @instance
  4552. 		 * 
  4553. 		 * @return	{Promise}
  4554. 		 *   A Promise which resolves once the update check url is called.
  4555. 		 */
  4556. 		this.checkForUpdates = async function() {
  4557. 			// Send a request to the script hosting server to get the metadata of the script to check if there is a new update.
  4558. 			var lb_notPossible = await go_self.myGM.xhr({
  4559. 					method: 'GET',
  4560. 					url: 'https://greatest.deepsurf.us/scripts/' + go_script.id + '/code.meta.js',
  4561. 					headers: {'User-agent': 'Mozilla/5.0', 'Accept': 'text/html'},
  4562. 					onload: async function(io_response) {
  4563. 						var lo_metadata = _formatMetadata(io_response.responseText);
  4564. 						
  4565. 						if(_newerVersion(go_script.version, lo_metadata.version, go_self.Options.getOption('updateOptions', 'updateNotifyLevel')) && (await go_self.myGM.getValue('updater_hideUpdate', go_script.version) != lo_metadata.version || _gb_manualUpdate)) {
  4566. 							_showUpdateInfo(lo_metadata);
  4567. 						} else if(_gb_manualUpdate)	{
  4568. 							var lo_notificationText = {
  4569. 								header:	go_self.Language.$('core.update.noNewExists.header'),
  4570. 								body:	go_self.Language.$('core.update.noNewExists.text', ['<a href="https://greatest.deepsurf.us/scripts/' + go_script.id + '" target="_blank" >' + go_script.name + '</a>', go_script.version])
  4571. 							};
  4572. 	
  4573. 							go_self.myGM.notification(lo_notificationText);
  4574. 						}
  4575. 					}
  4576. 				});
  4577. 			
  4578. 			if(lb_notPossible && lb_notPossible == true) {
  4579. 				go_self.Options.setOption('updateOptions', 'updateInterval', 2419200);
  4580.  
  4581. 				var lo_notificationText = {
  4582. 					header:	go_self.Language.$('core.update.notPossible.header'),
  4583. 					body:	go_self.Language.$('core.update.notPossible.text', ['<a href="https://greatest.deepsurf.us/scripts/' + go_script.id + '" target="_blank" >' + go_script.name + '</a>', go_script.version])
  4584. 				};
  4585.  
  4586. 				go_self.myGM.notification(lo_notificationText);
  4587. 			}
  4588. 		};
  4589. 		
  4590. 		/**
  4591. 		 * Search manually for updates. Forces to search for updates. Even shows a popup if no new update is available.
  4592. 		 * 
  4593. 		 * @instance
  4594. 		 */
  4595. 		this.doManualUpdate = function() {
  4596. 			_gb_manualUpdate = true;
  4597. 			go_self.myGM.setValue('updater_lastUpdateCheck', (new Date()).getTime() + '').then(function() { go_self.Updater.checkForUpdates(); });
  4598. 		};
  4599. 		
  4600. 		/**
  4601. 		 * Set the possible entries for update history entries. "release" for the release date and "other" 
  4602. 		 * for all entries which are not known will be stipped as they are default. Translations have to be 
  4603. 		 * provided as translation in <code>core.update.possible.type.typeName</code>
  4604. 		 * 
  4605. 		 * @instance
  4606. 		 * 
  4607. 		 * @param	{Array.<String>}	ia_updateHistoryEntryTypes
  4608. 		 *   The array with the update history entries to set.
  4609. 		 */
  4610. 		this.setUpdateHistoryEntryTypes = function(ia_updateHistoryEntryTypes) {
  4611. 			['release', 'other'].forEach(function(is_toStrip) {
  4612. 				var li_index = ia_updateHistoryEntryTypes.indexOf('release');
  4613. 				if(li_index !== -1)
  4614. 					ia_updateHistoryEntryTypes.IC.remove(li_index);
  4615. 			});
  4616. 			
  4617. 			_ga_updateHistoryEntryTypes = ia_updateHistoryEntryTypes;
  4618. 		};
  4619. 		
  4620. 		/*------------------------*
  4621. 		 * Add the updater styles *
  4622. 		 *------------------------*/
  4623. 		
  4624. 		go_self.myGM.addStyle(
  4625. 				"." + go_self.myGM.prefix + "updateTable			{ border-collapse: separate; border-spacing: 2px; } \
  4626. 				 ." + go_self.myGM.prefix + "updateDataType			{ width: 100px; padding: 5px 0px 5px 5px; border: 1px solid #D2A860; } \
  4627. 				 ." + go_self.myGM.prefix + "updateDataInfo			{ width: 300px; padding: 5px 5px 5px 20px; border: 1px solid #D2A860; } \
  4628. 				 ." + go_self.myGM.prefix + "updateDataInfo ul li	{ list-style: disc outside none; }",
  4629. 				'updater', true
  4630. 			);
  4631. 		
  4632. 		/*----------------------*
  4633. 		 * Register the options *
  4634. 		 *----------------------*/
  4635. 		
  4636. 		var _ga_updateIntervalOpts = new Array(
  4637. 				{ value: -1,		label: { id: 'core.optionPanel.section.update.label.interval.option.never' }	},
  4638. 				{ value: 3600,		label: { id: 'core.optionPanel.section.update.label.interval.option.hour' }		},
  4639. 				{ value: 43200,		label: { id: 'core.optionPanel.section.update.label.interval.option.hour12' }	},
  4640. 				{ value: 86400,		label: { id: 'core.optionPanel.section.update.label.interval.option.day' }		},
  4641. 				{ value: 259200,	label: { id: 'core.optionPanel.section.update.label.interval.option.day3' }		},
  4642. 				{ value: 604800,	label: { id: 'core.optionPanel.section.update.label.interval.option.week' }		},
  4643. 				{ value: 1209600,	label: { id: 'core.optionPanel.section.update.label.interval.option.week2' }	},
  4644. 				{ value: 2419200,	label: { id: 'core.optionPanel.section.update.label.interval.option.week4' }	}
  4645. 			);
  4646. 		
  4647. 		var _ga_updateNotifyLevelOpts = new Array(
  4648. 				{ value: 0,	label: { id: 'core.optionPanel.section.update.label.notifyLevel.option.all' }	},
  4649. 				{ value: 1,	label: { id: 'core.optionPanel.section.update.label.notifyLevel.option.major' }	},
  4650. 				{ value: 2,	label: { id: 'core.optionPanel.section.update.label.notifyLevel.option.minor' }	},
  4651. 				{ value: 3,	label: { id: 'core.optionPanel.section.update.label.notifyLevel.option.patch' }	}
  4652. 			);
  4653. 		
  4654. 		var _searchUpdates = function(ie_parent) {
  4655. 			var ls_updateLink = this.Language.$('core.optionPanel.section.update.label.manual', [go_script.name]);
  4656. 			this.myGM.addElement('a', ie_parent, { 'href': 'javascript:;', 'innerHTML': ls_updateLink, 'click': go_self.Updater.doManualUpdate });
  4657. 		};
  4658. 		
  4659. 		go_self.Options.addWrapper('updateOptions', { id: 'core.optionPanel.section.update.title' }, 1);
  4660. 		go_self.Options.addSelect('updateInterval', 'updateOptions', 'generalOptions', 3600, { id: 'core.optionPanel.section.update.label.interval.description' }, _ga_updateIntervalOpts, {});
  4661. 		go_self.Options.addSelect('updateNotifyLevel', 'updateOptions', 'generalOptions', 0, { id: 'core.optionPanel.section.update.label.notifyLevel.description' }, _ga_updateNotifyLevelOpts, {});
  4662. 		go_self.Options.addHTML('manualUpdateLink', 'updateOptions', 'manualUpdate', { thisReference: go_self, callback: _searchUpdates });
  4663. 		
  4664. 		/*-------------------------------------*
  4665. 		 * Check automatically for new updates *
  4666. 		 *-------------------------------------*/
  4667. 		
  4668. 		setTimeout(async function() {
  4669. 			var li_lastCheck	= await go_self.myGM.getValue('updater_lastUpdateCheck', 0);
  4670. 			var li_millis		= (new Date()).getTime();
  4671. 			var li_diff			= li_millis - li_lastCheck;
  4672. 			var li_interval		= go_self.Options.getOption('updateOptions', 'updateInterval') * 1000;
  4673. 			
  4674. 			// Greasyfork allows updatechecks only every 24 hours.
  4675. 			li_interval = li_interval < 86400 ? 86400 : li_interval; 
  4676. 		
  4677. 			if(li_interval > 0 && li_diff > li_interval) {
  4678. 				_gb_manualUpdate = false;
  4679.  
  4680. 				go_self.myGM.setValue('updater_lastUpdateCheck', li_millis + '').then(function () { go_self.Updater.checkForUpdates(); });
  4681. 			}
  4682. 		}, 0);
  4683. 	}
  4684. 	
  4685. 	/**
  4686. 	 * Updater to check for updates.
  4687. 	 * 
  4688. 	 * @instance
  4689. 	 * 
  4690. 	 * @type	IkariamCore~Updater
  4691. 	 */
  4692. 	this.Updater = new Updater();
  4693. 	
  4694. 	this.con.logTimeStamp('IkariamCore.Updater created');
  4695. 	
  4696. 	this.con.logTimeStamp('IkariamCore display error functions initiated');
  4697. 	this.con.groupEnd();
  4698. }