Installation

The twzContact download is a .zip file containing a number of files. The quickest way to get started is:

  1. unzip the twzContact .zip file
  2. put your email address into twzContact.ini (see below)
  3. upload all the files to your web server
  4. point your browser to form.php

Here's an overview of what's in the download:

FileNotes
twzContact.ini This is the settings file, which defines what fields will be on your contact form, and various other things. Start by opening this file in a text editor (eg Notepad) and changing the ToAddress to your own email address.
form.php This is a sample web page with a contact form to get you started. Open this file in a text editor to learn what's required for your contact page.
twzContact.php This is the script that does most of the work.
twzContact.css This is a sample stylesheet, which you can incorporate into your main stylesheet and edit to suit the rest of your site. You can get more CSS ideas from the example forms.
captcha.php
monofont.ttf
These files are required if you want a 'captcha' field on your form.
calendar/ (folder) This folder and its files are required if you want a 'calendar' field on your form, allowing your visitor to easily select a date from a popup calendar.
twzContact_options.php 
twzContactLog.php
These are support files that you might find useful. Open them in a text editor to find out more.

There are endless possibilities for creating a form with twzContact. The real power is in twzContact.ini (which controls what's on the form) and twzContact.css (which controls what it looks like).

Installing in a CMS (Content Management System)

twzContact can work just fine with many CMSs (although admittedly we haven't done a lot of testing). We didn't have any problem with these:

CMS Made Simple (CMSMS)

MODx Evolution

"Settings file not found" error? A reminder about paths

We recommend that the settings file is not stored in the web-accessible public_html folder, but rather at a higher level so nobody can browse to it from the web. For this reason the include text in this documentation refers to

define('INI_FILE','../twzContact.ini');

where the ../ part means the directory above. If you want to have your settings file in the same folder as the other files, you should rename it and change the 2 dots to 1 dot, eg

define('INI_FILE','./twzContactRenamed23764.ini');

Renaming the file makes it very unlikely that anyone will be able to view it, and discover your email address within.