☰

Ikariam Core

Framework for Ikariam userscript developers.

目前为 2016-01-27 提交的版本。查看 最新版本。

此脚本不应直接安装，它是一个供其他脚本使用的外部库。如果您需要使用该库，请在脚本元属性加入：// @require https://update.gf.qytechs.cn/scripts/5574/103830/Ikariam%20Core.js 

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

欢迎访问Greasy Fork镜像

土豆服务器，请按需使用

镜像地址随时可能被墙，建议加群获取最新地址

加入Q群

QingJ © 2025

镜像随时可能失效，请加Q群300939539或关注我们的公众号极客氢云获取最新地址