WebCalendar System Administrator's Guide

WebCalendar Version: 1.0.0 - 1.0.5

Table of Contents


Introduction

WebCalender is an open source PHP-based multi-user calendar.

Features:

↑ top

System Requirements

Recommended:

You must have one of the following databases installed:

For the database you choose, you must have its drivers built into PHP. For example, to use MySQL, PHP must be compiled with MySQL support (which is the default setting when installing PHP). See the PHP pages (www.php.net new) for more information on setting up PHP.

No optional PHP packages (other than MySQL) are required for this application. However, PHP shoud be compiled with --enable-track-vars on some systems.

Make sure that magic_quotes_gpc in php.ini is turned on (otherwise, you will get an error message when you try to access WebCalendar.)

TIP If you are using Apache as your web server and if you cannot or do not want to enable magic_quotes_gpc for your entire site, you can enable it just for WebCalendar. Create a .htaccess file in the toplevel WebCalendar directory that contains a single line:

php_value magic_quotes_gpc 1

(For this to work with Apache, you must have the Apache AllowOverride All directive enabled for the directory where WebCalendar is installed. Additionally, PHP must be running as an Apache module, not a CGI.)

You can run PHP either as a CGI or an Apache module. You'll get better performance with PHP setup as a module. Not only will you not have to deal with the CGI performance hit, but you'll be able to use PHP's database connection pooling. Additionally, this application can use a form/cookie-based authentication or traditional HTTP authentication. For traditional HTTP authentication, PHP must be built as an Apache module.

If you are planning on using email reminders, you will need to build PHP as a CGI in order to run the send_reminders.php script. I would strongly recommend building a module-based PHP for your web server and then a second PHP build to create the CGI version.

TIP Some Linux distributions come with both a module-based PHP with Apache and a standalone PHP binary. Check for /usr/bin/php to see if you already have the PHP standalone executable. If it's there, you can use the following command to see what version of PHP you have:

/usr/bin/php -v
↑ top

File Unpacking

Unpack the calendar software in its own directory somewhere where your web server will find it. (See your web server docs for info.)

By default, WebCalendar should create its own directory when you unpack it. The new directory