|
 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.
Download the last version of the component from http://www.algisinfo.net/download/category/1-joomla-1.5.x.html?lang=en and install it using the default install procedure of Joomla!.
Add a link to the component on the menu, selecting the “message” view.
Upgrading
You can upgrade the component following this steps:
- uninstall the old version, without deleting the tables from the database ( see “Configuration” for more informations )
- download the last version of the component from http://www.algisinfo.net/download/category/1-joomla-1.5.x.html?lang=en
- install the new version using the default install procedure of Joomla!.
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 :
- Textbox
- a short text
- Checkbox
- a field with two values : true or false
- Combobox
- a list of values you want to define
- Editbox
- a longer text
- Checkbox - List
- a list of possible values from which to choose
- Radio - List
- a list of possible values from which only one can be chosen
- Date
- request a date. A calendar is available for an easier utilization.
- Email
- request an email to which to send the message.
- Email - List
- enter a list of emails from which the sender can choose the destination of his message
See Field values for instructions on how to use this field
- Joomla Contacts
- the list of contacts added in Joomla from which the sender can choose the destination of his message
- Joomla Users
- the list of users added in Joomla from which the sender can choose the destination of his message
- SOBI2 Entries
- the list of entries in SOBI2 from which the sender can choose the destination of his message
- Hidden
- a field that will not be displayed on the contact form. You can use it to place a text in all messages.
See Field values for instructions on how to use this field
- Separator
- add a space between two fields of the form
- File
- attach a file to the message
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 e-mail address is being protected from spambots. You need JavaScript enabled to view it
;Sales department:
This e-mail address is being protected from spambots. You need JavaScript enabled to view it
;Alexandru Dobrin:
This e-mail 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:
- Textbox
- default text
- Checkbox
- 1 if you want this field checked by default, 0 or empty otherwise
- Combobox
- the position of the item you want to be selected by default starting from 0 ( 0 for the first one, 1 for the second, 2 for the third and so on )
- Editbox
- default text
- Checkbox - List
- a list with 1 ( for checked ) and 0 ( unchecked ) separated by ; for each item in the list ( 1;0;0;1 for first checked, second unchecked, third unchecked, fourth checked )
- Radio - List
- the item you want to be selected by default
- Date
- a date in the format yyyy-mm-dd ( year-month-day )
- Email
- the default email ( not recommended since it can be found by spammers )
- Email - List
- the position of the email you want to be selected by default starting from 0 ( 0 for the first one, 1 for the second, 2 for the third and so on )
- Joomla Contacts
- the id of the contact
- Joomla Users
- the id of the user
- SOBI2 Entries
- the id of the SOBI2 entry
- Hidden
- irelevant
- Separator
- irelevant
- File
- irelevant
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.
Last Updated ( Friday, 27 November 2009 07:01 )
|
Comments
Thank you and congratulations!
Cheers
Have only one suggestion: one field can be defined for using Joomla user, and one for contacts
Would be great, if users from these lists can be defined, because I do not want to offer all my users to the front end and selectable by anyone (this selection should be optional).
And a final: a documentation (or API) to select other captcha systems (like [url]http://moovum.com/[/url]) from jxtended.
thx
i really like the ease of use to install .
i give you 10 stars!!. its people like you who needs the recognition.