Web Site: http://software.xornic.com Copyright (c) 2004 software.xornic.com. All Rights Reserved. ########################################################################## "CONTACT US" README ########################################################################## TABLE OF CONTENTS 1. Licensing 2. Description 3. Requirements 4. Setup Instructions 5. Contact and Support Information ########################################################################## 1. LICENSING ########################################################################## "Contact Us" is free software. You can redistribute and modify it freely without any consent of the software.xornic.com (software.xornic.com), if and only if the following conditions are met: (a) The copyright info in the footers remain intact. (b) The purpose of distribution or modification is non commercial. Commercial distribution of this product without a written permission from software.xornic.com is strictly prohibited, and may cause legal actions. This script is provided without any warranty. The author does not take any responsibility for any damage this script may cause. 2. DESCRIPTION ########################################################################## "Contact Us" is a web based contacting PHP script, that is highly effective, simple and customizable. Visitors of your site may contact you via email without revealing your email address. SPAM spiders that scan pages for email addresses will not locate your email address. Main Features: * Fast and simple * Highly configurable look (both contact form and email sent) * Up to 10 addressee * Display sender's IP addressee and user agent * Hide addressee email address - NO MORE SPAM * Supports all languages 3. REQUIREMENTS ########################################################################## * PHP support. * Mail() module supported. (This module and rarely not supported) * GD Library supported. (optional for the ANTI sp@m image verification feature) 4. SETUP INSTRUCTIONS ########################################################################## 1. unzip file "contactus.zip". 2. After unzipping contactus.zip, you should have the following files: readme.txt - this file. the "Manual" config.php - all the configurations are stored here contact.php - gets the user's details and sends the email contact-form - this is the contact form to which your send your surfers to in order for them to fill and contact you contact.css - this is the defalut .css file, you can replace this with your own module.php - module intro.html - the content of this file is used for the top portion of the contact form signature.html - the content of this file is used for the bottom portion of the contact form setup.php - installation file image.php image_encoder.php 3. Upload files and Set permissions Upload the above files to your server. It is recommended to locate all the files in a separated folder from the rest of your web site's files. Create a new folder, for example: /contactus Upload all the files to that directory with the corresponding permissions: (The most important file permission you have to set is of the "congif.php", The script will not work if you do not do so!) file permission ----------------------------------- config.php 777 contact.php 755 contact-form 755 module 666 image.php 666 image_encoder.php 666 intro.html 644 signature.html 644 setup.php 755 4. Run setup.php The default username and password are: Username: admin Password: admin Be sure to change this when you access the administrator interface. 4.1 "CONTACTS" These are the only details that are required for you to start using this script, all the rest may be left as is. The "contact_title" is what will appear in the contact form as the receiver of the email, for example: "Support". The "contact_value" is the actual email address the email will be sent to. for example: "support@foo.com" Examples: contact1_title = "Support", contact1_value = "support@foo.com", contact2_title = "Sales", contact2_value = "sales@foo.com", contact3_title = "Design", contact3_value = "myemail@hotmail.com". 4.2 "DETAILS TAKEN" What detail do you wish to take from the visitor contacting you. These includes: Name Address Telephone Fax If you choose for instance to take the visitors name, choose "Yes", and it will appear it contact form. You may also specify which fields are required. You may choose to take the address of the visitor and choose for it not to required, then the address field will appear in the form but will not prompt the visitor to insert a value there if it is not required. 4.3 "EMAIL DISPLAY OPTIONS" Here you can customize the font style, color and size that will appear in the email you receive. Show sender's IP address - This will print out the visitor's IP address when filling the contact form. Show sender's USER_AGENT - This will print out the visitor's browser type and version, operating system etc. 4.4 "FORM DISPLAY OPTIONS" Here you can customize the font style, color and size that will appear in the contact form. 4.5 "TEXT CONFIGURATION" Here you can configure the input and messages to your desire. This section is used to translate the script into any language you want. 4.6 "ADMINISTRATOR LOGIN" Modify your access details. as mentioned before, please choose a username and password of your own here. do NOT leave it "admin" and "admin". 5. Edit intro and signature 5.1 Edit intro.html What ever you put here will be the part of the contact form that will be used as an intro of the contact form page. Example: "If you wish to contact us please fill in the following form:" 5.2 Edit signature.html What ever you put here will be the part of the contact form that will be used as a signature of the contact form page. Example: "We will reply in no less than 24 hours. Thank you for contacting us." 6. Set up a link to the contact form From anywhere you desire in the pages of your site, add a link to the "contact-form.php" - this is the page on which the contact form is located and which your site visitors need to fill in order to contact you. assuming your uploaded the files to a folder named "contactus", here is a sample link: