#### Event Calendar Readme ##### #### By Nermware .. www.nermware.com #### #### Latest Version is 3.5 as of 08/09/08 #### The Event Calendar is webware that presents an interactive monthly event calendar. It requires 2 files: the cgi perl script 'eventcalendar.pl', and the text based calendar database 'caldb/eventcaldb'. Optionally and recommended, a language/theme file and a holiday file should be used. Nermware's event calendar has plenty of usable default features and, IMHO, is much easier to install and use then any of the others. -- See for yourself at http://cgi.resourceindex.com/Programs_and_Scripts/Perl/Calendars/ -- It requires perl 5.6.0 or above. The browser must have Javascript enabled. It has been tested with Mozilla, Netscape, Safari, Opera, and IE Browsers. I highly recommend Mozilla, Firefox and Netscape. Language and Theme: (I highly recommend) --------------------- The optional language/theme file changes the event calendar's presentation language to something other then American English. It also provides the ability to: .. Set basic functionality and paths .. Set subjects, categories, titles, etc. .. Set sizes and quantities .. Set default local time .. Set Europe week presentation .. Set colors and other event calendar 'themes' .. Set to enable or disable Moon phase presentation. .. Set to use the holiday database. Without having to change the eventcalendar.pl code with the use of a language files such as eventcallang.eng (English) one can update eventcalendar.pl file and keep the same theme, language, and modifications. ## Note: I'd like to see and share your theme.(anonymously if you like). I will gladly provide it free on the Download page (if exceptable). Installation Instructions: ------------------------- 1. From http://www.nermware.com -> download eventcalendar.gtar, and optionally (recommended) a language and the holiday database files. 2. Decompress eventcalendar.gtar. .. For Unix & Linux, use http://www.gzip.org/ gzip & tar, or gtar. For Windows 9x/NT/2000/ME/XP, use http://www.sfsu.edu/ftp/win/utils/ PowerArchiver 6.1, or http://www.7-zip.org, 7-zip. Both are freeware. Or www.winzip.com, commercial software Winzip. For Mac, use http://www.stuffit.com/mac/index.html, freeware StuffIt Expander or the Unix utilities mentioned above. ## Note: For all edits, save as regular text with no wrapping. ## 3. Verify path to perl at the top of eventcalendar.pl is correct. #! /usr/local/bin/perl -w .. note: the -w is optional. It will instruct perl to respond with error information. 4. (Optional) Either in the language file (preferred) or in eventcalendar.pl file, set the 'theme' by editing the colors, sizes, etc. variables. ## Important: The web server may require files & directories to be non group writable. Conceder this when setting the permissions. 5. Upload eventcalendar.pl, and the optional language file up to the web server's cgi-bin directory. The eventcalendar.pl file must be executable by the web server. Suggest chmod 0755. The optional language file should be readable by the web server. Suggest chmod 644. 6. Create the caldb and eventcalimages directories. Default for caldb is in the cgi-bin directory. The caldb directory must be writable by the web server. Suggest chmod 0777. Default for eventcalimages is in the 'home' directory, at the same level as cgi-bin. Suggest chmod 0777 for the eventcalimages directory also. 7. Upload to the web server, the button images 'homebutton.gif' and 'printbutton.gif' into the eventcalimages directory. 8. (Optional) Upload eventcaldb and/or holidaydb database files to the caldb directory. 9. Create a web page with a link to the evencalendar.pl script. Example: http:////eventcalendar.pl 10. Select the link to trigger eventcalendar.pl to run. If sanityscheck = 1, an empty eventcaldb and a holidaydb file will be created. When fully installed, the default directory tree should look like this: [Web server's event calendar home directory] ^ | +- cgi-bin -+ | | | +- caldb -+ | | | | | +- eventcaldb | | | | | +- holidaydb | | | +- eventcalendar.pl | +- eventcalimages -+ | | | +- homebutton.gif | | | +- printbutton.gif Options: -------- Nermware's 'The Event Calendar' has many for purchase options. Why for purchase? They're only $5.00 and help pay for the network and computer systems used to create Nermware. When ordered using PayPal, I receive an Email notice of the order. I then Email a reply with the options attached. Note that at this time, I'm doing this by hand. This means it may take a day or so for the reply. Advanced techniques and helpful hints can be found on the Calendar page at http://www.nermware.com Enjoy :-) The Nerm