X-Git-Url: https://code.delx.au/comingnext/blobdiff_plain/34fd186d3247b6b11faa7ad5cce8391ab5e7e3b6..425ada1748988af6de379edb00cca52c2a4eadf2:/comingNext/index.html

diff --git a/comingNext/index.html b/comingNext/index.html
index f098716..14da1c3 100644
--- a/comingNext/index.html
+++ b/comingNext/index.html
@@ -7,29 +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 {}
-.calendar1 {}
-.calendar2 {}
-.calendar3 {}
-.calendar4 {}
-.calendar5 {}
-.calendar6 {}
+.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,},
@@ -56,6 +56,8 @@ var config = {
 	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: '',},
@@ -81,11 +83,12 @@ var config = {
 // Nothing of interest from here on...
 //-------------------------------------------------------
 var panelNum = 0; // use 1 for second panel
-var version = "1.30";
+var version = "1.33";
 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
@@ -97,6 +100,12 @@ 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.
 
 // vars for daylight saving time
 var summertime = false; // true, if current date is in summer, false if in winter
@@ -116,17 +125,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))
@@ -191,6 +196,9 @@ 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)
@@ -234,7 +242,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);
 		}
@@ -252,13 +280,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();
@@ -268,7 +294,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];
@@ -284,16 +310,52 @@ 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;
+	}
+	try {
+		var entry;
+		var counter2 = 0;
+		var curWeekday = "";
+
+		while (weekdaylist && (entry = weekdaylist.getNext()) != undefined) {
+			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;
 	}
-	console.info(ids);
+	log(ids);
 	try {
 		var criteria = new Object();
 		criteria.Type = "CalendarEntry";
@@ -303,7 +365,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;
@@ -357,13 +419,14 @@ function cancelNotification()
 
 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();
 }
 
@@ -378,49 +441,58 @@ 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;
-
-	var result = new Date(year, month - 1, day, hours, minutes, seconds);
 	
 	// take care of daylight saving time
 	if (config['enableDaylightSaving'].Value) {
@@ -431,17 +503,25 @@ function parseDate(dateString)
 		// 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
-			console.info('parseDate(): fixing time -1h: ' + result);
+			log('parseDate(): fixing time -1h: ' + result);
 		}
 		else if (!summertime && dateSummerTime) {
 			result = new Date(result.getTime() + 1000 * 60 * 60 * config['daylightSavingOffset'].Value); // +1 hour
-			console.info('parseDate(): fixing time +1h: ' + result);
+			log('parseDate(): fixing time +1h: ' + result);
 		}
 	}
 
 	return result;
 }
 
+function getWeekdayLocalized(date) {
+	var localizedString = date.toLocaleDateString();
+	if (localizedString.match(/\d\d\/\d\d\/\d\d/)) {
+		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"
 function formatDate(date, format)
 {
@@ -455,6 +535,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
@@ -512,68 +599,94 @@ function formatTime(date)
 
 function updateData()
 {
-	console.info('updateData()');
+	log('updateData()');
+	if (errorOccured) {
+		return;
+	}
 
 	// 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 laster...');
+		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
 	}
-	
-	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();
-		summertime = isSummertime(now); // cache summer time info for today
-		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, calendarList[i]));
-		}
-		console.info("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 = [];
+	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, calendarList[i]));
+				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 {
@@ -606,16 +719,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++) {
@@ -630,18 +745,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
@@ -649,7 +764,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
@@ -664,15 +779,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;
@@ -683,7 +798,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;
@@ -693,9 +808,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;
@@ -707,13 +822,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;
 				}
 				
@@ -729,7 +844,7 @@ function updateData()
 
 				// generate html output
 				entriesHtml += '<tr>';
-				if (config['showCalendarIndicator'].Value && calendarList.length > 1) {
+				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>';
@@ -737,7 +852,9 @@ function updateData()
 					// 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) {
@@ -779,14 +896,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;
@@ -801,11 +923,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 {
@@ -820,7 +955,7 @@ function launchCalendar()
 
 function init()
 {
-	console.info('New widget instance starting up...');
+	log('New widget instance starting up...');
 	
 	try {
 		// call calendar service
@@ -829,8 +964,8 @@ 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();
@@ -847,12 +982,25 @@ function init()
 	else {
 		mode = 1;
 	}
-	console.info("init(): updateScreen()");
+	log("init(): updateScreen()");
 	updateScreen();
 	if (config['useBackgroundImage'].Value)
 		// check for screen rotation every 1 secs
-		screenRotationTimer = 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...");
+	if (!errorOccured)
+		statupSuccessful = true;
+}
+
+function checkOrientation()
+{
+	//updateScreen();
+	if (mode == 0)
+		updateHomescreen(); // check for screen rotation
 }
 
 function setUpdateTimer()
@@ -867,7 +1015,7 @@ function clearUpdateTimer()
 
 function updateTimerCallback()
 {
-	console.info("updateTimerCallback()");
+	log("updateTimerCallback()");
 	updateData();
 }
 
@@ -878,15 +1026,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);	
 }
@@ -905,18 +1056,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();
@@ -952,6 +1116,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>';
@@ -984,22 +1160,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();
@@ -1014,7 +1195,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);
 			}
@@ -1039,14 +1220,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)	{
-		console.info("Loading Settings...");
+		log("Loading Settings...");
 		// only reload settings if they chanced since the last reload
 		if (settingsCache != entry.Summary)
 		{
@@ -1057,23 +1243,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 {
@@ -1101,6 +1303,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;
 	
@@ -1108,15 +1312,16 @@ 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();
 }
@@ -1155,23 +1360,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';
@@ -1183,14 +1395,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() + ')';
@@ -1206,7 +1426,7 @@ function updateHomescreen()
 
 function showHomescreen()
 {
-	console.info("showHomescreen()");
+	log("showHomescreen()");
 	hideViews();
 	document.getElementById("homescreenView").style.display = "block";
 	document.getElementById('body').className = "background";
@@ -1289,6 +1509,10 @@ function hideViews()
 
 function listCalendars()
 {
+	if (errorOccured) {
+		return null;
+	}
+
 	try {
 		var criteria = {
 			Type:'Calendar', 
@@ -1308,7 +1532,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);
@@ -1335,14 +1559,14 @@ function listToArray(list, 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;
@@ -1401,6 +1625,33 @@ 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;
 }
@@ -1410,16 +1661,24 @@ function updateCalendarColors()
 	var maxColors = 6;
 	calendarColors = [];
 	if (calendarList.length > maxColors) {
-		console.info("updateCalendarColors(): Warning: more calendars than available indicator colors");
+		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; }
@@ -1436,9 +1695,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">
@@ -1463,8 +1722,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 <a href="http://sourceforge.net/projects/comingnext">sourceforge.net/projects/comingnext</a> 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">