Lozinski's Calendar!

Unpacking the Perl Version

  1. Copy the archive to the cgi-bin directory (or whatever directory you have allocated that perl scripts can run in) on your web server.

  2. To unpack:

    Full VersionFree Downloadable Version
    • the Unix archive:
      1. Gunzip the file. Do this by typing
        "gunzip calendar110_perl.tar.gz".
      2. Untar the tar file. This can be done by typing
        "tar -xvf calendar110_perl.tar".
      3. Verify that everything is extracted.

    • the Windows archive:
      1. Double-click on the archive or run "WinZip".
      2. From "WinZip" locate the "calendar110_perl.zip" archive on your system and choose the "Extract" option.
      3. Extract the archive to the desired location.
      4. Verify that everything is extracted.
    • the Unix archive:
      1. Gunzip the file. Do this by typing
        "gunzip calendar_demo110_perl.tar.gz".
      2. Untar the tar file. This can be done by typing
        "tar -xvf calendar_demo110_perl.tar".

    • the Windows archive:
      1. Double-click on the archive or run "WinZip".
      2. From "WinZip" locate the "calendar_demo110_perl.zip" archive on your system and choose the "Extract" option.
      3. Extract the archive to the desired location.
      4. Verify that everything is extracted.


When everything is extracted, you should have the following files (those files and directories marked with an asterisk * below are NOT included in the free demo!):

  1. The follow perl files:

    calendar.pl=>Main program.
    calendar_addeditdelete.pl=> Used to add, edit, move, and delete events to/from the calendar.
    calendar_common_routines.pl=>Contains functions shared by at least two of the .pl files.
    * calendar_config_common.pl=> Common routines I wrote that I share with config forms in some of my other programs.
    * calendar_config_form.pl=> Displays the HTML form to "Administrators" and "Webmasters" to configure their calendar through an HTML interface.
    calendar_day.pl=>Used to display a day's events.
    * calendar_stats.pl=>Computes and displays the statistical information for each calendar.
    * calendar_update_config.pl=> Takes the information from the config form and updates the main calendar_config.pm file and/or the configuration files for any of the specified calendars.
    calendar_config.pl=> Contains the configuration information which is set by the "Administrators" and applies to every calendar.
    calendar_util.pl=>Contains misc date functions specific to the calendar's operations.
    lozcgi.pl=>Contains the common CGI functions such as getting the form information and altering cookies. This module is freely available from my website: http://www.davelozinski.com


  2. You should see a "data" directory. I included this directory as a place to store the datafiles generated.

    DEMO USERS: You will find a file entitled "demo_counter.txt" within this directory. You need to make sure this file and directory have world write permissions!


  3. You should have a "config_files" directory with the following contents:

    * calendar_master_text.txt=>Is the "Master Copy" text-language module. All calendars that are created have their text initially taken from this module.
    calendar_config.pl=> Contains the "global" config items needed by every calendar.

    DEMO USERS: in place of the file "calendar_master_text.txt", you will have the following two files:

    demo_configs.txt=> Contains all the configurable settings for the demo calendar.
    demo_calendar_text.txt=> Is the text file that the demo calendar reads from.



  4. You should see a "templates"* directory with the following contents:

    * header_template.html=>The "header template" file contents
    * footer_template.html=>The "footer template" file contents


  5. The documentation is no longer included with the code (the archives were becoming too big to email). Download the documentation in the desired format by going to http://www.davelozinski.com/scripts/calendar/.


  6. The images are no longer included with the code (the archives were becoming too big to email). Download the image archive you desire by going to http://www.davelozinski.com/scripts/calendar/ and selecting either the WinZip or GZip archive.

* - Note that those files/directories marked with an asterisk * are NOT included in the free demo!
"If there is such a thing as too much power, I have yet to discover it."
http://www.davelozinski.com