Using PHPiCalender to view iCal calenders from any browser
=====================================================

This will work on a default installation of 10.2 and 10.2.1 (confirmed on 10.2.1). 

1) Download phpicalender from:
	http://telia.dl.sourceforge.net/sourceforge/phpicalendar/
   The newest version is 0.6 as of Oct, 2002.

2) Untar and change the name:
	tar -xzvf phpicalendar-0.6.tgz
	mv phpicalendar-0.6/ phpical

3) Change the phpicalendar configuration file, config.inc.php:
	cd phpicalendar
	vi config.inc.php

   The location of the calendar files needs to be identified.
   Assuming the location of the published calendars is in 
   /Library/WebServer/Documents/DAVdocs (as we set in dav_ical.txt), and 
   assuming also the "phpical" folder is in
   /Library/WebServer/Documents/:
	$calendar_path = "../DAVdocs";

   Or you can use the absolute path:
	$calendar_path = "/Library/WebServer/Documents/DAVdocs";

   Set the default calendar file (removing ".ics" from the file name):
	$default_cal = "MyWork";
   
   If your calendar file name has spaces, substitute them with "32":
	$default_cal = "My32Work";
   
   Change other default values as you like.

4) Make a backup copy of the Apache configuration file:
	sudo cp /etc/httpd/httpd.conf /etc/httpd/httpd.conf.org
	
5) Edit httpd.conf:
	sudo vi /etc/httpd/httpd.conf

   Find these two lines:
	#LoadModule php4_module libexec/httpd/libphp4.so
	#AddModule mod_php4.c

   Uncomment both (remove the "#"). 

   Search "AddType application/x-tar .tgz", and add these two lines 
   after this:
	AddType application/x-httpd-php .php
	AddType application/x-httpd-php-source .phps

   Search "DirectoryIndex", and add "index.php" like this:
	<IfModule mod_dir.c>
    		DirectoryIndex index.html index.php 
	</IfModule>
  
   So your computer will automatically recognize index.php, as well
   as index.html, as a default page to show.

   If you want to protect your calendars with Basic or Digest
   authentication scheme, add the following at the end of the file:

	#
	# Settings for PHPiCalender
	#
	#
	<Directory "/Library/WebServer/Documents/phpical/">
		AllowOverride None
		AuthName "PHPiCal Restricted"
		AuthType Digest
		AuthDigestFile /Library/WebServer/.davuser       
		AuthDigestDomain /phpical/

		<LimitExcept GET HEAD OPTIONS>
   			 Require user your_ID
		</LimitExcept>
   		Require valid-user

	</Directory>
We assume all of the phpicalender files (including index.php) are in the directory, 
"phpical", and 

See "dav_ical.txt" for more instruction for Basic and Digest authentication scheme.

6) Restart the webserver:
	sudo apachectl graceful

7) Now you can see your calendars on any browser from:
	http://[your ip or domain]/phpical/

   You can easily change to other calendars from one of the pull-down menus, 
   but you cannot view all of your calendars at once, as you can in iCal.



NOTE: 

When you try to subscribe calendars while using the Mozilla browser (as you can in PHPiCalendar, or
from Apple's event calendar sites), nothing happen when you click the subscription links.  You can resolve this problem if you have Internet Explorer (without using Internet Explorer as a browser).

Here's how to do it:

   1. Open Internet Explorer
   2. Open Preferences
   3. Go to Network -> Protocol Helpers and click "Add"
   4. Call the new helper "webcal" (use lowercase text only!!)
   5. Click on the Helper App button and select your iCal application
   6. Check the box to "use current application if possible.
   7. Shut down Internet Explorer and restart Mozilla. 

Now the subscription links should work fine even in Mozilla.