Lozinski's Calendar!

Installing the PHP Version


Every ".php" file has a delimiter line in it, which looks similar to the following:

#### NOTHING BELOW THIS LINE SHOULD NEED TO BE CONFIGURED ####

This line is present to help show you where the items are located in each file that may need to be configured for your system.

  1. In the file "calendar_config.php", edit the line which looks like:
    $CGI_DIR = "/cgi-bin/calendar/";
    to a partial URL which points to the location of the calendar php files on your system.

  2. If your system is configured such that your php files need to end with another extension such as ".cgi" instead of ".php", edit the line which looks like:
    $FILE_NAME_EXTENSION = ".php";
    to reflect the extension you need. NOTE that if you do change the value, you will need to rename ALL of the files ending in ".php" to have the same file extension as you provided!

  3. Set the appropriate file access permissions.
    1. On Unix, set the permissions of each php file to 755 (rwxr-xr-x). This can be done through the command "chmod 755 *.php".
    2. On Windows, make sure each php file has the appropriate read and execute permissions.
    3. The file "calendar_config.php" and the directory it is stored in will need to have appropriate write permissions so that php can write to it for updates when called through the web! This typically means the file calendar_config.php and the directory it is located in must have world-write permissions.
You should now be good to go (unless you are configuring the DEMO VERSION - see below)!

See the configuration section Create A New Calendar after the system has been configured, or walk through the tutorial to create your first calendar!



DEMO USERS:

Since the demo only supports one calendar, it has already been "created" and configured. However, you need to edit a few more items.

In the file "config_files/demo_configs.txt":
  1. The values for IMAGE_DIRECTORY and MONTH_DIRECTORY directory need to be edited to reflect the location of the images on your system. The values should be either a partial or full URL. That is, it should start with either "http://" or just "/". The string should have a trailing "/" character, and the value should be enclosed in quotes!

    Examples:
    • IMAGE_DIRECTORY="/calendar/images/"
      MONTH_DIRECTORY="/calendar/images/months1/"

    • IMAGE_DIRECTORY="http://www.yourdomain.com/wherever/gfx/"
      MONTH_DIRECTORY="/wherever/gfx/months/"

  2. Besides the default "administrator" and "webmaster" logins, the default user assigned to the calendar is "user1" with a password of "password". To add, edit, or delete users, you need to edit the value for CALENDAR_USERS. The format for this value is username::password with multiple entries separated by a comma. The entire string should be enclosed in quotes.

    Examples:
    • CALENDAR_USERS = "user1::password1,user2::password2,user3::password3"
    • CALENDAR_USERS = "joe::blow"

  3. Finally, you need to specify the FULL OPERATING SYSTEM PATH to the directory where the datafiles will be stored -- that is, the "data" directory that came with the demo. DO NOT SPECIFY A URL!!!

    The value you need to change is for CALENDAR_DATA.

    Examples:
    • Unix:
      CALENDAR_DATA = "/usr/local/httpd/cgi-bin/calendar_demo/data/"
    • Windows:
      CALENDAR_DATA = "D:/Inetpub/wwwroot/cgi-bin/calendar_demo/data/"

  4. Read through the file "calendar.php" to see the other configuration items you can set in the "demo_configs.txt" file.

Once you have set the configurations, you can access your calendar through a URL similar to the following:

http://www.yourdomain.com/cgi-bin/calendar_demo/calendar.php?dept=demo

The query string "?dept=demo" MUST be present to run!

Enjoy!
"This project isn't over-budget. It's under-funded!"
http://www.davelozinski.com