]> code.delx.au - comingnext/blob - Readme.txt
note about the new overdue setting in readme
[comingnext] / Readme.txt
1 ------------------------------------
2 ComingNext & Coming Next B for N97
3 ------------------------------------
4 This widget was originally created by Dr. Cochambre and was extended by
5 Michael Prager <X_X_L@gmx.net>. It will display the next 8 upcoming events
6 on your N97 homescreen. It consists of two seperate widgets, each displaying
7 4 events.
8
9 For more info or to report bugs, please refere to
10 http://sourceforge.net/projects/comingnext
11 and
12 http://www.symbian-freak.com/forum/viewtopic.php?t=38045
13
14 You can change the appearance (background color, font color, font size etc.)
15 and settings from within the widget now. To make the widget background
16 transparent, follow these steps:
17
18 1. install "ComingNext Skin Fetcher" on your phone
19 2. start it on your phone and click on "Generate". It will ask you for the
20 positions of the ComingNext widgets on the homescreen.
21 3. In the ComingNext widget, enable the "use background image" option and set
22 "background image location" to "external"
23
24
25 known limitations:
26 ------------------
27 - ToDos might show up although they have been marked "done". This is a bug in
28 Nokias WRT library: entry.Status sometimes is undefined.
29 - real transparent background: I haven't found a way todo this yet. All the
30 widgets that have transparent background are no WRT widgets. Nokia?
31 - There is no automatic detection if you're in a timezone that uses daylight
32 saving time (DST). By default, the widget assumes that you're in a timezone
33 that has a 1h DST. If this is not the case, please change the
34 "enable Daylight Saving" setting within the widget.
35
36
37 License:
38 --------
39 This software is open source and licensed under the GPLv3. See License.txt
40 for details.
41
42
43 Changelog:
44 ----------
45 1.0 (2009-08-25) by cochambre
46 - initial release by cochambre
47 1.01 (2009-08-25) by cochambre
48 - fix some language localizations
49 1.02 (2009-08-27) by cochambre
50 - jquery library removed (ram footprint reduction, about 1 mb now)
51 - displaying ToDos from current day
52 - calendar is loaded up to 2 months ahead of current day (ram footprint
53 reduction)
54 - calendar app launches and closes much faster
55 - more explicit error messages (post them here if you get one)
56 1.10 (2009-08-27) by Michael Prager
57 - Only 4 lines per widget, also use the bigger default font and a bigger
58 font size
59 - added icons to easier distinguish between todos, meetings, birthdays etc
60 - removed the big icon and the today's date info as this info is already
61 present on the homescreen
62 - format months as numbers instead of text to give more room for the actual
63 event text
64 - display location if set in meetings
65 - only update once per hour. But at the same time, react instantly on any
66 calendar changes made by the user. This is done using a callback. Should
67 save a lot of battery
68 - display all todos from within the last year, if they are not marked as
69 "done". The original version will only display todos that have a
70 termination time in the future.
71 1.11 (2009-08-27) by Michael Prager
72 - added fix suggested by yves: use InstanceStartTime instead of StartTime
73 if available
74 - use a <table> to align columns instead of loose <div> boxes
75 - output line number in case of an error. This should help debugging
76 problems
77 internals for developers:
78 - added changelog to keep track of changes more easily
79 - added switch (var panelNum) so the same code can be used for both,
80 "ComingNext" and "ComingNextB" widgets
81 1.12 (2009-08-28) by Michael Prager
82 - support for all date formats (YYYY-MM-DD, DD-MM-YYYY, MM-DD-YYYY)
83 - format dates and times as 01.01 instead of 1.1
84 - output more details to error log if JavaScript logging is enabled in web
85 browser
86 - added variable to enable/disable ToDos in the event list
87 - added variable to define the number months to include in the event list
88 1.13 (2009-08-28) by Michael Prager
89 - support for ToDos without dates
90 - support for events without summary
91 - fixed date format parsing for MM-DD-YYYY (finally ;-))
92 - fixed months beeing off by 1
93 1.14 (2009-08-28) by Michael Prager
94 - support for fake transparent backgrounds.
95 1.15 (2009-08-30) by Michael Prager
96 - added separate Readme.txt
97 - use the date format defined by the system (e.g. "31.12" or "12.31")
98 - show a colored "Today" for the current day instead of full date
99 - added options for showTodayAsText, todayText, dateSeparator and
100 weekDayLength. These options can be found at the begin of index.html
101 - added CSS classes for weekday, date, time and description so you can
102 customize everything very easily. Moved these CSS definitions to the
103 begin of index.html so they are easy to spot.
104 - fixed table alignment for very long event descriptions
105 - comingNext is now licensed under the GPLv3
106 1.16 (2009-08-31) by Michael Prager
107 - applied patch by pcmoore: Fixed a bug where all times are reported as
108 "AM" regardless of the actual event time
109 - applied patch by pcmoore: new option to define which calendar app to
110 start when clicking the widget (calendarApp). By default this is the
111 buildin calendar, but you can run Epocware Handy Calendar or any other
112 app.
113 - 5 new options: showNowAsText, nowText, dateFormat, updateDataInterval
114 and calendarApp
115 - events that last for multiple days will now properly show "Today"
116 - if an event is currently taking place, display "Now" instead of the
117 event staring time. This behaviour can be disabled with the
118 showNowAsText option. You can change the color of the "Now" text by
119 changing the .now CSS class
120 - users can now configure the update interval. The default setting is now
121 5 minutes. This should not use too much battery, but at the same time
122 keep the "Now" text up-to-date
123 - added option to force a specific date format. dateFormat='auto'
124 (default) will use your phone's setting, 'DDMM' will display day first,
125 'MMDD' will display month first.
126 1.17 (2009-09-02) by Michael Prager
127 - fixed anniversaries for today not showing
128 - new option "eventsPerWidget": with this you can define the number of
129 events that will be shown for each widget.
130 - added new CSS class "icon": change this to modify the icon size (very
131 useful if you want to change the number of events)
132 1.18 (2009-09-04) by Michael Prager
133 - fixed ToDos being shown although includeTodos=false was set
134 - fixed ToDos being shown twice
135 - show text "No further events within 2 months" if there are no events
136 in the list. This behaviour and the text can be changed in the settings
137 1.19 (2009-09-04) by Michael Prager
138 - refixed problems that 1.18 should have solved (todos not showing, entries
139 showing twice)
140 1.20 (2009-09-05) by Michael Prager
141 - new project website at http://sourceforge.net/projects/comingnext
142 - fixed memos/anniversaries showing although they have already passed
143 - don't display weekday if date is 'Today'
144 - changed default 'Now' color to #ff00ff to make it different from the
145 'Today' color
146 - patch by pcmoore:
147 - Fix problem with appointments starting at 12p where they
148 would display as starting 12h later (midnight the following day)
149 - Add a new feature to only display the time for events happening today
150 and only the date for events beyond today (showCombinedDateTime)
151 - Add a new feature to disable showing the location of appointments
152 (showLocation)
153 1.21 (2009-10-13) by Michael Prager
154 - support daylight saving time (DST). This is based on the modifications
155 from Manfred Hanselmann (thanks for that!)
156 - added option "enableDaylightSaving" to disable DST. In case you are in a
157 timezone that has no DST, you should use this option
158 - some code cleanup (by Paul Moore)
159 - fixed alignment when calendar entries have very long description
160 1.22 (2009-12-07) by Michael Prager
161 - show "Tomorrow" instead of date if "showTodayAsText" is enabled
162 1.23 (2009-12-18) by Michael Prager
163 - added fullscreen mode (can list 30 events)
164 - added settings menu. Need to modify the widget manually anymore.
165 - fixed table cell alignment in cases where the event summary was very long
166 - fixed display of "tomorrow" text if CombinedDateTime is enabled
167 1.24 (2010-01-01) by Michael Prager
168 - localization support added by Christophe Milsent
169 - added french translation by Christophe Milsent
170 - added german translation
171 - new option "hide Widget On Calendar Open". When enabled, this will close
172 the fullscreen widget when opening the calendar app
173 - code cleanup and size reduction
174 - update interval to detect screen rotation increased from 3 to 1 secs
175 - open calendar app when clicking anywhere in fullscreen view
176 1.25 (2010-02-21) by Michael Prager
177 - fixed reoccurring events not beeing shown
178 - added "check for updates" feature
179 - added "ComingNext Skin Fetcher v1.1" tool
180 - support for external background images (useful in combination with the
181 new skin fetcher tool). With this, you won't need to modify the widget
182 anymore to use a custom background image
183 - added portuguese-brazilian translation by Flavio Nathan
184 1.26 () by Michael Prager
185 - fixed second panel showing the same events as the first panel
186 - mark overdue ToDo events (this feature can be disabled in the settings)