Version: 0.3.20030228

For first time installation, please refer to the installation section.  For upgraders, please refer to the upgraders section.

------------
INTRODUCTION
------------
Calendarix is
- a powerful and easy to use calendar based on PHP and MySQL.
- developed under windows environment and tested with IE5.5 and Netscape 4.7 browser but should work on unix platforms too.

Its features include
- multiple calendar views in day, week, month and by categories.
- login for users to view calendar with login for administrators with special administration module.
- widely configurable in colors, font and functions.
- search through events for text.
- able to enter events with a repeat event feature.
- user auditing of event entries.
- quick navigation of calendar over days, weeks and months through drop-down quick selection boxes.
- approval of events can be enabled/disabled.

Language support is currently Arabic, Dutch, Danish, English, Finnish, French, German, Italian, Norwegian, Portuguese, Russian, Slovenian, Spanish, Swedish, Turk.  If you like this program and would not mind translating the contents, you can just add your translation files in the "cal_languages" folder. Do let me know of your translations.

To use the calendar
- just follow the installation instructions in the section below.
- if you are required to login to view the public calendar, username:'test', password:'testing'.
- for login into the administration, username:'admin', password:'admin'.

-------------
INSTALLATION
-------------
If you allow write permissions to your web directories, you can start with the installation script "install.php".  Otherwise, do as follows:

* unzip or untar the file
* Import the "create_cal.sql" in the "admin" folder into your mysqldatabase
  console : mysql -u username -p
	    create calendar; (if necessary change the name)
	    use calendar;
	    source create_cal.sql;
	    quit;
  phpMyAdmin : go to the database and import the text file.	    

Open "cal_db.inc.php.new" and check the database references. 
* Check that the database name, database login name, password and host are correct. Make the necessary changes and save the file as "cal_db.inc.php".

Open "cal_config.inc.php.new" and change the variables. 
* The most important variable to check is $calpath which should be a file path pointing to your calendarix files. 

Rename the files "cal_config.inc.php.new" and cal_configtext.inc.php.new" to "cal_config.inc.php" and "cal_configtext.inc.php" respectively, removing the ".new" extensions.

You can customise the login page for calendarix by editing the html files "callogin_top.html" and "callogin_bottom.html".

Be sure to allow access to the sub-directories under your calendarix path.

Do remove the files "install.php" and "upgrade.php" when you are done.

---------
UPGRADING
---------
If you allow write permissions to your web directories, you can start with the installation script "install.php".  Otherwise, please read "version.txt" first.  You should replace all files provided except the following:

cal_db.inc.php 
cal_config.inc.php
cal_configtext.inc.php
create_cal.sql

This is because the above files contain the settings used by your existing calendar.  You should not run "create_cal.sql" and your existing events should still be there.

To use the new features provided in the new version, please refer to the "version.txt" file for the new variables created since your existing version.  You should open the new "cal_config.inc.php.new" file and do a text copy and paste for those new variables into your existing "cal_config.inc.php" file.  This way, you can use the new features without changing your current settings.

If you have modified other files aside from the ones mentioned above, then I guess you should know PHP programming well enough and should know how to update the new files too. :)

--------
LICENSE
--------
This application is free for you to use and modify. However, it should not be sold as a commercial product nor be part of a commercial product without first getting my permission.   

THIS SOFTWARE IS PROVIDED ''AS IS'' AND ANY EXPRESSED OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE CALENDARIX DEVELOPMENT TEAM OR ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.


------------------------------
Any bugs or feature request ?
------------------------------
mail to webmaster@calendarix.com
http://www.calendarix.com

You can also check out the forum at http://www.calendarix.com/forum

If you need someone to host this calendar for you, you can contact me too.
I am still working on improving and adding more features into this application.  I will appreciate if you can support me developing this application by sending any contributions.


Copyright  2002,2003 Vincent Hor
