code.delx.au - comingnext/blob - 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 Oxidative <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://www.symbian-freak.com/forum/viewtopic.php?t=38045
  11
  12 You can change the appearance (background color, font color, font size etc.)
  13 and settings by modifying the widget:
  14
  15   1. rename comingNext.wgz to comingNext.zip
  16   2. edit comingNext.zip/comingNext/index.html and customize the settings
  17      at the top of the document. For example, to change the background to
  18      a solid red color, set:
  19        .background { ... background-color:#ff0000; ... }
  20        useBackgroundImage = false;
  21   3. rename comingNext.zip back to comingNext.wgz
  22   4. do the same for comingNextB.wgz
  23
  24 To add your custom background/fake transparency, follow these steps:
  25
  26   1. rename comingNext.wgz to comingNext.zip
  27   2. replace comingNext.zip/comingNext/background_landscape.png and
  28      background_portrait.png with your desired background.
  29   3. rename comingNext.zip back to comingNext.wgz
  30   4. do the same for comingNextB.wgz
  31
  32 I recommend to use a program to make a screenshot of your current
  33 homescreen background, then use a painting program like GIMP to
  34 cut out the pieces you need. Use background_mask_landscape.png and
  35 background_mask_portrait.png for guidance on what parts of the screen are
  36 used by widgets.
  37
  38
  39 known limitations:
  40 ------------------
  41 - ToDos might show up although they have been marked "done". This is a bug in
  42   Nokias WRT library: entry.Status sometimes is undefined.
  43 - real transparent background: I haven't found a way todo this yet. All the
  44   widgets that have transparent background are no WRT widgets. Nokia?
  45
  46
  47 License:
  48 --------
  49 This software is open source and licensed under the GPLv3. See License.txt
  50 for details.
  51
  52
  53 Changelog:
  54 ----------
  55 1.0 (2009-08-25) by cochambre
  56   - initial release by cochambre
  57 1.01 (2009-08-25) by cochambre
  58   - fix some language localizations
  59 1.02 (2009-08-27) by cochambre
  60   - jquery library removed (ram footprint reduction, about 1 mb now)
  61   - displaying ToDos from current day
  62   - calendar is loaded up to 2 months ahead of current day (ram footprint
  63     reduction)
  64   - calendar app launches and closes much faster
  65   - more explicit error messages (post them here if you get one)
  66 1.10 (2009-08-27) by Oxidative
  67   - Only 4 lines per widget, also use the bigger default font and a bigger
  68     font size
  69   - added icons to easier distinguish between todos, meetings, birthdays etc
  70   - removed the big icon and the today's date info as this info is already
  71     present on the homescreen
  72   - format months as numbers instead of text to give more room for the actual
  73     event text
  74   - display location if set in meetings
  75   - only update once per hour. But at the same time, react instantly on any
  76     calendar changes made by the user. This is done using a callback. Should
  77     save a lot of battery
  78   - display all todos from within the last year, if they are not marked as
  79     "done". The original version will only display todos that have a
  80     termination time in the future.
  81 1.11 (2009-08-27) by Oxidative
  82   - added fix suggested by yves: use InstanceStartTime instead of StartTime
  83     if available
  84   - use a <table> to align columns instead of loose <div> boxes
  85   - output line number in case of an error. This should help debugging
  86     problems
  87   internals for developers:
  88     - added changelog to keep track of changes more easily
  89     - added switch (var panelNum) so the same code can be used for both,
  90       "ComingNext" and "ComingNextB" widgets
  91 1.12 (2009-08-28) by Oxidative
  92   - support for all date formats (YYYY-MM-DD, DD-MM-YYYY, MM-DD-YYYY)
  93   - format dates and times as 01.01 instead of 1.1
  94   - output more details to error log if JavaScript logging is enabled in web
  95     browser
  96   - added variable to enable/disable ToDos in the event list
  97   - added variable to define the number months to include in the event list
  98 1.13 (2009-08-28) by Oxidative
  99   - support for ToDos without dates
 100   - support for events without summary
 101   - fixed date format parsing for MM-DD-YYYY (finally ;-))
 102   - fixed months beeing off by 1
 103 1.14 (2009-08-28) by Oxidative
 104   - support for fake transparent backgrounds.
 105 1.15 (2009-08-30) by Oxidative
 106   - added separate Readme.txt
 107   - use the date format defined by the system (e.g. "31.12" or "12.31")
 108   - show a colored "Today" for the current day instead of full date
 109   - added options for showTodayAsText, todayText, dateSeparator and
 110     weekDayLength. These options can be found at the begin of index.html
 111   - added CSS classes for weekday, date, time and description so you can
 112     customize everything very easily. Moved these CSS definitions to the
 113     begin of index.html so they are easy to spot.
 114   - fixed table alignment for very long event descriptions
 115   - comingNext is now licensed under the GPLv3
 116 1.16 (2009-08-31) by Oxidative
 117   - applied patch by pcmoore: Fixed a bug where all times are reported as
 118     "AM" regardless of the actual event time
 119   - applied patch by pcmoore: new option to define which calendar app to
 120     start when clicking the widget (calendarApp). By default this is the
 121     buildin calendar, but you can run Epocware Handy Calendar or any other
 122     app.
 123   - 5 new options: showNowAsText, nowText, dateFormat, updateDataInterval
 124     and calendarApp
 125   - events that last for multiple days will now properly show "Today"
 126   - if an event is currently taking place, display "Now" instead of the
 127     event staring time. This behaviour can be disabled with the
 128     showNowAsText option. You can change the color of the "Now" text by
 129     changing the .now CSS class
 130   - users can now configure the update interval. The default setting is now
 131     5 minutes. This should not use too much battery, but at the same time
 132     keep the "Now" text up-to-date
 133   - added option to force a specific date format. dateFormat='auto'
 134     (default) will use your phone's setting, 'DDMM' will display day first,
 135     'MMDD' will display month first.
 136 1.17 (2009-09-02) by Oxidative
 137   - fixed anniversaries for today not showing
 138   - new option "eventsPerWidget": with this you can define the number of
 139     events that will be shown for each widget.
 140   - added new CSS class "icon": change this to modify the icon size (very
 141     useful if you want to change the number of events)
 142 1.18 (2009-09-04) by Oxidative
 143   - fixed ToDos being shown although includeTodos=false was set
 144   - fixed ToDos being shown twice
 145   - show text "No further events within 2 months" if there are no events
 146     in the list. This behaviour and the text can be changed in the settings
 147 1.19 (2009-09-04) by Oxidative
 148   - refixed problems that 1.18 should have solved (todos not showing, entries
 149     showing twice)