X-Git-Url: https://code.delx.au/comingnext/blobdiff_plain/4eab3a3a4cec2e09f1736439927684d6bd41da87..dd0f2da34b8cc65f4c78e10abf3aa00e35004fd8:/comingNext/index.html

diff --git a/comingNext/index.html b/comingNext/index.html
index f259393..518c31d 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.26";
+var version = "1.33";
 var versionURL = "http://comingnext.sourceforge.net/version.xml";
 var calendarService = null;
 var cacheEntriesHtml = [];
@@ -76,15 +92,37 @@ 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 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.
 
 // vars for daylight saving time
-var daylightsavingWinter = 0;
-var daylightsavingSummer = 0;
-var summertime = false;
-
-window.onload = init;
-window.onresize = updateScreen;
-window.onshow = updateScreen;
+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",
+	"StartTime",
+	"EndTime",
+	"InstanceStartTime",
+	"InstanceEndTime"
+];
 
 function isLeapYear( year ) {
 	if (( year % 4 == 0 && year % 100 != 0 ) || year % 400 == 0 )
@@ -92,7 +130,7 @@ function isLeapYear( year ) {
 	else
 		return false;
 }
-	  
+
 function calcLeapYear(year, days)
 {
 	if (isLeapYear(year))
@@ -109,49 +147,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)
@@ -195,7 +241,7 @@ 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);
 		}
@@ -213,13 +259,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();
@@ -229,7 +273,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];
@@ -245,16 +289,16 @@ 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;
 	}
-	console.info(ids);
+	log(ids);
 	try {
 		var criteria = new Object();
 		criteria.Type = "CalendarEntry";
@@ -264,7 +308,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;
@@ -275,21 +319,60 @@ function requestNotification()
 {
 	var criteria = new Object();
 	criteria.Type = "CalendarEntry";
+	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();
+	criteria2.Type = "CalendarEntry";
+	criteria2.Filter = new Object();
+	criteria2.Filter.LocalIdList = new Array();
+	criteria2.Filter.LocalIdList[0] = settingsCalEntryId;
 	try {
-		var result = calendarService.IDataSource.RequestNotification(criteria, callback);
-		if (result.ErrorCode)
-			error('loading Calendar items list');
+		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)
 {
+	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)
+{
+	log("settingsCallback(): panelNum: " + panelNum + "  transId: " + transId + "  eventCode: " + eventCode + " result.ErrorCode: " + result.ErrorCode);
+	loadSettings();
+}
+
 function parseDate(dateString)
 {
 	/*
@@ -301,60 +384,77 @@ 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;
 }
 
 // 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"
@@ -370,6 +470,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
@@ -427,44 +534,94 @@ 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 meetingListFiltering = {
-			Type:'CalendarEntry',
-			Filter:{
-				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))
+	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
+	}
+
+	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++) {
+				// ignore excluded calendars
+				if (config['excludedCalendars'].Value.indexOf(calendarList[i]) != -1)
+					continue;
+				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]));
 			}
-		}
-		var meetingResult = calendarService.IDataSource.GetList(meetingListFiltering);
-		if (meetingResult.ErrorCode != 0)
-			throw("Error fetching calendar data: " + meetingResult.ErrorCode + ': ' + meetingResult.ErrorMessage);
-		var meetingList = meetingResult.ReturnValue;
-
-		// 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 todayTodoListFiltering = {
-				Type:'CalendarEntry',
-				Filter:{
-					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))
+			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]));
 				}
+				log("updateData(): todayTodoList.sort()");
+				todayTodoList.sort(sortCalendarEntries);
+				entryLists = [todayTodoList, meetingList];
+			} else {
+				entryLists = [meetingList];
 			}
-			var todayTodoResult = calendarService.IDataSource.GetList(todayTodoListFiltering);
-			var todayTodoList = todayTodoResult.ReturnValue;
-			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 {
@@ -497,34 +654,44 @@ 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++) {
-			while (counter < max && (entry = entryLists[i].getNext()) != undefined) {
+			for (var j=0; (counter < max) && (j < entryLists[i].length); j++) {
+				entry = entryLists[i][j];
 				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
@@ -532,7 +699,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
@@ -547,15 +714,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;
@@ -566,7 +733,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;
@@ -576,9 +743,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;
@@ -590,19 +757,19 @@ 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;
 				}
 				
 				// mark overdue todos
 				var overdue = false;
-				if (entry.Type == 'ToDo') {
+				if (entry.Type == 'ToDo' && date != null) {
 					var tmp1 = new Date(date.getFullYear(), date.getMonth(), date.getDate(), 0,0,0);
 					var tmp2 = new Date(now.getFullYear(), now.getMonth(), now.getDate(), 0,0,0);
 					if (tmp1.getTime() < tmp2.getTime()) {
@@ -611,7 +778,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> ';
@@ -620,7 +791,7 @@ function updateData()
 					var time = formatTime(date);
 					var dateStr = formatDate(date, entryDate);
 					if (entry.Type == 'ToDo' && overdue && config['markOverdueTodos'].Value) {
-						dateStr = '<span class="overdue">Overdue</span>';
+						dateStr = '<span class="overdue">' + config['overdueText'].Value + '</span>';
 						entriesHtml += '<td colspan="4" width="1px"><span class="date">' + dateStr + '</span> ';
 					} else if (entry.Type == 'ToDo' || entry.Type == 'Anniversary' || entry.Type == 'DayEvent' || entry.Type == 'Reminder') {
 						if ((isToday(date) || isTomorrow(date)) && config['showTodayAsText'].Value) // show weekday if the date string is not text. looks odd otherwise
@@ -658,14 +829,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;
@@ -680,11 +856,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 {
@@ -699,7 +888,7 @@ function launchCalendar()
 
 function init()
 {
-	console.info('New widget instance starting up...');
+	log('New widget instance starting up...');
 	
 	try {
 		// call calendar service
@@ -708,23 +897,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();
-	updateCssClasses();
+	updateCalendarColors();
 	collectLocales();
 	//updateData();
 	requestNotification();
-	window.setInterval('updateData()', 1000 * 60 * config['updateDataInterval'].Value);
-
-	mode = 0;
-	showHomescreen();
+	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;
+	}
+	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()
@@ -734,15 +959,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);	
 }
@@ -761,18 +989,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();
@@ -790,8 +1031,12 @@ function showSettings()
 	
 	var settingsHtml = '<form>';
 	for (var key in config) {
-		if (config[key].Type == 'String')
-			settingsHtml += '<table><tr><td>' + getLocalizedText('settings.name.' + key) + '<br /><input class="textInput" name="settings.' + key + '" type="text" value="' + config[key].Value + '" /></td>' + printHintBox(getLocalizedText('settings.info.' + key)) + '<hr />';
+		if (config[key].Type == 'String') {
+			var prefix = "";
+			if (key.substring(0,9) == "cssStyle_")
+				prefix = getLocalizedText('settings.cssStyle_prefix');
+			settingsHtml += '<table><tr><td>' + prefix + getLocalizedText('settings.name.' + key) + '<br /><input class="textInput" name="settings.' + key + '" type="text" value="' + config[key].Value + '" /></td>' + printHintBox(getLocalizedText('settings.info.' + key)) + '<hr />';
+		}
 		else if (config[key].Type == 'Int')
 			settingsHtml += '<table><tr><td>' + getLocalizedText('settings.name.' + key) + '<br /><input class="textInput" name="settings.' + key + '" type="text" value="' + config[key].Value + '" /></td>' + printHintBox(getLocalizedText('settings.info.' + key)) + '<hr />';
 		else if (config[key].Type == 'Bool')
@@ -804,6 +1049,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>';
@@ -829,6 +1086,58 @@ function updateCssClasses()
 	}
 }
 
+function getSettingsCalEntryId()
+{
+	if (settingsCalEntryId == null) {
+		// check if entry already exists
+		var listFiltering = {
+			Type:'CalendarEntry', 
+			Filter:{
+				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 = 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;
+			log("settingsCalEntryId=" + settingsCalEntryId);
+		}
+		else { // create settings item
+			var item = new Object();
+			item.Type = "DayEvent";
+			item.StartTime = new Date(2000, 0, 1);
+			item.Summary = "ComingNext Settings|";
+			
+			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("getSettingsCalEntryId: " + e + ', line ' + e.line);
+			}
+
+			getSettingsCalEntryId();
+		}
+	}
+}
+
 function restoreDefaultSettings()
 {
 	for (var key in config)
@@ -837,39 +1146,117 @@ function restoreDefaultSettings()
 
 function loadSettings()
 {
-	for (var key in config) {
-		if (widget.preferenceForKey(key)) {
-			if (config[key].Type == 'Int')
-				config[key].Value = Number(widget.preferenceForKey(key));
-			else if (config[key].Type == 'String')
-				config[key].Value = widget.preferenceForKey(key);
-			else if (config[key].Type == 'Bool')
-				config[key].Value = (widget.preferenceForKey(key) == 'true')
-			else if (config[key].Type == 'Enum')
-				config[key].Value = widget.preferenceForKey(key);
-			else if (config[key].Type == 'UID')
-				config[key].Value = Number(widget.preferenceForKey(key));
+	getSettingsCalEntryId();
+	var listFiltering = {
+		Type:'CalendarEntry', 
+		Filter:{
+			LocalId: settingsCalEntryId
 		}
-		else
-			config[key].Value = config[key].Default;
-		console.info('Settings: ' + key + '=\'' + config[key].Value + '\'');
+	}
+	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)
+		{
+			restoreDefaultSettings();
+			var stringlist = entry.Summary.split("|");
+			// skip the first two entries, those contain header and version info
+			for(var i = 2; i < stringlist.length - 1; i++) {
+				var pair = stringlist[i].split('=');
+				var key = pair[0];
+				var value = pair[1];
+				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') {
+					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");
 	}
 }
 
 function saveSettings()
 {
+	getSettingsCalEntryId();
+	var item = new Object();
+	item.Type = "DayEvent";
+	item.StartTime = new Date(2000, 0, 1);
+	item.LocalId = settingsCalEntryId;
+	item.Summary = "ComingNext Settings|" + version + "|";
+
 	for (var key in config) {
 		if (config[key].Type == 'Int')
-			widget.setPreferenceForKey(config[key].Value.toString(), key);
+			item.Summary += key + "=" + config[key].Value.toString() + "|";
 		else if (config[key].Type == 'String')
-			widget.setPreferenceForKey(config[key].Value, key);
+			item.Summary += key + "=" + config[key].Value + "|";
 		else if (config[key].Type == 'Bool')
-			widget.setPreferenceForKey(config[key].Value ? 'true' : 'false', key);
+			item.Summary += key + "=" + (config[key].Value ? 'true' : 'false') + "|";
 		else if (config[key].Type == 'Enum')
-			widget.setPreferenceForKey(config[key].Value, key);
+			item.Summary += key + "=" + config[key].Value + "|";
 		else if (config[key].Type == 'UID')
-			widget.setPreferenceForKey(config[key].Value.toString(), key);
+			item.Summary += key + "=" + config[key].Value.toString() + "|";
+		else if (config[key].Type == 'Array')
+			item.Summary += key + "=" + config[key].Value.join("^") + "|";
+	}
+	settingsCache = item.Summary;
+	
+	var criteria = new Object();
+	criteria.Type = "CalendarEntry";
+	criteria.Item = item;
+
+	log("Saving settings to calendar entry: " + item.Summary);
+	try {
+		var result = calendarService.IDataSource.Add(criteria);
+		if (result.ErrorCode)
+			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)
@@ -906,22 +1293,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';
@@ -933,14 +1328,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() + ')';
@@ -956,6 +1359,7 @@ function updateHomescreen()
 
 function showHomescreen()
 {
+	log("showHomescreen()");
 	hideViews();
 	document.getElementById("homescreenView").style.display = "block";
 	document.getElementById('body').className = "background";
@@ -1035,9 +1439,179 @@ function hideViews()
 	document.getElementById("settingsView").style.display = "none";
 	document.getElementById("updateView").style.display = "none";
 }
+
+function listCalendars()
+{
+	if (errorOccured) {
+		return null;
+	}
+
+	try {
+		var criteria = {
+			Type:'Calendar', 
+			Filter:{
+				DefaultCalendar: false
+			}
+		}
+		
+		var calendarsResult = calendarService.IDataSource.GetList(criteria);
+		if (calendarsResult.ErrorCode != 0)
+			throw("Error fetching list of calendars: " + calendarsResult.ErrorCode + ': ' + calendarsResult.ErrorMessage);
+		var calendarListIterator = calendarsResult.ReturnValue;
+		
+		var calendars = [];
+		var count = 0;
+		var item;
+		while (( item = calendarListIterator.getNext()) != undefined ) {
+			calendars[count++] = item;
+		}
+		log("Available Calendars: " + calendars.join(", "));
+		return calendars;
+	} catch(e) {
+		error('listing calendars:' + e + ', line ' + e.line);
+		return null;
+	}
+}
+
+// Copies all objects and their properties to an array. Data is copied so nothing gets lost when the reference is removed
+// 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;
+	var txt = "";
+	while (( item = list.getNext()) != undefined ) {
+		var itemCopy = new Object();
+		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 + ", ";
+	}
+	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;
+	}
+	else if (a.StartTime != null) {
+		atime = a.StartTime;
+	}
+	else if (a.InstanceEndTime != null) {
+		atime = a.InstanceEndTime;
+	}
+	else if (a.EndTime != null) {
+		atime = a.EndTime;
+	}
+	
+	if (b.InstanceStartTime != null) {
+		btime = b.InstanceStartTime;
+	}
+	else if (b.StartTime != null) {
+		btime = b.StartTime;
+	}
+	else if (b.InstanceEndTime != null) {
+		btime = b.InstanceEndTime;
+	}
+	else if (b.EndTime != null) {
+		btime = b.EndTime;
+	}
+	
+	if (atime && btime) {
+	
+		atime = parseDate(atime);
+		btime = parseDate(btime);
+	
+		// sort by date & time
+		if (atime < btime) {
+			return -1;
+		}
+		else if (atime > btime) {
+			return 1;
+		}
+		// sort by type
+		else 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;
+			}
+		}
+	}
+	// 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; }
@@ -1046,7 +1620,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; }
@@ -1054,9 +1628,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">
@@ -1066,7 +1640,7 @@ hr { color:#ffffff; background-color:#ffffff; height:1px; text-align:left; borde
 </div>
 <div id="settingsView" style="display:none">
 	<img src="Icon.png" id="smallappicon">
-	<h1 class="title">Settings</h1>
+	<h1 id="settingsTitle" class="title">Settings</h1>
 	<hr />
 	<div id="settingsList"></div>
 </div>
@@ -1078,10 +1652,13 @@ 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">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">