Short description
aiContactSafe is a native Joomla! 1.5.x component developed by Algis Info.
You can use it to place a complex contact form on your web page.
Here are some of the facilities that it can offer:
- custom fields
- captcha
- custom text related to the contact informations
- multilingual support ( through Joomfish )
- SEFthrough Artio JoomSEF or sh404SEF
If you use aiContactSafe, please post a rating and a review at the Joomla! Extensions Directory.
Installation
It's working only on Joomla! 1.5.x ( 1.5.9 or newer is recommended ) in native mode and Joomla! 2.5.x.
Download the last version of the component from http://www.algisinfo.com/en/download/category/1-free-extensions.html and install it using the default install procedure of Joomla!.
Then you can add a link to it like this : in the administrator page, top menu, "Menus", "Main menu", click "New" from the top right toolbar, click "aiContactSafe", click "Contact Form", enter a title and click "Save".
Upgrading
The upgrade is done by installing the new version of the extension over the old one.
The removal of the old version is no longer required and no information in the tables of aiContactSafe will be lost.
A full back-up of the site is always recommended before the upgrade is done.
Configuration
Here are the instructions for each of the fields in Control Panel :
Use aiContactSafe css in backend
Activate ( checked ) or deactivate the default CSS settings of aiContactSafe in backend.
Activate help
Check this if you want to display help instructions in backend.
Date format
Enter the date format that will be used by this component to display date fields. See this http://www.php.net/manual/en/function.strftime.php for more information.
Activate spam control
Activate ( checked ) or deactivate the spam control. This will activate the checking of the messages for specified words and in cases where they are found the message is not sent.
Block messages with
Specify the words to check for in order to mark a message as spam. Separate the words with ";".
Record blocked messages
If you activate ( checked ) this the messages marked as spam are not sent, but recorded into the database.
Activate IP ban
Activate ( checked ) or deactivate the IP ban. If you activate this the visitors from the specified IPs will not be able to access the contact form.
IPs to ban
Specify the IPs to ban. Separate the words with ";". You can use "*" to specify an entire class. For example 123.123.*.* will ban all IPs starting with 123.123.
Redirect banned IPs to
Specify the page where to redirect the blocked IPs. The home page is used by default.
Upload attachments folder
Specify the folder where to upload the files attached to the message.
Maximum attachments size (in bytes)
Specify the maximum size of a file attachment in bytes.(1024 Bytes = 1KByte; 1048576 Bytes = 1 MByte; 5242880 Bytes = 5 MByte).
The size must be equal to or smaller than the value in the parameter "upload_max_filesize" in your PHP.INI file.
For more information see this page : http://www.php.net/manual/en/ini.core.php#ini.upload-max-filesize.
Allowed attachments types
File types that can be attached. Use a comma (,) to separate them.
Attach to email
The attachment can either be sent only as a link to the file on the server in the message or it can be attached to the message.
Activate ( checked ) this field to attach the files to the message.
Activate Artio
In case you use Artio for SEO, you can activate/deactivate the Artio plugin of aiContactSafe.
Activate Joom!Fish
In case you use Joom!Fish for multilingual support, you can activate/deactivate the contentelements of aiContactSafe.
Delete database tables
This button will delete all the tables generated by this component into the database. It is here to allow you to completely uninstall the component.
Warning !!!
This will delete all the tables of aiContactSafe and you can't recover them after that.
Managing custom fields
You can define an unlimited number of custom fields to place into the contact form.
In the administrator page of the component, access the section “Fields” to see the list of current fields.
Use the right top tool bar to add / modify / delete / publish / unpublish fields.
All this buttons ( except Add new ) can be used only after at least one field is selected from the field list.
You can select one or more fields by clicking on the check box on the left side of it's name. Click the top check box to select all the fields on this page.
Here are the instructions for each field in the form :
Name
Name of the field.
Warning !!!
This can't be modified for the field's "name", "email", "subject" and "send_to_sender".
Field label
The label of the field.
You can use HTML tags with this, but don't use quotes (") in it.
Label parameters
Here you can set the parameters of the HTML tag that will be generated for the label of the field.
For example you can set the way the field is displayed using CSS properties.
See Field parameters for more information.
Warning !!!
Use only apostrophes (') in this field. Don't use quotes (") or the settings will not work.
Field label in message
Here you can specify a different field label to use in the message.
You can use HTML tags with this, but don't use quotes (") in it.
Label in message parameters
Here you can set the parameters of the HTML tag that will be generated for the label of the field in the message.
For example you can set the way the field is displayed using CSS properties.
See Field parameters for more information.
Warning !!!
Use only apostrophes (') in this field. Don't use quotes (") or the settings will not work.
Label after field
Activate ( checked ) this if you want to place the label on the right side of the field.
Field type
Select the type of the field. You can choose one of these options :
Field values
In case you want to add a Combobox field, a Checkbox - List field, a Radio - List field, a Email - List field or a Hidden field, here is where you can add the values to place in the list.
For a Combobox field enter all the values separated by ";". For example for colors : red;yellow;green;blue;black.
For a Checkbox - List field enter all the values separated by ";". For example for colors : red;yellow;green;blue;black.
For a Radio - List field enter all the values separated by ";". For example for colors : red;yellow;green;blue;black.
For a Email - List field enter a list with names and email address separated by ";". Use ":" between the name and the email address. For example... Service department:This email address is being protected from spambots. You need JavaScript enabled to view it.;Sales department:This email address is being protected from spambots. You need JavaScript enabled to view it.;Alexandru Dobrin:This email address is being protected from spambots. You need JavaScript enabled to view it..
For a Hidden field enter the text that you want to add in all messages.
Field parameters
Here you can set the parameters of the HTML tag that will be generated for this field.
For example you can set the way the field is displayed using CSS properties.
I think one of the most used parameters is the width of the field. In order to modify it you can enter this text into the field : style='width:250px;'. This will set the width to 250px.
Enter all the CSS values you want to use in just one style parameter separated by ";". For example... style='width:250px;color:red;'.
You can find here : http://www.w3schools.com/css/default.asp more information on CSS.
Warning !!!
Use only apostrophes (') in this field. Don't use quotes (") or the settings will not work.
Default value
Here you can define a default value for the field.
You can use this default values for each field type:
Order
The fields will be sorted in the contact form using this field.
Field required
Warning !!!
This can't be modified for the fields "name", "email" and "subject".
Activate ( checked ) this if you want the sender to be forced to complete this field.
Add in message
Activate ( checked ) or deactivate the sending of this field in the message.
Published
Warning !!!
This can't be modified for the fields "name", "email" and "subject".
Activate ( checked ) this if you want use this field in the contact form.