X-Git-Url: https://code.delx.au/comingnext/blobdiff_plain/200079acd6cf16ec09f43b042c4b97f401a74ec9..037e8550464756cb214edef5d9d9174719c763fb:/comingNext/index.html

diff --git a/comingNext/index.html b/comingNext/index.html
index 7f974d8..015dbae 100644
--- a/comingNext/index.html
+++ b/comingNext/index.html
@@ -7,23 +7,29 @@
 
 <style type="text/css">
 /* The following classes can be modified by widget settings */
-.background { }
-.backgroundFullscreen { }
+.background { color:#ffffff; background-color:#000000 }
+.backgroundFullscreen { color:#ffffff; background-color:#000000 }
 .weekDay { }
 .date { }
-.today { }
-.tomorrow { }
+.today { color:#ff0000 }
+.tomorrow { color:#0000ff }
 .time { }
-.now { }
+.now { color:#ff00ff }
 .description { }
-.icon { }
-.overdue {}
+.icon { width:15px; height:15px }
+.overdue { color:#ffff00 }
+.calendar1 { background-color:#0757cf }
+.calendar2 { background-color:#579f37 }
+.calendar3 { background-color:#ff9f07 }
+.calendar4 { background-color:#af8fef }
+.calendar5 { background-color:#57afbf }
+.calendar6 { background-color:#9fdf57 }
 </style>
 
 <script type="text/javascript" src="localizedTextStrings.js" charset="utf-8" />
 
 <script>
-// valid types for the config object are 'Int', 'Bool', 'String', 'Enum', 'UID'
+// valid types for the config object are 'Int', 'Bool', 'String', 'Enum', 'UID', 'Array'
 var config = {
 	monthRange: { Type: 'Int', Default: 2, Value: 2,},
 	includeTodos: { Type: 'Bool', Default: true, Value: true,},
@@ -47,7 +53,11 @@ var config = {
 	showNothingText: { Type: 'Bool', Default: true, Value: true,},
 	nothingText: { Type: 'String', Default: getLocalizedText('settings.default.nothingText'), Value: getLocalizedText('settings.default.nothingText'),},
 	enableDaylightSaving: { Type: 'Bool', Default: true, Value: true,},
+	daylightSavingOffset: { Type: 'Int', Default: 1, Value: 1,},
 	hideWidgetOnCalendarOpen: { Type: 'Bool', Default: false, Value: false,},
+	showCalendarIndicator: { Type: 'Bool', Default: true, Value: true,},
+	excludedCalendars: { Type: 'Array', Default: [], Value: [],},
+	enableLogging: { Type: 'Bool', Default: false, Value: false,},
 	cssStyle_background: { Type: 'String', Default: 'color:#ffffff; background-color:#000000', Value: 'color:#ffffff; background-color:#000000',},
 	cssStyle_backgroundFullscreen: { Type: 'String', Default: 'color:#ffffff; background-color:#000000', Value: 'color:#ffffff; background-color:#000000',},
 	cssStyle_weekDay: { Type: 'String', Default: '', Value: '',},
@@ -59,6 +69,12 @@ var config = {
 	cssStyle_description: { Type: 'String', Default: '', Value: '',},
 	cssStyle_icon: { Type: 'String', Default: 'width:15px; height:15px', Value: 'width:15px; height:15px',},
 	cssStyle_overdue: { Type: 'String', Default: 'color:#ffff00', Value: 'color:#ffff00',},
+	cssStyle_calendar1: { Type: 'String', Default: 'background-color:#0757cf', Value: 'background-color:#0757cf',},
+	cssStyle_calendar2: { Type: 'String', Default: 'background-color:#579f37', Value: 'background-color:#579f37',},
+	cssStyle_calendar3: { Type: 'String', Default: 'background-color:#ff9f07', Value: 'background-color:#ff9f07',},
+	cssStyle_calendar4: { Type: 'String', Default: 'background-color:#af8fef', Value: 'background-color:#af8fef',},
+	cssStyle_calendar5: { Type: 'String', Default: 'background-color:#57afbf', Value: 'background-color:#57afbf',},
+	cssStyle_calendar6: { Type: 'String', Default: 'background-color:#9fdf57', Value: 'background-color:#9fdf57',},
 }
 
 
@@ -67,30 +83,41 @@ var config = {
 // Nothing of interest from here on...
 //-------------------------------------------------------
 var panelNum = 0; // use 1 for second panel
-var version = "1.28";
+var version = "1.37";
 var versionURL = "http://comingnext.sourceforge.net/version.xml";
 var calendarService = null;
 var cacheEntriesHtml = [];
 var months_translated = [];
+var weekdays_translated = [];
 var orientation = '';
 var now = new Date();
 var mode = 0; // 0 = homescreen, 1 = fullscreen, 2 = settings, 3 = about, 4 = check for update
 var reqV = null; 
 var settingsCalEntryId = null;
 var settingsCache = null;
-var notificationRequest1;
-var notificationRequest2;
+var notificationRequests = new Array();
 var calendarList = [];
+var calendarColors = [];
+var updateTimer = null;
+var screenRotationTimer = null;
+var lastUpdateTime = now; // last time we updated the display
+var lastReloadTime = null; // last time we fetched calendar data
+var reloadInterval = 6 * 60 * 60 * 1000; // = 6 hours; time interval for reloading calendar data
+var errorOccured = false;
+var entryLists = null; // stores all fetched calendar entries until data is refreshed
+var statupSuccessful = false; // indicates if everything started up wihtout errors. If we detect an error after that, it might just be a temporary problem e.g. by a backup process.
+var use12hoursTimeFormat = false; // defines how time should be formated: 19:00 or 07:00 pm
+var timeFormatSeparator = ":"; // format time 19:00 or 19.00 depending on system setting
 
 // vars for daylight saving time
-var daylightsavingWinter = 0;
-var daylightsavingSummer = 0;
-var summertime = false;
+var summertime = false; // true, if current date is in summer, false if in winter
+var daylightSavingDates = new Object(); // caches calculated DST winter and summer time shift dates
 
 // this is a list of data fields a calendar event can have
 var entryFields = [
 	"id",
 	"Type",
+	"CalendarName",
 	"Summary",
 	"Location",
 	"Status",
@@ -100,17 +127,13 @@ var entryFields = [
 	"InstanceEndTime"
 ];
 
-window.onload = init;
-window.onresize = updateScreen;
-window.onshow = updateScreen;
-
 function isLeapYear( year ) {
 	if (( year % 4 == 0 && year % 100 != 0 ) || year % 400 == 0 )
 		return true;
 	else
 		return false;
 }
-	  
+
 function calcLeapYear(year, days)
 {
 	if (isLeapYear(year))
@@ -127,49 +150,57 @@ function subToSunday(myDate, year, days, prevMonthDays)
 	days = isLeapYear(year) ? --days : days;
 	return days;
 }
-	
-function calcDaylightSaving()
+
+function isSummertime(curDate)
 {
-	var thisYearS = new Date(now.getFullYear(),  3, 0, 0, 0, 0 );
-	var thisYearW = new Date(now.getFullYear(), 10, 0, 0, 0, 0 );
-	var nextYearS = new Date(now.getFullYear() + 1,  3, 0, 0, 0, 0 );
-	var nextYearW = new Date(now.getFullYear() + 1, 10, 0, 0, 0, 0 );
 	var summer = false;
 	var winter = false;
-	
-	thisYearSDays = nextYearSDays = 90;
-	thisYearWDays = nextYearWDays = 304;
-	
-	thisYearSDays = calcLeapYear(now.getFullYear(), thisYearSDays);
-	thisYearWDays = calcLeapYear(now.getFullYear(), thisYearWDays);
-	nextYearSDays = calcLeapYear(now.getFullYear() + 1, nextYearSDays);
-	nextYearWDays = calcLeapYear(now.getFullYear() + 1, nextYearWDays);
-	
-	thisYearSDays = subToSunday(thisYearS, now.getFullYear(), thisYearSDays, 59);
-	thisYearWDays = subToSunday(thisYearW, now.getFullYear(), thisYearWDays, 273);
-	nextYearSDays = subToSunday(nextYearS, now.getFullYear() + 1, nextYearSDays, 59);
-	nextYearWDays = subToSunday(nextYearW, now.getFullYear() + 1, nextYearWDays, 273);
-	
-	daylightsavingSummer = new Date (now.getFullYear(), 03-1, thisYearSDays, 2, 0, 0);
-	daylightsavingWinter = new Date (now.getFullYear(), 10-1, thisYearWDays, 2, 0, 0);
-	if (daylightsavingSummer < now) {
-		daylightsavingSummer = new Date (now.getFullYear()+1, 03-1, nextYearSDays, 2, 0, 0);
-		var summer = true;
-	}
-	if (daylightsavingWinter < now) {
-		daylightsavingWinter = new Date (now.getFullYear()+1, 10-1, nextYearWDays, 2, 0, 0);
-		var winter = true;
+
+	// if we already calculated DST summer and winter time dates for this year, use cached values
+	var dst = daylightSavingDates[curDate.getFullYear()];
+	if (!dst) {
+		var thisYearS = new Date(curDate.getFullYear(),  3, 0, 0, 0, 0 );
+		var thisYearW = new Date(curDate.getFullYear(), 10, 0, 0, 0, 0 );
+		var nextYearS = new Date(curDate.getFullYear() + 1,  3, 0, 0, 0, 0 );
+		var nextYearW = new Date(curDate.getFullYear() + 1, 10, 0, 0, 0, 0 );
+		
+		thisYearSDays = nextYearSDays = 90;
+		thisYearWDays = nextYearWDays = 304;
+		
+		thisYearSDays = calcLeapYear(curDate.getFullYear(), thisYearSDays);
+		thisYearWDays = calcLeapYear(curDate.getFullYear(), thisYearWDays);
+		nextYearSDays = calcLeapYear(curDate.getFullYear() + 1, nextYearSDays);
+		nextYearWDays = calcLeapYear(curDate.getFullYear() + 1, nextYearWDays);
+		
+		thisYearSDays = subToSunday(thisYearS, curDate.getFullYear(), thisYearSDays, 59);
+		thisYearWDays = subToSunday(thisYearW, curDate.getFullYear(), thisYearWDays, 273);
+		nextYearSDays = subToSunday(nextYearS, curDate.getFullYear() + 1, nextYearSDays, 59);
+		nextYearWDays = subToSunday(nextYearW, curDate.getFullYear() + 1, nextYearWDays, 273);
+		
+		dst = {
+			Summer: new Date (curDate.getFullYear(), 03-1, thisYearSDays, 2, 0, 0),
+			Winter: new Date (curDate.getFullYear(), 10-1, thisYearWDays, 2, 0, 0),
+		}
+		daylightSavingDates[curDate.getFullYear()] = dst;
 	}
+
+	if (dst.Summer < curDate)
+		summer = true;
+	if (dst.Winter < curDate)
+		winter = true;
 	if (summer && !winter)
-		summertime = true;
+		return true;
 	else
-		summertime = false;
+		return false;
 }
 
 function error(message)
 {
 	console.info('Error: ' + message);
 	document.getElementById("calendarList").innerHTML = 'Error: ' + message;
+	document.getElementById("fullscreenCalendarList").innerHTML = 'Error: ' + message;
+	errorOccured = true;
+	document.onclick = null;
 }
 
 function areDatesEqual(date1, date2)
@@ -213,7 +244,27 @@ function collectLocales()
 		try {
 			var result = calendarService.IDataSource.Add(criteria);
 			if (result.ErrorCode)
-				error(result.ErrorMessage);
+				throw(result.ErrorMessage);
+		} catch (e) {
+			error("collectLocales: " + e + ', line ' + e.line);
+		}
+	}
+	for (weekday = 0; weekday < 7; weekday++) {
+		var startDate = new Date(2000, 0, 2 + weekday); // date that we know for sure is a sunday
+
+		var item = new Object();
+		item.Type = "DayEvent";
+		item.StartTime = startDate;
+		item.Summary = "__weekday_temp" + weekday;
+
+		var criteria = new Object();
+		criteria.Type = "CalendarEntry";
+		criteria.Item = item;
+
+		try {
+			var result = calendarService.IDataSource.Add(criteria);
+			if (result.ErrorCode)
+				throw(result.ErrorMessage);
 		} catch (e) {
 			error("collectLocales: " + e + ', line ' + e.line);
 		}
@@ -231,13 +282,11 @@ function collectLocales()
 			}
 		}
 		var result = calendarService.IDataSource.GetList(listFiltering);
-		if (result.ErrorCode) {
-			error(result.ErrorMessage);
-			return;
-		}
+		if (result.ErrorCode)
+			throw(result.ErrorMessage);
 		var list = result.ReturnValue;
 	} catch(e) {
-		error(e + ', line ' + e.line);
+		error("collectLocales: " + e + ', line ' + e.line);
 		return;
 	}
 	var ids = new Array();
@@ -247,7 +296,7 @@ function collectLocales()
 		var dateArr = [];
 
 		while (list && (entry = list.getNext()) != undefined) {
-			dateArr = entry.StartTime.replace(/,/g,'').replace(/\./g,':').replace(/  /g,' ').split(' ');
+			dateArr = (entry.StartTime + '').replace(/,/g,'').replace(/\./g,':').replace(/  /g,' ').split(' ');
 			var day = dateArr[1];
 			var month = dateArr[2];
 			var year = dateArr[3];
@@ -263,16 +312,53 @@ function collectLocales()
 				month = tmp;
 			}
 
-			console.info(entry.StartTime + ' -> ' + month + ' ' + counter);
+			log(entry.StartTime + ' -> ' + month + ' ' + counter);
 			ids[counter] = entry.id;
 			months_translated[month] = counter + 1;
 			counter++;
 		}
 	} catch(e) {
-		error(e + ', line ' + e.line);
+		error("collectLocales: " + e + ', line ' + e.line);
+		return;
+	}
+	try {
+		var startTime = new Date(2000,0,2);
+		var endTime = new Date(2000,0,9);
+		var listFiltering = {
+			Type:'CalendarEntry', 
+			Filter:{
+				StartRange: startTime,
+				EndRange: endTime,
+				SearchText: '__weekday_temp',
+				Type: 'DayEvent'
+			}
+		}
+		var result = calendarService.IDataSource.GetList(listFiltering);
+		if (result.ErrorCode)
+			throw(result.ErrorMessage);
+		var weekdaylist = result.ReturnValue;
+	} catch(e) {
+		error("collectLocales: " + e + ', line ' + e.line);
 		return;
 	}
-	console.info(ids);
+	try {
+		var entry;
+		var counter2 = 0;
+		var curWeekday = "";
+
+		while (weekdaylist && (entry = weekdaylist.getNext()) != undefined) {
+			detectTimeFormat(entry.StartTime + '');
+			curWeekday = (entry.StartTime + '').split(',')[0];
+			log(entry.StartTime + ' -> ' + curWeekday + ' ' + counter2);
+			ids[counter + counter2] = entry.id;
+			weekdays_translated[counter2] = curWeekday;
+			counter2++;
+		}
+	} catch(e) {
+		error("collectLocales: " + e + ', line ' + e.line);
+		return;
+	}
+	log(ids);
 	try {
 		var criteria = new Object();
 		criteria.Type = "CalendarEntry";
@@ -282,24 +368,41 @@ function collectLocales()
 
 		var result = calendarService.IDataSource.Delete(criteria);
 		if (result.ErrorCode)
-			error(result.ErrorMessage);
+			throw(result.ErrorMessage);
 	} catch(e) {
 		error('deleting temp calendar entries:' + e + ', line ' + e.line);
 		return;
 	}
 }
 
+function stringEndsWith(str, suffix)
+{
+	return str.indexOf(suffix, str.length - suffix.length) !== -1;
+}
+
+// detects the system's current time format by parsing a native calendar timestamp (this is the only reliable formating across all devices and firmwares)
+function detectTimeFormat(localeTimeString)
+{
+	localeTimeString = localeTimeString.toLowerCase();
+	use12hoursTimeFormat = stringEndsWith(localeTimeString, "am") || stringEndsWith(localeTimeString, "pm");
+	timeFormatSeparator = localeTimeString.indexOf(":") != -1 ? ":" : ".";
+}
+
 function requestNotification()
 {
 	var criteria = new Object();
 	criteria.Type = "CalendarEntry";
-
-	try {
-		notificationRequest1 = calendarService.IDataSource.RequestNotification(criteria, callback);
-		if (notificationRequest1.ErrorCode)
-			error('requestNotification failed with error code ' + notificationRequest1.ErrorCode);
-	} catch (e) {
-		error("requestNotification: " + e + ', line ' + e.line);
+	criteria.Filter = new Object();
+	for(var i=0; i < calendarList.length; i++) {
+		criteria.Filter.CalendarName = calendarList[i];
+		try {
+			var notificationRequest = calendarService.IDataSource.RequestNotification(criteria, callback);
+			if (notificationRequest.ErrorCode)
+				error('requestNotification failed with error code ' + notificationRequest.ErrorCode);
+			notificationRequests.push(notificationRequest);
+		} catch (e) {
+			error("requestNotification: " + e + ', line ' + e.line);
+		}
 	}
 
 	var criteria2 = new Object();
@@ -307,25 +410,39 @@ function requestNotification()
 	criteria2.Filter = new Object();
 	criteria2.Filter.LocalIdList = new Array();
 	criteria2.Filter.LocalIdList[0] = settingsCalEntryId;
-
 	try {
-		notificationRequest2 = calendarService.IDataSource.RequestNotification(criteria2, settingsCallback);
-		if (notificationRequest2.ErrorCode)
-			error('requestNotification failed with error code ' + notificationRequest2.ErrorCode);
+		var notificationRequest = calendarService.IDataSource.RequestNotification(criteria2, settingsCallback);
+		if (notificationRequest.ErrorCode)
+			error('requestNotification failed with error code ' + notificationRequest.ErrorCode);
+		notificationRequests.push(notificationRequest);
 	} catch (e) {
 		error("requestNotification: " + e + ', line ' + e.line);
 	}
 }
 
+function cancelNotification()
+{
+	for(var i=0; i < notificationRequests.length; i++) {
+		try {
+			var result = calendarService.IDataSource.Cancel(notificationRequests[i]);
+			if (result.ErrorCode)
+				error('cancelNotification failed with error code ' + result.ErrorCode);
+		} catch (e) {
+			error("cancelNotification: " + e + ', line ' + e.line);
+		}
+	}
+}
+
 function callback(transId, eventCode, result)
 {
-	console.info("callback(): panelNum: %d  transId: %d  eventCode: %d result.ErrorCode: %d", panelNum, transId, eventCode, result.ErrorCode);
+	log("callback(): panelNum: " + panelNum + "  transId: " + transId + "  eventCode: " + eventCode + " result.ErrorCode: " + result.ErrorCode);
+	lastReloadTime = null; // force calendar data reload on next update
 	updateData();
 }
 
 function settingsCallback(transId, eventCode, result)
 {
-	console.info("settingsCallback(): panelNum: %d  transId: %d  eventCode: %d result.ErrorCode: %d", panelNum, transId, eventCode, result.ErrorCode);
+	log("settingsCallback(): panelNum: " + panelNum + "  transId: " + transId + "  eventCode: " + eventCode + " result.ErrorCode: " + result.ErrorCode);
 	loadSettings();
 }
 
@@ -340,60 +457,85 @@ function parseDate(dateString)
 	Wednesday,  2009 August, 28 8.00.00 pm
 	Wednesday,  2009 August, 28 08:00:00 PM
 	*/
+	var result = null;
 
-	if (dateString == "" || dateString == null)
-		return null;
-	var dateArr = dateString.replace(/,/g,'').replace(/\./g,':').replace(/  /g,' ').split(' ');
-	if (dateArr.length != 5 && dateArr.length != 6)
-		return null;
-
-	// parse date
-	var weekDay = dateArr[0];
-	var day = dateArr[1];
-	var month = dateArr[2];
-	var year = dateArr[3];
-	// make sure month is set properly
-	if (isNaN(parseInt(day))) {
-		var tmp = day;
-		day = month;
-		month = tmp;
-	} else if (isNaN(parseInt(year))) {
-		var tmp = year;
-		year = month;
-		month = tmp;
+	if (dateString == "" || dateString == null || dateString == undefined)
+		return result;
+	if (dateString instanceof Date) {
+		// we already have a date object, no need to parse string here
+		result = dateString;
 	}
-	// make sure day and year are set properly
-	if (Number(day) > Number(year)) {
-		var tmp = year;
-		year = day;
-		day = tmp;
+	else {
+		var dateArr = (dateString + '').replace(/,/g, '').replace(/\./g, ':').replace(/  /g, ' ').split(' ');
+		if (dateArr.length != 5 && dateArr.length != 6) 
+			return null;
+		
+		// parse date
+		var weekDay = dateArr[0];
+		var day = dateArr[1];
+		var month = dateArr[2];
+		var year = dateArr[3];
+		// make sure month is set properly
+		if (isNaN(parseInt(day))) {
+			var tmp = day;
+			day = month;
+			month = tmp;
+		}
+		else 
+			if (isNaN(parseInt(year))) {
+				var tmp = year;
+				year = month;
+				month = tmp;
+			}
+		// make sure day and year are set properly
+		if (Number(day) > Number(year)) {
+			var tmp = year;
+			year = day;
+			day = tmp;
+		}
+		month = months_translated[month];
+		
+		// parse time
+		var timeArr = dateArr[4].split(':');
+		if (timeArr.length != 3) 
+			return null;
+		var hours = Number(timeArr[0]);
+		var minutes = Number(timeArr[1]);
+		var seconds = Number(timeArr[2]);
+		if (dateArr.length == 6 && dateArr[5].toLowerCase() == 'pm' && hours < 12) 
+			hours += 12;
+		if (dateArr.length == 6 && dateArr[5].toLowerCase() == 'am' && hours == 12) 
+			hours = 0;
+		
+		result = new Date(year, month - 1, day, hours, minutes, seconds);
 	}
-	month = months_translated[month];
-
-	// parse time
-	var timeArr = dateArr[4].split(':');
-	if (timeArr.length != 3)
-		return null;
-	var hours = Number(timeArr[0]);
-	var minutes = Number(timeArr[1]);
-	var seconds = Number(timeArr[2]);
-	if (dateArr.length == 6 && dateArr[5].toLowerCase() == 'pm' && hours < 12)
-		hours += 12;
-	if (dateArr.length == 6 && dateArr[5].toLowerCase() == 'am' && hours == 12)
-		hours = 0;
-
-	console.info('year=' + year + ' month=' + month + ' day=' + day + ' hours=' + hours + ' minutes=' + minutes+ ' seconds=' + seconds);
-
+	
 	// take care of daylight saving time
 	if (config['enableDaylightSaving'].Value) {
-		var date = new Date(year, month - 1, day, hours, minutes, seconds);
-		if (summertime && date > daylightsavingWinter && date < daylightsavingSummer)
-			hours -= 1;
-		else if (!summertime && date > daylightsavingSummer && date < daylightsavingWinter)
-			hours += 1;
+		
+		// determine if date is in summer or winter time
+		var dateSummerTime = isSummertime(result);
+
+		// work around bug in Nokias calendar api resulting in dates within a different DST to be off by 1 hour
+		if (summertime && !dateSummerTime) {
+			result = new Date(result.getTime() - 1000 * 60 * 60 * config['daylightSavingOffset'].Value); // -1 hour
+			log('parseDate(): fixing time -1h: ' + result);
+		}
+		else if (!summertime && dateSummerTime) {
+			result = new Date(result.getTime() + 1000 * 60 * 60 * config['daylightSavingOffset'].Value); // +1 hour
+			log('parseDate(): fixing time +1h: ' + result);
+		}
 	}
 
-	return new Date(year, month - 1, day, hours, minutes, seconds);
+	return result;
+}
+
+function getWeekdayLocalized(date) {
+	var localizedString = date.toLocaleDateString();
+	if (localizedString.indexOf(",") == -1) {
+		return weekdays_translated[date.getDay()];
+	} else
+		return localizedString.split(',')[0];
 }
 
 // returns a short date as string ("31.12" or "12.31") based on the format string which should look like "Wednesday,  26 August, 2009 12:00:00 am"
@@ -409,6 +551,13 @@ function formatDate(date, format)
 	if (config['showTodayAsText'].Value && isTomorrow(date))
 		return '<span class="tomorrow">' + config['tomorrowText'].Value + '</span>';
 
+	if (format instanceof Date) {
+		// we don't know how to format this
+		if (config['dateFormat'].Value == 'auto' || config['dateFormat'].Value == 'DDMM')
+			return day + config['dateSeparator'].Value + month;
+		else
+			return month + config['dateSeparator'].Value + day;
+	}
 	var dateArr = format.replace(/,/g,'').replace(/\./g,':').replace(/  /g,' ').split(' ');
 	if (dateArr.length != 5 && dateArr.length != 6) {
 		// we don't know how to format this
@@ -455,67 +604,128 @@ function formatDate(date, format)
 function formatTime(date)
 {
 	// date is a Date() object
-	date.setSeconds(0); // we don't care about seconds
-	var time = date.toLocaleTimeString().replace(/[\.:]00/, ''); // remove seconds from string
-	if (time.replace(/\./, ':').split(':')[0].length < 2)
-		time = '0' + time;
+	var hour = date.getHours();
+	var minute = date.getMinutes();
+	
+	// don't use Date().toLocaleTimeString() as it is utterly broken on newer firmwares
+	if (use12hoursTimeFormat) {
+		var ap = "AM";
+		if (hour > 11)
+			ap = "PM";
+		if (hour > 12)
+			hour = hour - 12;
+		if (hour == 0)
+			hour = 12;
+		if (hour < 10)
+			hour = "0" + hour;
+		if (minute < 10)
+			minute = "0" + minute;
+		time = hour + timeFormatSeparator + minute + " " + ap;
+	}
+	else {
+		if (hour < 10)
+			hour = "0" + hour;
+		if (minute < 10)
+			minute = "0" + minute;
+		time = hour + timeFormatSeparator + minute;
+	}
+	
 	if (config['showNowAsText'].Value && date.getTime() == now.getTime())
 		time = '<span class="now">' + config['nowText'].Value + '</span>';
+	log("formatTime(): " + time + ", use12hoursTimeFormat=" + use12hoursTimeFormat + ", timeFormatSeparator=" + timeFormatSeparator + ", date.toLocateTimeString(): " + date.toLocaleTimeString());
 	return time;
 }
 
 function updateData()
 {
-	console.info('updateData()');
-	calcDaylightSaving();
-	try {
-		// meetings have time
-		// note: anniveraries have a start time of 12:00am. So since we want to include them, we have to query the whole day and check if events have passed later
-		now = new Date();
-		var meetingList = [];
-		for(var i=0; i < calendarList.length; i++) {
-			var meetingListFiltering = {
-				Type:'CalendarEntry',
-				Filter:{
-					CalendarName: calendarList[i],
-					StartRange: (new Date(now.getFullYear(), now.getMonth(), now.getDate(), 0, 0, 0)),
-					EndRange: (new Date(now.getFullYear(), now.getMonth() + config['monthRange'].Value, now.getDate(), 0, 0, 0))
-				}
-			}
-			var meetingResult = calendarService.IDataSource.GetList(meetingListFiltering);
-			if (meetingResult.ErrorCode != 0)
-				throw("Error fetching calendar data: " + meetingResult.ErrorCode + ': ' + meetingResult.ErrorMessage);
-			var list = meetingResult.ReturnValue;
-			meetingList = meetingList.concat(listToArray(list));
-		}
-		meetingList.sort(sortCalendarEntries);
+	log('updateData()');
+	if (errorOccured) {
+		return;
+	}
 
-		// todos don't, they start on 00:00 hrs., but should be visible anyway
-		// this will generate a list of passed todos. We have to check if they have been marked as "done" yet
-		if (config['includeTodos'].Value) {
-			var todayTodoList = [];
+	// check if we got additional or less calendars since our last update
+	var newCalendarList = listCalendars();
+	if (newCalendarList == null) {
+		// Something went wrong fetching the calendars list.
+		// This usually happens when a backup is being made.
+		// Retry the next time updateData() is called by 
+		// resetting errorOccured
+		log('updateData(): listCalendars() failed, trying again later...');
+		cacheEntriesHtml = ''; // make sure we replace the currently shown error message on the next update
+		errorOccured = false;
+		return;
+	}
+	if (newCalendarList.length != calendarList.length) {
+		calendarList = newCalendarList;
+		updateCalendarColors();
+		cancelNotification();
+		requestNotification();
+		lastReloadTime = null; // force calendar data reload on this update
+	}
+
+	now = new Date();
+	
+	// only reload calendar data every 6 hours, visual updates occure more often
+	if (!lastReloadTime || now.getTime() - lastReloadTime.getTime() > reloadInterval) {
+		log('updateData(): reloading calendar data');
+		try {
+			// meetings have time
+			// note: anniveraries have a start time of 12:00am. So since we want to include them, we have to query the whole day and check if events have passed later
+			summertime = isSummertime(now); // cache summer time info for today
+			var meetingList = [];
 			for(var i=0; i < calendarList.length; i++) {
-				var todayTodoListFiltering = {
+				// ignore excluded calendars
+				if (config['excludedCalendars'].Value.indexOf(calendarList[i]) != -1)
+					continue;
+				var meetingListFiltering = {
 					Type:'CalendarEntry',
 					Filter:{
 						CalendarName: calendarList[i],
-						Type: 'ToDo',
-						StartRange: (new Date(now.getFullYear() - 1, now.getMonth(), now.getDate(), 0, 0, 0)),
-						EndRange: (new Date(now.getFullYear(), now.getMonth(), now.getDate(), 0, 0, 1))
+						StartRange: (new Date(now.getFullYear(), now.getMonth(), now.getDate(), 0, 0, 0)),
+						EndRange: (new Date(now.getFullYear(), now.getMonth() + config['monthRange'].Value, now.getDate(), 0, 0, 0))
+					}
+				}
+				var meetingResult = calendarService.IDataSource.GetList(meetingListFiltering);
+				if (meetingResult.ErrorCode != 0)
+					throw("Error fetching calendar data: " + meetingResult.ErrorCode + ': ' + meetingResult.ErrorMessage);
+				var list = meetingResult.ReturnValue;
+				meetingList = meetingList.concat(listToArray(list, calendarList[i]));
+			}
+			log("updateData(): meetingList.sort()");
+			meetingList.sort(sortCalendarEntries);
+
+			// todos don't, they start on 00:00 hrs., but should be visible anyway
+			// this will generate a list of passed todos. We have to check if they have been marked as "done" yet
+			if (config['includeTodos'].Value) {
+				var todayTodoList = [];
+				for(var i=0; i < calendarList.length; i++) {
+					// ignore excluded calendars
+					if (config['excludedCalendars'].Value.indexOf(calendarList[i]) != -1)
+						continue;
+					var todayTodoListFiltering = {
+						Type:'CalendarEntry',
+						Filter:{
+							CalendarName: calendarList[i],
+							Type: 'ToDo',
+							StartRange: (new Date(now.getFullYear() - 1, now.getMonth(), now.getDate(), 0, 0, 0)),
+							EndRange: (new Date(now.getFullYear(), now.getMonth(), now.getDate(), 0, 0, 1))
+						}
 					}
+					var todayTodoResult = calendarService.IDataSource.GetList(todayTodoListFiltering);
+					var list = todayTodoResult.ReturnValue;
+					todayTodoList = todayTodoList.concat(listToArray(list, calendarList[i]));
 				}
-				var todayTodoResult = calendarService.IDataSource.GetList(todayTodoListFiltering);
-				var list = todayTodoResult.ReturnValue;
-				todayTodoList = todayTodoList.concat(listToArray(list));
+				log("updateData(): todayTodoList.sort()");
+				todayTodoList.sort(sortCalendarEntries);
+				entryLists = [todayTodoList, meetingList];
+			} else {
+				entryLists = [meetingList];
 			}
-			todayTodoList.sort(sortCalendarEntries);
-			var entryLists = [todayTodoList, meetingList];
-		} else {
-			var entryLists = [meetingList];
+			lastReloadTime = new Date();
+		} catch(e) {
+			error('loading Calendar items list:' + e + ', line ' + e.line);
+			return;
 		}
-	} catch(e) {
-		error('loading Calendar items list:' + e + ', line ' + e.line);
-		return;
 	}
 
 	try {
@@ -524,23 +734,26 @@ function updateData()
 		var entryDate = '';
 		var dateArr = [];
 		var fontsize = 'normal';
+		var lineheight = 'normal';
 		if (mode == 0) {
+			fontsize = parseInt(72 / config['eventsPerWidget'].Value) + 'px';
+			lineheight = parseInt(82 / config['eventsPerWidget'].Value) + 'px';
+			
 			if (config['eventsPerWidget'].Value == 3) {
-				fontsize = '17pt';
 				changeCssClass('.icon', 'width:20px; height:20px');
 			}
 			else if (config['eventsPerWidget'].Value == 5) {
-				fontsize = '10pt';
 				changeCssClass('.icon', 'width:10px; height:10px');
 			}
 			else if (config['eventsPerWidget'].Value == 6) {
-				fontsize = '8pt';
 				changeCssClass('.icon', 'width:8px; height:8px');
 			}
 		}
 		else
 			changeCssClass('.icon', config['cssStyle_icon'].Value);
-		var entriesHtml = '<table style="font-size:' + fontsize + ';">';
+		var entriesHtml = '<table style="font-size:' + fontsize + '; line-height:' + lineheight + ';">';
+		if (mode == 0)
+			entriesHtml = '<table width="307" height="82"><tr><td>' + entriesHtml; // this is needed to center the actual content vertically
 		var eventIds = [];
 		var max;
 		if (mode == 0)
@@ -548,6 +761,19 @@ function updateData()
 		else
 			max = 30; // we can display a lot more events in fullscreen mode
 
+		if (config['enableLogging'].Value) {
+			var listinfo = "";
+			for (var i=0; i < entryLists.length; i++) {
+				listinfo = listinfo + " " + entryLists[i].length;
+				var entrieslist = "";
+				for (var j=0; j < entryLists[i].length; j++) {
+					entrieslist += entryLists[i][j].Summary + ", ";
+				}
+				log("updateData(): entrieslist: " + entrieslist);
+			}
+			log("updateData(): inner loop, " + entryLists.length + " lists, [" + listinfo + "] entries");
+		}
+		
 		// the first outer loop iteration is for passed ToDos, the second loop is for all upcomming events (may also include ToDos)
 		for (var i=0; counter < max && i < entryLists.length; i++) {
 			for (var j=0; (counter < max) && (j < entryLists[i].length); j++) {
@@ -555,28 +781,24 @@ function updateData()
 				counter++;
 
 				// output event info for debugging
-				console.info(
-					'event: Id=' + entry.id + 
-					',Type=' + entry.Type + 
-					',Summary=' + entry.Summary + 
-					',Location=' + entry.Location + 
-					',Status=' + entry.Status + 
-					',StartTime=' + entry.StartTime +
-					',EndTime=' + entry.EndTime +
-					',InstanceStartTime=' + entry.InstanceStartTime +
-					',InstanceEndTime=' + entry.InstanceEndTime
-				);
+				var entryInfo = "event: ";
+				for(var k=0; k < entryFields.length; ++k) {
+					if (entry[entryFields[k]] != undefined) {
+						entryInfo += entryFields[k] + "=" + entry[entryFields[k]] + ",";
+					}
+				}
+				log(entryInfo);
 
 				// we don't want ToDos when includeTodos == false or when they are completed
 				if (entry.Type == 'ToDo' && (entry.Status == "TodoCompleted" || !config['includeTodos'].Value)) {
-					console.info('skipping ' + entry.id );
+					log('skipping ' + entry.id );
 					counter--;
 					continue;
 				}
 
 				// make sure that we don't include an event twice (useful for ToDos that might come up twice)
 				if (eventIds[entry.id] == 1 && entry.Type == 'ToDo') {
-					console.info('skipped (already included) ' + entry.id);
+					log('skipped (already included) ' + entry.id);
 					counter--;
 					continue;
 				} else
@@ -584,7 +806,7 @@ function updateData()
 
 				// summary can be undefined!
 				var Summary = ((entry.Summary == null) ? '' : entry.Summary);
-				if (entry.Type == 'Meeting' && entry.Location != '' && config['showLocation'].Value)
+				if (entry.Location != '' && entry.Location != undefined && config['showLocation'].Value)
 					Summary += ', ' + entry.Location;
 				
 				// fix by yves: determine start and end dates/times
@@ -599,15 +821,23 @@ function updateData()
 
 				// Convert date/time string to Date object
 				var date = parseDate(entryDate);
-				console.info('date: ' + date);
+				log('date: ' + date);
 				var endDate = ((entryEndTime == null) ? null : parseDate(entryEndTime));
-				console.info('endDate: ' + endDate);
+				log('endDate: ' + endDate);
+				
+				// check if Meeting is actually a DayEvent. Bug introduced by "Anna" updates to various Symbian^3 devices.
+				// Note that this workaround is not 100% save! It might missinterpret some meetings as dayevents of starting and ending on 00:00
+				if (entry.Type == 'Meeting' && date.getHours() == 0 && date.getMinutes() == 0 && 
+					endDate != null && endDate.getHours() == 0 && endDate.getMinutes() == 0) {
+					log('fixing event type: changed from "Meeting" to "DayEvent".');
+					entry.Type = 'DayEvent';
+				}
 
 				// check if meeting event has already passed
 				if (entry.Type == 'Meeting') {
 					var compareTime = ((endDate == null) ? date.getTime() : endDate.getTime());
 					if (now.getTime() > compareTime) {
-						console.info('skipping Meeting (already passed) ' + entry.id);
+						log('skipping Meeting (already passed) ' + entry.id);
 						counter--;
 						eventIds[entry.id] = 0;
 						continue;
@@ -618,7 +848,7 @@ function updateData()
 				if (entry.Type == 'Anniversary') {
 					var tmp = new Date(now.getFullYear(), now.getMonth(), now.getDate(), 0,0,0);
 					if (date.getTime() < tmp.getTime()) {
-						console.info('skipping Anniversary (already passed) ' + entry.id);
+						log('skipping Anniversary (already passed) ' + entry.id);
 						counter--;
 						eventIds[entry.id] = 0;
 						continue;
@@ -628,9 +858,9 @@ function updateData()
 				// fix DayEvents end time. End times are off by 1 Second. It's possible that the event has already passed
 				if (entry.Type == 'DayEvent' && endDate != null) {
 					endDate.setMinutes(endDate.getMinutes() - 1);
-					console.info('fixing DayEvent endDate: ' + endDate);
+					log('fixing DayEvent endDate: ' + endDate);
 					if (now.getTime() > endDate.getTime()) {
-						console.info('event already passed ' + entry.id);
+						log('event already passed ' + entry.id);
 						counter--;
 						eventIds[entry.id] = 0;
 						continue;
@@ -642,13 +872,13 @@ function updateData()
 					// check if we are between start and endtime
 					if ((date.getTime() < now.getTime()) && (now.getTime() < endDate.getTime())) {
 						date = now; // change appointment date/time to now
-						console.info('event is currently taking place: ' + date);
+						log('event is currently taking place: ' + date);
 					}
 				}
 
 				// skip events for the first panel in case this is the second one and we're not in fullscreen mode
 				if (mode == 0 && panelNum > 0 && counter < panelNum * config['eventsPerWidget'].Value + 1) {
-					console.info('skipping (already in first widget) ' + entry.id);
+					log('skipping (already in first widget) ' + entry.id);
 					continue;
 				}
 				
@@ -663,12 +893,18 @@ function updateData()
 				}
 
 				// generate html output
-				entriesHtml += '<tr><td><img class="icon" src="' + entry.Type + '.png" /></td>';
+				entriesHtml += '<tr>';
+				if (config['showCalendarIndicator'].Value && calendarList.length - config['excludedCalendars'].Value.length > 1) {
+					entriesHtml += '<td><span class="calendar' + calendarColors[entry.CalendarName] + '">&nbsp;</span></td>';
+				}
+				entriesHtml += '<td><img class="icon" src="' + entry.Type + '.png" /></td>';
 				if(date == null) {
 					// some languages have very strange locale date formats, can't parse all those. Also some todos don't have dates at all.
 					entriesHtml += '<td colspan="4"><span class="date">' + entryDate + '</span> ';
 				} else {
-					var weekDay = date.toLocaleDateString().substr(0,config['weekDayLength'].Value);
+					var weekDay = getWeekdayLocalized(date).substr(0,config['weekDayLength'].Value);
+					log('date.toLocaleDateString(): ' + date.toLocaleDateString());
+					log('weekDay: ' + weekDay);
 					var time = formatTime(date);
 					var dateStr = formatDate(date, entryDate);
 					if (entry.Type == 'ToDo' && overdue && config['markOverdueTodos'].Value) {
@@ -699,10 +935,13 @@ function updateData()
 			}
 		}
 		entriesHtml += '</table>';
+		if (mode == 0)
+			entriesHtml = entriesHtml + '</td></tr></table>';
 		if (config['showNothingText'].Value && entriesHtml == '<table></table>') {
 			var text = config['nothingText'].Value.replace(/%d/, config['monthRange'].Value);
 			entriesHtml = '<div style="width:295px; height:75px; text-align:center; line-height:75px; overflow:visible;">' + text + '</div>';
 		}
+		log("output: " + entriesHtml);
 		if (cacheEntriesHtml != entriesHtml) {
 			if (mode == 0)
 				document.getElementById('calendarList').innerHTML = entriesHtml;
@@ -710,14 +949,19 @@ function updateData()
 				document.getElementById('fullscreenCalendarList').innerHTML = entriesHtml;
 			cacheEntriesHtml = entriesHtml;
 		}
+		
+		lastUpdateTime = new Date();
 	} catch(e) {
 		error('displaying list:' + e + ', line ' + e.line);
 		return;
 	}
 }
 
+// called by handleOnShow() and onResize events
 function updateScreen()
 {
+	log('updateScreen(): mode=' + mode + ', window.innerHeight=' + window.innerHeight);
+
 	// check if opening fullscreen
 	if( window.innerHeight > 91 && mode == 0) {
 		mode = 1;
@@ -732,11 +976,24 @@ function updateScreen()
 	}
 	
 	if (mode == 0)
-		updateHomescreen();
+		updateHomescreen(); // check for screen rotation
 	else if (mode == 1)
 		updateFullscreen();
 }
 
+function handleOnShow()
+{
+	updateScreen();
+
+	var time = new Date();
+	if (time.getTime() - lastUpdateTime.getTime() > config['updateDataInterval'].Value * 60 * 1000) {
+		log('updateScreen(): force updateData() because last update was too long ago (' + (time.getTime() - lastUpdateTime.getTime()) / 1000 + 's)');
+		clearUpdateTimer();
+		updateData();
+		setUpdateTimer(); // reinitialize update timer
+	}
+}
+
 function launchCalendar()
 {
 	try {
@@ -751,7 +1008,7 @@ function launchCalendar()
 
 function init()
 {
-	console.info('New widget instance starting up...');
+	log('New widget instance starting up...');
 	
 	try {
 		// call calendar service
@@ -760,24 +1017,59 @@ function init()
 		else
 			throw('device object does not exist');
 	} catch(e) {
-		error('loading Calendar service: ' + e + ', line ' + e.line);
-		return;
+		error('loading Calendar service: ' + e + ', line ' + e.line + '<br /><a onclick="widget.openURL(\'http://comingnext.sf.net/help\'); return false;" href="http://comingnext.sf.net/help">' + getLocalizedText('menu.help') + '</a>');
+		//return;
 	}
 
 	calendarList = listCalendars();
 	loadSettings();
+	updateCalendarColors();
 	collectLocales();
 	//updateData();
 	requestNotification();
-	window.setInterval('updateData()', 1000 * 60 * config['updateDataInterval'].Value);
 	document.getElementById("settingsTitle").innerHTML = getLocalizedText('menu.settings');
-
-	mode = 0;
-	showHomescreen();
+	setUpdateTimer();
+	if (window.innerHeight > 91) {
+		mode = 0; // we're starting fullscreen, we set mode to homescreen in order to let updateScreen() do all the work for us
+	}
+	else {
+		mode = 1;
+	}
+	log("init(): updateScreen()");
 	updateScreen();
 	if (config['useBackgroundImage'].Value)
 		// check for screen rotation every 1 secs
-		window.setInterval('updateScreen()', 1000 * 1);
+		screenRotationTimer = window.setInterval('checkOrientation()', 1000 * 1);
+	
+	// call updateScreen() when widget changes from background to forground
+	window.widget.onshow = handleOnShow;
+
+	log("init(): finished...");
+	if (!errorOccured)
+		statupSuccessful = true;
+}
+
+function checkOrientation()
+{
+	//updateScreen();
+	if (mode == 0)
+		updateHomescreen(); // check for screen rotation
+}
+
+function setUpdateTimer()
+{
+	updateTimer = window.setInterval('updateTimerCallback()', 1000 * 60 * config['updateDataInterval'].Value);
+}
+
+function clearUpdateTimer() 
+{
+	window.clearInterval(updateTimer);
+}
+
+function updateTimerCallback()
+{
+	log("updateTimerCallback()");
+	updateData();
 }
 
 function createMenu()
@@ -787,15 +1079,18 @@ function createMenu()
 	var id = 0;
 	var menuSettings = new MenuItem(getLocalizedText('menu.settings'), id++);
 	var menuCallApp = new MenuItem(getLocalizedText('menu.openCalendarApp'), id++);
+	var menuHelp = new MenuItem(getLocalizedText('menu.help'), id++);
 	var menuUpdate = new MenuItem(getLocalizedText('menu.update'), id++);
 	var menuAbout = new MenuItem(getLocalizedText('menu.about'), id++);
 	menuSettings.onSelect = showSettings;
 	menuAbout.onSelect = showAbout;
 	menuCallApp.onSelect = launchCalendar;
 	menuUpdate.onSelect = showUpdate;
+	menuHelp.onSelect = showHelp;
 	window.menu.clear();
 	window.menu.append(menuCallApp);
 	window.menu.append(menuSettings);
+	window.menu.append(menuHelp);
 	window.menu.append(menuUpdate);
 	window.menu.append(menuAbout);	
 }
@@ -814,18 +1109,31 @@ function showSettings()
 				config[key].Value = document.forms[0].elements["settings." + key].value;
 			else if (config[key].Type == 'Int') {
 				config[key].Value = parseInt(document.forms[0].elements["settings." + key].value);
-				if (config[key].Value < 0)
+				if (config[key].Value < 0 || isNaN(config[key].Value))
 					config[key].Value = config[key].Default;
 			}
 			else if (config[key].Type == 'Bool')
 				config[key].Value = document.forms[0].elements["settings." + key].checked;
-			else if (config[key].Type == 'UID')
+			else if (config[key].Type == 'UID') {
 				config[key].Value = parseInt(document.forms[0].elements["settings." + key].value);
+				if (isNaN(config[key].Value))
+					config[key].Value = config[key].Default;
+			}
 			else if (config[key].Type == 'Enum') {
 				config[key].Value = document.forms[0].elements["settings." + key].value;
 				if (config[key].ValidValues.indexOf(config[key].Value) == -1)
 					config[key].Value = config[key].Default;
 			}
+			else if (config[key].Type == 'Array') {
+				if (key == 'excludedCalendars') {
+					config[key].Value = new Array();
+					for(var i=0; i < calendarList.length; i++) {
+						var element = document.forms[0].elements["settings." + key + "." + calendarList[i]];
+						if (element != null && element.checked == false)
+							config[key].Value.push(calendarList[i]);
+					}
+				}
+			}
 		}
 				
 		updateCssClasses();
@@ -861,6 +1169,18 @@ function showSettings()
 				settingsHtml += '<option value="' + config[key].ValidValues[i] + '"' + (config[key].Value == config[key].ValidValues[i] ? ' selected="selected"' : '') + '>' + getLocalizedText('settings.validValues.' + key + '.' + config[key].ValidValues[i]) + '</option>';
 			settingsHtml += '</select></div></td>' + printHintBox(getLocalizedText('settings.info.' + key)) + '<hr />';
 		}
+		else if (config[key].Type == 'Array') {
+			settingsHtml += '<table><tr><td>' + getLocalizedText('settings.name.' + key) + '<br />';
+			if (key == 'excludedCalendars') {
+				for(var i=0; i < calendarList.length; i++) {
+					var checked = 'checked="checked"';
+					if (config[key].Value.indexOf(calendarList[i]) != -1)
+						checked = '';
+					settingsHtml += '<input name="settings.' + key + '.' + calendarList[i] + '" type="checkbox" value="' + calendarList[i] + '" ' + checked + '/> ' + calendarList[i] + '<br />';
+				}
+			}
+			settingsHtml += '</td>' + printHintBox(getLocalizedText('settings.info.' + key)) + '<hr />';
+		}
 	}
 	settingsHtml += '<input name="reset" type="button" value="' + getLocalizedText('settings.restoreDefaults') + '" onclick="javascript:restoreDefaultSettings();showSettings();" />';
 	settingsHtml += '</form>';
@@ -893,22 +1213,27 @@ function getSettingsCalEntryId()
 		var listFiltering = {
 			Type:'CalendarEntry', 
 			Filter:{
-				StartRange: new Date(2000, 0, 1),
-				EndRange: new Date(2000, 0, 1),
+				StartRange: new Date(1999, 11, 30), // note: due to Nokia's buggy calendar API, the settings event can be on 01.01.2000 AND on 31.12.1999, depending on when the calendar entry was created (in summer or winter). It is not even possible to narrow the search down to these two days (probably because of DST offsets). So we're looking for an event between 30.12.1999 and 02.01.2000!
+				EndRange: new Date(2000, 0, 2),
 				SearchText: 'ComingNext Settings|',
 				Type: 'DayEvent'
 			}
 		}
-		var result = calendarService.IDataSource.GetList(listFiltering);
-		if (result.ErrorCode) {
-			error(result.ErrorMessage);
+		var result = null;
+		try {
+			result = calendarService.IDataSource.GetList(listFiltering);
+			if (result.ErrorCode)
+				throw(result.ErrorMessage);
+		}
+		catch (e) {
+			error("getSettingsCalEntryId: GetList() failed: " + e + ', line ' + e.line);
 			return;
 		}
 		var list = result.ReturnValue;
 		var entry = list.getNext();
 		if (entry != undefined) {
 			settingsCalEntryId = entry.LocalId;
-			console.info("settingsCalEntryId=" + settingsCalEntryId);
+			log("settingsCalEntryId=" + settingsCalEntryId);
 		}
 		else { // create settings item
 			var item = new Object();
@@ -923,7 +1248,7 @@ function getSettingsCalEntryId()
 			try {
 				var result = calendarService.IDataSource.Add(criteria);
 				if (result.ErrorCode)
-					error(result.ErrorMessage);
+					throw(result.ErrorMessage);
 			} catch (e) {
 				error("getSettingsCalEntryId: " + e + ', line ' + e.line);
 			}
@@ -948,13 +1273,19 @@ function loadSettings()
 			LocalId: settingsCalEntryId
 		}
 	}
-	var result = calendarService.IDataSource.GetList(listFiltering);
-	if (result.ErrorCode) {
-		error(result.ErrorMessage);
+	var result = null;
+	try	{
+		result = calendarService.IDataSource.GetList(listFiltering);
+		if (result.ErrorCode)
+			throw(result.ErrorMessage);
+	}
+	catch (e) {
+		error("loadSettings: GetList() failed: " + e + ', line ' + e.line);
 		return;
 	}
 	var entry = result.ReturnValue.getNext();
 	if (entry != undefined)	{
+		log("Loading Settings...");
 		// only reload settings if they chanced since the last reload
 		if (settingsCache != entry.Summary)
 		{
@@ -965,21 +1296,40 @@ function loadSettings()
 				var pair = stringlist[i].split('=');
 				var key = pair[0];
 				var value = pair[1];
-				console.info('stringlist: ' + key + '=\'' + value + '\'');
-				if (config[key].Type == 'Int')
+				if (key == null || value == null || config[key] == null) {
+					log('Warning: unknown or invalid setting: ' + stringlist[i]);
+					continue;
+				}
+				log('stringlist[' + i + ']: ' + key + '=\'' + value + '\'');
+				if (config[key].Type == 'Int') {
 					config[key].Value = Number(value);
+					if (isNaN(config[key].Value))
+						config[key].Value = config[key].Default;
+				}
 				else if (config[key].Type == 'String')
 					config[key].Value = value;
 				else if (config[key].Type == 'Bool')
 					config[key].Value = (value == 'true')
 				else if (config[key].Type == 'Enum')
 					config[key].Value = value;
-				else if (config[key].Type == 'UID')
+				else if (config[key].Type == 'UID') {
 					config[key].Value = Number(value);
+					if (isNaN(config[key].Value))
+						config[key].Value = config[key].Default;
+				}
+				else if (config[key].Type == 'Array') {
+					config[key].Value = value.split("^");
+					if (config[key].Value.length == 1 && config[key].Value[0] == "") {
+						config[key].Value = [];
+					}
+				}
 			}
 			settingsCache = entry.Summary;
 			updateCssClasses();
 		}
+		else {
+			log("Settings already cached and did not change");
+		}
 	}
 	else {
 		error("Failed to load settings, calendar entry could not be found");
@@ -1006,6 +1356,8 @@ function saveSettings()
 			item.Summary += key + "=" + config[key].Value + "|";
 		else if (config[key].Type == 'UID')
 			item.Summary += key + "=" + config[key].Value.toString() + "|";
+		else if (config[key].Type == 'Array')
+			item.Summary += key + "=" + config[key].Value.join("^") + "|";
 	}
 	settingsCache = item.Summary;
 	
@@ -1013,14 +1365,18 @@ function saveSettings()
 	criteria.Type = "CalendarEntry";
 	criteria.Item = item;
 
-	console.info("Saving settings to calendar entry: " + item.Summary);
+	log("Saving settings to calendar entry: " + item.Summary);
 	try {
 		var result = calendarService.IDataSource.Add(criteria);
 		if (result.ErrorCode)
-			error(result.ErrorMessage);
+			throw(result.ErrorMessage);
 	} catch (e) {
 		error("saveSettings: " + e + ', line ' + e.line);
 	}
+	
+	lastReloadTime = null; // force calendar data reload on next update
+	clearUpdateTimer();
+	setUpdateTimer();
 }
 
 function toggleVisibility(elementId)
@@ -1057,22 +1413,30 @@ function showAbout()
 	document.getElementById("name").innerHTML = "Coming Next " + version;
 }
 
+function showHelp() {
+	widget.openURL('http://comingnext.sf.net/help');
+}
+
 function updateFullscreen()
 {
 }
 
 function showFullscreen()
 {
+	log("showFullscreen()");
 	hideViews();
 	document.getElementById("fullscreenView").style.display = "block";
 	document.getElementById('body').className = "backgroundFullscreen";
-	document.onclick = launchCalendar;
+	if (!errorOccured)
+		document.onclick = launchCalendar;
 	createMenu();
 	updateData();
 }
 
 function getBackgroundImage()
 {
+	if (errorOccured)
+		return '';
 	var bgImage;
 	if (config['backgroundImageLocation'].Value == config['backgroundImageLocation'].ValidValues[0]) // internal
 		bgImage = 'background_' + orientation + '.png';
@@ -1084,14 +1448,22 @@ function getBackgroundImage()
 function updateHomescreen()
 {
 	if (config['useBackgroundImage'].Value) {
+		// check if we have a completely unknown screen resolution
+		var screenHeight = screen.height;
+		var screenWidth = screen.width;
+		if (screenHeight != 640 && screenHeight != 480 && screenHeight != 360)
+			screenHeight = 360; // we can only assume we're in portrait mode, so we set the screen dims as needed for the following code
+		if (screenWidth != 640 && screenWidth != 480 && screenWidth != 360)
+			screenWidth = 640; // we can only assume we're in portrait mode, so we set the screen dims as needed for the following code
+		
 		// check for screen rotation
-		if (orientation != 'portrait' && screen.width == 360 && screen.height == 640) {
+		if (orientation != 'portrait' && ((screenWidth == 360 && screenHeight == 640) || (screenWidth == 640 && screenHeight == 480))) {
 			window.widget.prepareForTransition("fade");
 			orientation = 'portrait';
 			document.getElementById('body').style.backgroundImage = 'url(' + getBackgroundImage() + ')';
 			document.getElementById('body').style.backgroundColor = 'none';
 			window.widget.performTransition();
-		} else if (orientation != 'landscape' && screen.width == 640 && screen.height == 360) {
+		} else if (orientation != 'landscape' && ((screenWidth == 640 && screenHeight == 360) || (screenWidth == 480 && screenHeight == 640))) {
 			window.widget.prepareForTransition("fade");
 			orientation = 'landscape';
 			document.getElementById('body').style.backgroundImage = 'url(' + getBackgroundImage() + ')';
@@ -1107,6 +1479,7 @@ function updateHomescreen()
 
 function showHomescreen()
 {
+	log("showHomescreen()");
 	hideViews();
 	document.getElementById("homescreenView").style.display = "block";
 	document.getElementById('body').className = "background";
@@ -1189,6 +1562,10 @@ function hideViews()
 
 function listCalendars()
 {
+	if (errorOccured) {
+		return null;
+	}
+
 	try {
 		var criteria = {
 			Type:'Calendar', 
@@ -1208,7 +1585,7 @@ function listCalendars()
 		while (( item = calendarListIterator.getNext()) != undefined ) {
 			calendars[count++] = item;
 		}
-		console.info("Available Calendars: " + calendars.join(", "));
+		log("Available Calendars: " + calendars.join(", "));
 		return calendars;
 	} catch(e) {
 		error('listing calendars:' + e + ', line ' + e.line);
@@ -1217,7 +1594,8 @@ function listCalendars()
 }
 
 // Copies all objects and their properties to an array. Data is copied so nothing gets lost when the reference is removed
-function listToArray(list)
+// Note: this will also set the "CalendarName" property of every entry to the name specified by the calendarName parameter if it has not been defined already
+function listToArray(list, calendarName)
 {
 	var array = new Array();
 	var item;
@@ -1227,41 +1605,46 @@ function listToArray(list)
 		for(var i=0; i < entryFields.length; i++) {
 			itemCopy[entryFields[i]] = item[entryFields[i]];
 		}
+		// for some reason, the CalendarName property is never correctly queried, so we assign it manually here
+		if (!itemCopy['CalendarName']) {
+			itemCopy['CalendarName'] = calendarName;
+		}
 		array.push(itemCopy);
 		txt += array[array.length - 1].Summary + ", ";
 	}
-	console.info("listToArray(): " + txt);
+	log("listToArray(): " + txt);
 	return array;
 }
 
 function sortCalendarEntries(a, b)
 {
 	var atime, btime;
+	log("sortCalendarEntries(" + a.Summary + "," + b.Summary + ")");
 	
-	if (a['InstanceStartTime'] != null) {
-		atime = a['InstanceStartTime'];
+	if (a.InstanceStartTime != null) {
+		atime = a.InstanceStartTime;
 	}
-	else if (a['StartTime'] != null) {
-		atime = a['StartTime'];
+	else if (a.StartTime != null) {
+		atime = a.StartTime;
 	}
-	else if (a['InstanceEndTime'] != null) {
-		atime = a['InstanceEndTime'];
+	else if (a.InstanceEndTime != null) {
+		atime = a.InstanceEndTime;
 	}
-	else if (a['EndTime'] != null) {
-		atime = a['EndTime'];
+	else if (a.EndTime != null) {
+		atime = a.EndTime;
 	}
 	
-	if (b['InstanceStartTime'] != null) {
-		btime = b['InstanceStartTime'];
+	if (b.InstanceStartTime != null) {
+		btime = b.InstanceStartTime;
 	}
-	else if (b['StartTime'] != null) {
-		btime = b['StartTime'];
+	else if (b.StartTime != null) {
+		btime = b.StartTime;
 	}
-	else if (b['InstanceEndTime'] != null) {
-		btime = b['InstanceEndTime'];
+	else if (b.InstanceEndTime != null) {
+		btime = b.InstanceEndTime;
 	}
-	else if (b['EndTime'] != null) {
-		btime = b['EndTime'];
+	else if (b.EndTime != null) {
+		btime = b.EndTime;
 	}
 	
 	if (atime && btime) {
@@ -1277,39 +1660,87 @@ function sortCalendarEntries(a, b)
 			return 1;
 		}
 		// sort by type
-		else if (a['Type'] != b['Type']) {
-			if (a['Type'] < b['Type']) {
+		else if (a.Type != b.Type) {
+			if (a.Type < b.Type) {
 				return -1;
 			}
-			else if (a['Type'] > b['Type']) {
+			else if (a.Type > b.Type) {
 				return 1;
 			}
 		}
 		// sort by description
-		else if (a['Summary'] && b['Summary'] && a['Summary'] != b['Summary']) {
-			if (a['Summary'] < b['Summary']) {
+		else if (a.Summary && b.Summary && a.Summary != b.Summary) {
+			if (a.Summary < b.Summary) {
 				return -1;
 			}
-			else if (a['Summary'] > b['Summary']) {
+			else if (a.Summary > b.Summary) {
 				return 1;
 			}
-		}		
+		}
+	}
+	// NOTE: events my have no date information at all. In that case, we list events without date first
+	else if (atime && !btime) {
+		return 1;
+	}
+	else if (!atime && btime) {
+		return -1;
+	}
+	else if (!atime && !btime) {
+		// sort by type
+		if (a.Type != b.Type) {
+			if (a.Type < b.Type) {
+				return -1;
+			}
+			else if (a.Type > b.Type) {
+				return 1;
+			}
+		}
+		// sort by description
+		else if (a.Summary && b.Summary && a.Summary != b.Summary) {
+			if (a.Summary < b.Summary) {
+				return -1;
+			}
+			else if (a.Summary > b.Summary) {
+				return 1;
+			}
+		}
 	}
 
 	return 0;
 }
+
+function updateCalendarColors()
+{
+	var maxColors = 6;
+	calendarColors = [];
+	if (calendarList.length > maxColors) {
+		log("updateCalendarColors(): Warning: more calendars than available indicator colors");
+	}
+	for(var i=0; i < calendarList.length; i++) {
+		calendarColors[calendarList[i]] = (i % maxColors) + 1;
+	}
+}
+
+function log(message)
+{
+	if (config['enableLogging'].Value) {
+		console.info(message);
+	}
+}
+
 </script>
 
 <style type="text/css">
-table { margin:0px; padding:0px; border-spacing:0px; }
-td { padding:0px 5px 0px 0px; white-space:nowrap; overflow:hidden; }
+a { color:#aaccff }
+table { margin:0px; padding:0px; border-spacing:0px; border-collapse: collapse; }
+td { padding:0px 5px 0px 0px; white-space:nowrap; overflow:hidden; margin:0px; }
 hr { color:#ffffff; background-color:#ffffff; height:1px; text-align:left; border-style:none; }
 .settingsInfo { display:none; font-style:italic; }
 .title { font-weight:bold; font-size:14pt; }
 .textInput { width:90%; }
 .credits { margin-left:40px; text-indent: -20px; margin-bottom:0px; }
-#homescreenView { width: 315px; height:91px; overflow:hidden; }
-#calendarList { position:absolute; left:10px; top:4px; width:295px; height:75px; overflow:hidden; }
+#homescreenView { width: 312px; height:82px; overflow:hidden; }
+#calendarList { position:absolute; left:5px; top:0px; width:307px; height:82px; overflow:hidden; }
 #name { text-align:center; }
 #appicon { display: block; margin-left: auto; margin-right: auto; margin-top: 10px; }
 #smallappicon { width:22px; height:22px; margin-right:10px; float:left; }
@@ -1317,9 +1748,9 @@ hr { color:#ffffff; background-color:#ffffff; height:1px; text-align:left; borde
 
 </head>
 
-<body id="body" class="background">
+<body onload="javascript:setTimeout('init()', 10)" onresize="javascript:updateScreen()" id="body" class="background">
 <div id="homescreenView">
-	<div id="calendarList"></div>
+	<div id="calendarList">loading...</div>
 </div>
 <div id="fullscreenView" style="display:none;">
 	<img src="Icon.png" id="smallappicon">
@@ -1341,11 +1772,17 @@ hr { color:#ffffff; background-color:#ffffff; height:1px; text-align:left; borde
 	<p>Contributions:</p>
 		<p class="credits">Paul Moore (bug fixes, new features and code cleanup)</p>
 		<p class="credits">Manfred Hanselmann (DST support)</p>
-		<p class="credits">Christophe Milsent (translation support & french translation)</p>
-		<p class="credits">Flavio Nathan (portuguese-brazilian translation)</p>
-		<p class="credits">Tokeda (russian translation)</p>
+		<p class="credits">Christophe Milsent (translation support & French translation)</p>
+		<p class="credits">Flavio Nathan (Portuguese-Brazilian translation)</p>
+		<p class="credits">Tokeda (Russian translation)</p>
+		<p class="credits">Marcella Ferrari (Italian translation)</p>
+		<p class="credits">Venos (Italian translation)</p>
+		<p class="credits">Francisco Rodero (Catalan translation)</p>
+		<p class="credits">zbigzbig20 (Polish translation)</p>
+		<p class="credits">Streamkeskus (Finnish translation)</p>
+		<p class="credits">renek (Czech translation)</p>
 	<p>This software is open source and licensed under the GPLv3.</p>
-	<p>Visit sourceforge.net/projects/comingnext for free updates.</p>
+	<p>Visit <a onclick="widget.openURL('http://comingnext.sf.net/'); return false;" href="http://comingnext.sf.net/">comingnext.sf.net</a> for free updates.</p>
 	<hr />
 </div>
 <div id="updateView" style="display:none">