Installation

Unpack Files

Download the .zip file from this website and unpack the files to your PC, making sure to preserve the directory structure and filenames.

Upload all the files onto your web hosting space, again making sure you preserve the directory structure and filenames.

Setup your Database

Set up your MySql database on your web hosting space. You will also need to set up a database user and password.

If your hosting provider is using a shared instance on MySql, your database name may be prefixed with your accout name (eg: billy78_databasename).

Edit the Configuration File

With the files uploaded and your database set up, you are ready to edit the configuration file [configurationSettings.php] to suit your site.

These variables in the configuration file will need to be set:

-----------------------------------------------------------------------
$setusername (the madCMS Administrator User ID)
$pass (the madCMS Admin Password)
$cookiename (Session cookie name - change to suit yourself)
$expirytime (expiry time for the password - in seconds)
$msg (Error message displayed when password is incorrect)
-----------------------------------------------------------------------
$dbhost (MySQL host - usually 'localhost')
$dbuser (MySQL user name)
$dbpass (MySQL password)
$dbname (MySQL database name)
-----------------------------------------------------------------------
$emailRecipient1 (primary recipient of e-mail notifications)
$emailRecipient2 (Secondary recipient - if not reqd, set to ' ')
-----------------------------------------------------------------------
$modFiles ("yes" if Files Manager is to be enabled)
$modEvents ("yes" if News&Event Manager is to be enabled)
$modNews ("yes" if News Manager is to be enabled)
$modShop ("yes" if Shop Manager is to be enabled)
-----------------------------------------------------------------------
$quickImageWidth (size, in pixels, of "QuickImages automatically inserted in Pages)
$fullImageWidth (size, in pixels, of large images created by some modules, eg: SHOP)
$thumbImageWidth (size, in pixels, of square thumbnails for some Modules)
-----------------------------------------------------------------------
$siteurl (URL of live website where content appears)
----------------------------------------------------------------------- $shopCategories (delimited list of categories used in SHOP module)
-----------------------------------------------------------------------

All other variables in the configuration file should be left as the default values.

Run _install.php

In the "madcms" folder, there is a file called _install.php. Running this file will set up all the necessary tables in your database as well as populate some default values.

To run this file, open a webbrowser and type in the URL of the file (eg: http://www.yoursite.com/madcms/_insatall.php)

If the tables are set up sucessfully, a confirmation message will be displayed along with a link to the login page of madCMS Administration.

After sucessfull installation, don't foget to delete _install.php from your live site.

Ok, so now you have a default installation. You will probably want to modify the "look and feel" of your site, so check out the Developers' Notes.

Thoughts...

Anybody remotely interesting is mad, in some way or another. (Dr Who)