Installation Guide

Note

You should always use the correct version of the formmail script with the correct version of DA-FormMaker (same version number) to ensure the correct function. You can check the version number by opening the script in the browser:

System requirements

  • PHP as of version 5
  • MySQL for using the ip lock and captcha spam protection
  • GD library activated in PHP for the captcha spam protection.

Configuration and installation

The formmail script

The formmail script is contained in the file "formmail_vX.php". X is the major version number. The file "mail.htt" contains the template text, which is used for every form at the beginning of the email. You can edit these files with any text editor.

The contents of the file "trail.htt" is used at the end of each text mail.

The file "mail.htm" contains the template for emails sent in HTML format. You can edit the file with any HTML editor. You should not delete the placeholders (beginning with # like #PLACEHOLDER#) in that file. Otherwise the script will not work properly anymore.

Configuration of the script

The configuration of the script is done in the file "config.php". Edit the file with a text editor. The options are described in the file. Email options

In the "config.php" file, you can define two methods of sending the email. The standard mode is the direct sending with the PHP function "mail". You can also define your own SMTP server you are using in your email program.

If you use the PHP function the mails are send directly from the web server. This usually works without any problems. If you experience problems sending emails (for example you receive no email), you should select and configure the send method SMTP.

If you use SMTP, the mails will be send through the configured mail account. This could be the mail account from your webspace provider or some other freemailer, like Gmail. You usually get the credentials and server information how to configure the SMTP server from your provider.

Setting up the MySQL tables

Use of the SQL configuration script

The easiest way to install the MySQL tables is to use the installation file from the script. If you have uploaded all files to your webspace, open the file "sqlinstall.php" in your browser.

Enter the server information and credentials of your MySQL database into the form and click the button. If the tables could be installed correctly a message is shown. If an error occurs, please check the user credentials.

For safety reasons delete the "sqlinstall.php" file after setting up the tables.

Setting up the tables with phpMyAdmin

If you like you can create the files in phpMyAdmin. To do so, import the "tabelle.sql" file into the database.

Installation

After you have extracted all files and configured the script, copy all files to your webspace.

Older versions can be left on the webspace to ensure the correct function of forms using that older version.

For using the file upload, the directory "filetemp" is used to temporary save the uploaded files. These will be deleted after the email is send. For the correct function that directory might have the permission 777. Set these permissions in your FTP program.

Using the script in DA-FormMaker

To use the script in the software, set the correct path of the script in "Settings":