X-Git-Url: https://code.delx.au/comingnext/blobdiff_plain/abc614453db2cfd8d85b80ae49c61f1577e6c8f6..5c7f1e68a4931e790736e65ae80c0f9018ccf1a5:/comingNext/index.html

diff --git a/comingNext/index.html b/comingNext/index.html
index 372489b..853e41e 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,7 +83,7 @@ var config = {
 // Nothing of interest from here on...
 //-------------------------------------------------------
 var panelNum = 0; // use 1 for second panel
-var version = "1.29";
+var version = "1.32";
 var versionURL = "http://comingnext.sourceforge.net/version.xml";
 var calendarService = null;
 var cacheEntriesHtml = [];
@@ -78,19 +94,26 @@ var mode = 0; // 0 = homescreen, 1 = fullscreen, 2 = settings, 3 = about, 4 = ch
 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
 
 // 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 +123,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 +146,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)
@@ -231,10 +258,8 @@ 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);
@@ -263,7 +288,7 @@ 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++;
@@ -272,7 +297,7 @@ function collectLocales()
 		error(e + ', line ' + e.line);
 		return;
 	}
-	console.info(ids);
+	log(ids);
 	try {
 		var criteria = new Object();
 		criteria.Type = "CalendarEntry";
@@ -282,7 +307,7 @@ 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;
@@ -293,13 +318,17 @@ 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 +336,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();
 }
 
@@ -382,18 +425,26 @@ function parseDate(dateString)
 	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);
-
+	var result = new Date(year, month - 1, day, hours, minutes, 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;
 }
 
 // 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"
@@ -466,58 +517,84 @@ function formatTime(date)
 
 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));
-		}
-		console.info("updateData(): meetingList.sort()");
-		meetingList.sort(sortCalendarEntries);
+	log('updateData()');
+	if (errorOccured) {
+		return;
+	}
+
+	// check if we got additional or less calendars since our last update
+	var newCalendarList = listCalendars();
+	if (newCalendarList.length != calendarList.length) {
+		calendarList = newCalendarList;
+		updateCalendarColors();
+		cancelNotification();
+		requestNotification();
+		lastReloadTime = null; // force calendar data reload on this update
+	}
 
-		// 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 = [];
+	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];
 			}
-			console.info("updateData(): todayTodoList.sort()");
-			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 {
@@ -550,16 +627,18 @@ function updateData()
 		else
 			max = 30; // we can display a lot more events in fullscreen mode
 
-		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 + ", ";
+		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);
 			}
-			console.info("updateData(): entrieslist: " + entrieslist);
+			log("updateData(): inner loop, " + entryLists.length + " lists, [" + listinfo + "] entries");
 		}
-		console.info("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++) {
@@ -574,18 +653,18 @@ function updateData()
 						entryInfo += entryFields[k] + "=" + entry[entryFields[k]] + ",";
 					}
 				}
-				console.info(entryInfo);
+				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
@@ -593,7 +672,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
@@ -608,15 +687,15 @@ 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 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;
@@ -627,7 +706,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;
@@ -637,9 +716,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;
@@ -651,13 +730,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;
 				}
 				
@@ -672,7 +751,11 @@ 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> ';
@@ -719,14 +802,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()');
+
 	// check if opening fullscreen
 	if( window.innerHeight > 91 && mode == 0) {
 		mode = 1;
@@ -741,11 +829,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 {
@@ -760,7 +861,7 @@ function launchCalendar()
 
 function init()
 {
-	console.info('New widget instance starting up...');
+	log('New widget instance starting up...');
 	
 	try {
 		// call calendar service
@@ -769,30 +870,57 @@ 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');
-
+	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;
 	}
-	console.info("init(): updateScreen()");
+	log("init(): updateScreen()");
 	updateScreen();
 	if (config['useBackgroundImage'].Value)
 		// check for screen rotation every 1 secs
-		window.setInterval('updateScreen()', 1000 * 1);
-	console.info("init(): finished...");
+		screenRotationTimer = window.setInterval('checkOrientation()', 1000 * 1);
+	
+	// call updateScreen() when widget changes from background to forground
+	window.widget.onshow = handleOnShow;
+
+	log("init(): finished...");
+}
+
+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()
@@ -802,15 +930,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);	
 }
@@ -829,18 +960,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();
@@ -876,6 +1020,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>';
@@ -908,8 +1064,8 @@ 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'
 			}
@@ -923,7 +1079,7 @@ function getSettingsCalEntryId()
 		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();
@@ -970,7 +1126,7 @@ function loadSettings()
 	}
 	var entry = result.ReturnValue.getNext();
 	if (entry != undefined)	{
-		console.info("Loading Settings...");
+		log("Loading Settings...");
 		// only reload settings if they chanced since the last reload
 		if (settingsCache != entry.Summary)
 		{
@@ -981,23 +1137,39 @@ 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: ' + 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 {
-			console.info("Settings already cached and did not change");
+			log("Settings already cached and did not change");
 		}
 	}
 	else {
@@ -1025,6 +1197,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;
 	
@@ -1032,7 +1206,7 @@ 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)
@@ -1040,6 +1214,10 @@ function saveSettings()
 	} catch (e) {
 		error("saveSettings: " + e + ', line ' + e.line);
 	}
+	
+	lastReloadTime = null; // force calendar data reload on next update
+	clearUpdateTimer();
+	setUpdateTimer();
 }
 
 function toggleVisibility(elementId)
@@ -1076,23 +1254,30 @@ function showAbout()
 	document.getElementById("name").innerHTML = "Coming Next " + version;
 }
 
+function showHelp() {
+	widget.openURL('http://comingnext.sf.net/help');
+}
+
 function updateFullscreen()
 {
 }
 
 function showFullscreen()
 {
-	console.info("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';
@@ -1127,7 +1312,7 @@ function updateHomescreen()
 
 function showHomescreen()
 {
-	console.info("showHomescreen()");
+	log("showHomescreen()");
 	hideViews();
 	document.getElementById("homescreenView").style.display = "block";
 	document.getElementById('body').className = "background";
@@ -1210,6 +1395,10 @@ function hideViews()
 
 function listCalendars()
 {
+	if (errorOccured) {
+		return null;
+	}
+
 	try {
 		var criteria = {
 			Type:'Calendar', 
@@ -1229,7 +1418,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);
@@ -1238,7 +1427,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;
@@ -1248,17 +1438,21 @@ 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;
-	console.info("sortCalendarEntries(" + a.Summary + "," + b.Summary + ")");
+	log("sortCalendarEntries(" + a.Summary + "," + b.Summary + ")");
 	
 	if (a.InstanceStartTime != null) {
 		atime = a.InstanceStartTime;
@@ -1317,13 +1511,60 @@ function sortCalendarEntries(a, b)
 			}
 		}
 	}
+	// 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">
+a { color:#aaccff }
 table { margin:0px; padding:0px; border-spacing:0px; }
 td { padding:0px 5px 0px 0px; white-space:nowrap; overflow:hidden; }
 hr { color:#ffffff; background-color:#ffffff; height:1px; text-align:left; border-style:none; }
@@ -1332,7 +1573,7 @@ hr { color:#ffffff; background-color:#ffffff; height:1px; text-align:left; borde
 .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; }
+#calendarList { position:absolute; left:5px; top:4px; width:295px; height:75px; 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; }
@@ -1340,9 +1581,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">
@@ -1367,8 +1608,10 @@ hr { color:#ffffff; background-color:#ffffff; height:1px; text-align:left; borde
 		<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>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">