20031214 OPENWEBMAIL DHTML POPUP CALENDAR PATCHES:

This set of patches adds a javascript popup calendar to the additem and edititem forms.
It also moves the validation javascript into its own file to cut down on code duplication.
You can try the popup calendar at the bottom of this notice.

   -The popup calendar makes it very easy to navigate through the months to find the day you
are looking for. If you want to choose "next Friday" for your event you do not need to
figure out the exact date of "next Friday" in your head - now you can just choose next
Friday from the popup calendar.

   -Easily navigate through months to find your target date without contacting the server.

   -popupCal colors are hooked to your style preferences, providing full integration
    into the OWM interface. The popup calendar also obeys the user weekorder preference and
    the right to left settings of some languages.

The popupCal was written in DHTML. Generally I really do NOT like DHTML because Javascript
and CSS are not standardized across all browsers. While this is changing, it is currently
a nightmare to make code that will run smoothly across all browsers. Add to the complexity
the fact that there are 3 different Document Object Models currently in the wild and you have
a very complicated task to make any application in DHTML that is cross-browser.

This popupCal works on more browsers than any popupCal on the internet that I could find.
It has been tested on many browsers on many platforms. Despite the best efforts, some browsers
have critical flaws that prevent the popupCal from working properly. The most common flaw is
lack of support for redrawing into a div layer. Despite the few cases where the popup does not
work as designed, it does not affect the OWM functionality as it exists currently. So in cases where
the popup does not work users can still proceed in the manner they have already become accustomed.
This is the same situation users already face with the HTMLArea code. For this reason, I feel
that this patch should be merged into the tree.

Three patches are required to implement this new feature. You can download each patch below:

1. openwebmail-cal.pl
2. etc/lang
3. etc/templates

The etc/templates patch is large (867687 bytes) because in each language directory
it does several things:

• remove the validate code from dayview.template
• add the popup div and stylesheet to dayview.template
• remove the validate code from editcalendar.template
• add the popup div and stylesheet to editcalendar.template
• add new file validate.js - Form validation javascript
• add new file nothing.js - The javascript nothing function
• add new file calpopup.js - The popupCal javascript

Finally, there is a new icon for the popup calendar.
The following tar file will extract the icon into each iconset folder.

cal-popup.gif - The calendar popup icon

It should be extracted at the data/images/iconsets dir.

These patches are against the -current file timestamped:
 openwebmail-current.tgz        12-Dec-2003 13:53   5.6M

This set of patches has been tested to work correctly on:

Mozilla/5.0 (Windows; U; Windows NT 5.1; en-US; rv:1.5) Gecko/20031007 Firebird/0.7
  Windows XP Professional Version 2002 Service Pack 1
Mozilla/5.0 (X11; U; FreeBSD i386; en-US; rv:1.5) Gecko/20031212 Firebird/0.7
  FreeBSD 4.8-RELEASE
Mozilla/5.0 (Windows; U; Win98; en-US; rv:0.9.2) Gecko/20010726 Netscape6/6.1
  Windows 98 Second Edition 4.10.2222A
Mozilla/5.0 (X11; U; Linux i686; en-US; rv:0.9.2.1) Gecko/20010901
  RedHat 7.2 Linux (2.4.7-10smp)
Mozilla/5.0 (X11; U; Linux i686; en-US; rv:0.9.9) Gecko/20020408
  Redhat 7.2 Linux (2.4.18-3)
Mozilla/5.0 (Windows; U; Win98; en-US; rv:1.0.0) Gecko/20020530
  Windows 98 Second Edition 4.10.2222A

Internet Explorer Version 5.0 (2022)
  Mac OS 9.2.2
Internet Explorer Version 5.2.2 (5010.1)
  Mac OS X 10.2.8 (6R73) Darwin Kernel Version 6.8
Internet Explorer Version 6.0.2600.0000.xpclient.010817-1148
  Windows XP Professional Version 2002
Internet Explorer Version: 6.0.2800.1106.xpsp1.020828-1920CO
  Windows XP Professional Version 2002 Service Pack 1
Internet Explorer Version: 6.0.2800.1106
  Windows 98 Second Edition 4.10.2222A

Opera Version 7.22 Build 3221 Platform Win32 System Windows 98
  Windows 98 Second Edition 4.10.2222A
Konquerer 3.1.1 (Using KDE 3.1.1a)
  FreeBSD 4.8-RELEASE
Safari 1.0.1 (v85.6)
  Mac OS X 10.2.8 (6R73) Darwin Kernel Version 6.8
Camino v0.7 Build 2003030613
  Mac OS X 10.2.8 (6R73) Darwin Kernel Version 6.8
Netscape Communicator 4.7
  Windows 98 Second Edition 4.10.2222A
  Unstable after several popup redraws, but stable most of the time


The popup calendar does NOT work correctly on the following browsers
(most of which are quite old):

Mozilla/5.0 (Windows; U; Windows NT 5.1; en-US; rv:1.5a) Gecko/20030728 Mozilla Firebird/0.6.1
  Windows XP Professional Version 2002 Service Pack 1
  Can't click in text fields after popup redraw. This bug fixed in Firebird 0.7.
Mozilla/5.0 (X11; U; FreeBSD i386; en-US; rv:1.5a) Gecko/20031005 Mozilla Firebird/0.6.1
  FreeBSD 4.8-RELEASE
  Can't click in text fields after popup redraw. This bug fixed in Firebird 0.7.
Konquerer 2.2.1 (Using KDE 2.2-11)
  RedHat 7.2 Linux (2.4.7-10smp)
  Browser crashes with SIGSEGV trying to redraw popup.
  Calendar drop-down menus do not update when date is changed.
Konquerer 3.0.0-12 (Using KDE 3.0.0-10)
  Redhat 7.2 Linux 2.4.18-3
  Can't change months in the popup.
Netscape Communicator 4.79
  RedHat 7.2 Linux (2.4.7-10smp)
  Browser crashes on popup redraw.
Netscape Communicator 4.79
  RedHat 7.2 Linux (2.4.18-3)
  Browser crashes on popup redraw.


FUTURE IDEAS:
-The popupCal is convenient. It would be nice to see it added to the navigation bar in openwebmail-cal.pl.
This would make it easier to move around the views.
-It might be a good idea to make the offset of the popup a user preference. Or it would be possible
to add a function that would allow the popup to be dragged around the screen.

You can try the popup in English here:

Add Calendar Entry   January February March April May June July August September October November December 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 1970 1971 1972 1973 1974 1975 1976 1977 1978 1979 1980 1981 1982 1983 1984 1985 1986 1987 1988 1989 1990 1991 1992 1993 1994 1995 1996 1997 1998 1999 2000 2001 2002 2003 2004 2005 2006 2007 2008 2009 2010 2011 2012 2013 2014 2015 2016 2017 2018 2019 2020 2021 2022 2023 2024 2025 2026 2027 2028 2029 2030 2031 2032 2033 2034 2035 2036 2037 Start time None 12 01 02 03 04 05 06 07 08 09 10 11 : 00 05 10 15 20 25 30 35 40 45 50 55 am pm End time None 12 01 02 03 04 05 06 07 08 09 10 11 : 00 05 10 15 20 25 30 35 40 45 50 55 am pm This day's date only The 2nd Sunday of the month Every Sunday this month This day and next days This month only Every even month this year Every month this year Every year Make this item a hyperlink to Send notification email to Event Color None 1a 1b 1c 1d 1e 1f 2a 2b 2c 2d 2e 2f 1a 1b 1c 1d 1e 1f 2a 2b 2c 2d 2e 2f --

Enjoy!