aiContactSafe Add / Edit Field

Last Updated on Saturday, 31 March 2012 19:35

Written by Alex Dobrin

This is where you can add / edit a field. Use the top right toolbar to save, apply or cancel the information entered into the form.

Here are the instructions for each field:

Field name
Name of the field.

Field label
The label of the field. You can use HTML tags with this.

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.

Field label in message
Here you can specify a different field label to use in the message. You can use HTML tags with this.

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.

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

• "Number"
- a field in which only digits can be entered

• "Hidden Email"
- a field, not displayed in the form, used to add more destinations for the message

Send message
This is only used with the field types that contain an email ( "Email", "Email - List", "Joomla Contacts", "Joomla Users", "SOBI2 Entries" ). If activate ( checked ) the message is sent to the email address that the field type is connected to. It is ignored for the rest of the field types.

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 "SOBI2 Entries" field enter the field name from SOBI that records the email address. By default this is "field_email".
For a "Hidden" field enter the text that you want to add in all messages.
For a "Hidden email" field enter the email addresses separated by semicolumn ( ; ) to which you want to send the message.

Field limit
This will allow you to set a limit of chars a user can enter in a field. It is ignored for the field types that this limit is irrelevant. Setting this to 0 will disable the counting of characters in a editbox field.

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.

Auto fill
Here you can select to fill the value of the field with a value from Joomla ( like Joomla user name or email ) if the user is logged in. Select "- none -" to disable this feature.

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

• "Number"
- default number to enter in the field

• "Hidden Email"
- default email for this field

Field sufix
Here you can specify a suffix to add to the field.

Field prefix
Here you can specify a prefix to add to the field.

Field required
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
Activate ( checked ) this if you want use this field in the contact form.