Fields

This is where you can manage the custom fields. Use the top right toolbar to add/modify/delete/publish/unpublish fields. All these buttons ( except "Add new" ) can be used only after at least one field is selected from the field list.

Here are the instructions for each button :

• Add new
Add a new field.
• Edit
Modify the parameters for an existing profile.
• Delete
Delete one or more fields.
• Publish
Set a field usable in front end.
• Unpublish
Set a field unusable in front end.

You can select one or more records by clicking on the checkbox on the first column of the table. Click the top checkbox to select all the records on this page.

On top of the table you have some tools that will help you filter the fields. Enter a partial/entire name of the field and click "Go" to filter the fields. Click "Reset" to remove the filter.

Click on the name of each column of the table to order the records by that column. Click a second time to order the records in revers order. Click "Reset" to cancel the ordering.

Add/Edit Fields

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:sales@website.com;Alexandru Dobrin:alex@website.com.
  • 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 these 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"
    - irrelevant
  • "Separator"
    - irrelevant
  • "File"
    - irrelevant
  • "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.

Delete Field

This is where you must confirm the deletion of one or more fields. You will have to select all the fields you want to delete, by clicking the checkbox on the left side of the field name.

Click "Cancel" to cancel the deletion of the fields.

Warning !!!
After you confirm the deletion, you will not be able to recover the deleted field(s).