☰

Ikariam Core

Framework for Ikariam userscript developers.

目前为 2015-03-04 提交的版本。查看 最新版本。

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