Location: PHPKode > projects > Simple PHP Agenda > install.txt
| 1. Basic installation               |
| 2. Installing automatic mailing    |
| 3. Updating a previous installation |

The installation manual
Updated for version 2.0 - Last change: 2007-03-04 ~ Thomas
Updated for version 2.1 - Last change: 2007-03-17 ~ Thomas
Added line for $enableReminders : 2007-08-20 ~ Thomas
Added new install procedure since 2.2.6 - 2009-04-20

1. Basic installation
To install the simple php-agenda you can follow these steps:

- You'll need a webserver or webhosting with php support and a MySQL database.
- (optional) Create a MySQL database for the agenda.
- (optional) Create a database user for the agenda.
- Copy the contents of the zip file to a directory on your webspace or webserver.
- Put the correct settings in config.inc.php
- Run the install.php script
- When there are no warning or errors, the agenda is created and correctly installed
- IMPORTANT: Delete install.php! The script does not check if there is already an agenda installed and you could accidently overwrite a previous install.
- IMPORTANT: Delete the 'update' directory. This directory contains script used to update from previous versions. These script alter the database, which may be unwanted in your installation.

2. Installing automatic mailing
The automatic reminders require you to install a script as a cron job.
The two scripts that should be included as cron jobs are:
- engine/sendreminders.php (this script should typically be invoked every few minutes)
- engine/senddailyreminder.php (this script should be invoked early in the morning, once a day)
- you also need to set the variable $enableReminder to true to allow users to set reminders on the appointments

Typically you can call a php-script from cron using one of the following methods:
a) wget http://yourhost.com/engine/sendreminders.php
b) curl http://yourhost.com/engine/sendreminders.php
c) lynx -dump http://yourhost.com/engine/sendreminders.php
d) /usr/local/bin/php /home/username/httpdocs/engine/sendreminders.php

For more info on how to set up cron jobs on your hosting, you should use google as this is platform dependend.

3. Updating an existing installation
To update an installation:
- Copy the contents of the zip file over your existing installation. Be carefull not to overwrite the configuration file.
- When it is a major update, go to the update folder in you installation. For example: http://localhost/agenda/update/
- Choose the appropriate update script and click it. These script immediatly run without any warnings or confirmations!
- Remove the 'update' directory and the install.php file. These files may have unwanted effect afterwards.
- Also execute the steps you need from point 2 in this manual
Return current item: Simple PHP Agenda