DT Register - Custom Fields

Field Management

The following steps assume that you have already:
• installed the DT Register component package
• logged into a Joomla administration page
You can create custom fields to add to your registration forms. These fields can be any standard form field type including:  
text input, textarea, radio buttons, checkboxes, date selection, dropdowns, textual (inserted text - not an input field) upload,
and email.

Managing Fields
To manage fields, complete the following steps:
1. In your Joomla administration environment, select Components > DT Register > Field Management. The Field
Management page appears, and a current list of fields is displayed.
2. For fields, you have the following options:
• To create a new field, click on the New icon in the toolbar.
• To edit an existing field, select the checkbox next to it, and click on the Edit icon in the toolbar. Or you may
click the link for the field in the list.
• To remove a field, select the checkbox next to it, and  click on the Delete icon in the toolbar.
• To change the publication status of a field, select or clear the checkbox in the Publish column for that field.
• To change the display order of fields, use the up and down arrow icons in the Reorder column, or change the
numbers in the Order column.

Common Details for Fields
After you have created a field, you can set the options for a specific field, as described above. Some details for each custom
field change based on the selection made in the Field Type drop-down list. The following information is commonly
displayed in the Details section of the Custom Fields page:
• Name - You must give a unique name for each custom field to be used in the database. This unique name must not
have spaces or special characters, only characters A-Z, a-z, 0-9, and underscore (_) are allowed.
• Email Tag - The email tag is the name used to express the value of the custom field in email messages sent from
the web site. For more information regarding email tags, see Email Tags.
• Field Type - Selecting a field type from the drop-down list determines what kinds of values can be used with the
custom field, and what options will appear in the rest of the Details section.
• Label - Enter the label for this field. This is what will show on the form for end users to see.
• Conditional Field - If you want the display of this custom field to be conditional, based on the use of another
custom field, then select that field from the dropdown. Only checkbox, radio button and dropdown fields will show
as an option. After selecting the field, all Values from the selected field will show. Then check the box for any
value that will enable the display of this field after the user selects the designated value.
• Description - Enter a description for this field. This will be used as a help / tooltip on the frontend for users to
know what to do with this custom field. If no description is given, no tooltip will show.
• Publish - Mark if you want to publish or unpublish this field.
• Apply Change Fee - Select if you want changes to this field in the frontend user panel to cause the Change Fee to
be added.
• Hidden - Select if this field is to be hidden or not. If YES, then it will not show on the frontend of the website for
users. It will only be seen and used by the administrator to record "Office Only" type of information.
• Listing Options - Selecting the checkbox for each item will display it in the corresponding list.

Input Fields
Input fields allow you to put information into a form. Input fields include Text, Textarea, Date, Textual, and Upload.
After you have created a field, you can set the options for a specific field, as described above. In addition to the common
details for fields listed above in Common Details for Fields, the following specific options are available on the page when
you edit a custom field:

Text
• Size - Enter the size (length) of this field.
• Maximum Length - Enter a limit of how many characters a user can type into this field. Leave it blank for no limit.
Textarea
• Rows - Enter the number of rows for this textarea box. This is the HEIGHT of the box.
• Columns - Enter the number of columns for this textarea box. This is the WIDTH of the box.
Date
• Date Format - Select how the date should be formatted
• Textual (Label does not display.)
• Text - Enter text to be displayed inside of your form for instructions, more details, etc. This field will accept
HTML.
• Display on Confirmation Page - This setting applies to Textual fields and allows you to choose whether or not the
Upload
textual field is displayed on the Confirmation Page as well as notification emails.
• Maximum File Size - Enter the maximum file size for this upload. Size is in KB. Enter only the number and do not
include any letters.
• Accepted File Types - Enter the accepted file types in a comma-separated list. Enter only the extension letters and
do not include periods.
• Attach Uploaded Files to Admin Notification Emails - Select Yes or No if you would like the uploaded file to be
included as an attachment to the admin notification email for new registrations.

Selection Fields
Selection fields allow you to make a selection on a form, from a number of options. Selection fields include Dropdown,
Checkbox, and Radio. Dropdown lists and Radio buttons allow mutually exclusive choices, where you can only choose one
item. Checkboxes allow you to select more than one item.

After you have created a field, you can set the options for a specific field, as described above. In addition to the common
details for fields listed above in Common Details for Fields, the following specific options are available on the page when
you edit a custom field:
• Size (only for Dropdown) - Enter the size (length) of this field.
• Values - Enter each option for a user to select or check. Separate each option with a | character and do not include  
spaces on either side of the separator.
• Selection Limits - Enter a limit for each of the field values given above. This will allow you limit how many times
each value is able to be selected by all registrants during the course of an event. Use a 0 if you want the value to be
unlimited. Separate each value with a | character and do not include spaces on either side of the separator. Once the
limit is reached for a value, it will no longer show as an option during registration.
• Selected Values - Select at least one of the above options to be selected by default (only one item for Dropdown).
Separate each option with a | character and do not include spaces on either side of the separator.
• Fee Field - Check this box if you want this custom field to have the ability to alter the registration cost.
• Fees - Enter the $ amount to change the registration cost when each field option is selected. This can be a positive
or negative number or 0 for no change. Separate each value with a | character.
• Fee Type - Select if the fee or discount applied in this custom field is a $ amount or a % percentage. Base
Percentage means it will be applied to the base price of the event. Total Percentage means it will be applied to the
total cost of the event including all other fees or discounts.

Conditional Fields
Conditional fields show based on the use of another custom field, Once you select that field from the dropdown list, only
checkbox, radio button and dropdown fields will show as an option.

After you have created a field, you can set the options for a specific field, as described above. In addition to the common
details for fields listed above, the following specific options are available when you edit a field:
• The Name, Address, Phone, and Email fields are available for you to fill out.
• The Website field must include “http://” before the website URL.
• The Image/Logo checkbox allows you to choose a custom image and whether or not it will appear on your website
for the field.
• Only information that you include will display on the website. If the email or website fields are empty, they will
not be displayed. You need to fill out the address for a field to be displayed properly.

Default Settings for Fields
• The Default Settings section of the Custom Fields page has options that determine when and if the custom fields
are displayed for an event. These options can also be overridden when a custom field is added to an event:
• All Events - Select the Yes radio button to automatically enable the field for all events. Select the No radio button
to require the field to be enabled for each event.
• Show - Users can register for an event as individuals or as a group. Choose one of the following options to
determine when the field will display:
• Select the None radio button to not show this field by default.
• Select the Individual radio button to display the custom field only when individual registration information is
being entered.
• Select the Group radio button to display the custom field only when group registration information is being
entered.
• Select the Both radio button to display the custom field both on individual registration and final billing pages.
• Required - Select the Yes radio button to require the user to enter data for the field. Select the No radio button to
field to make the use of the field optional.
• Group Registrations - When the field is used for a group, rather than an individual, choose one of the following
options to determine when it will display:
• Select the  Each Member radio button to display the custom field when each member enters their individual
information.
• Select the Billing Only to display the custom field only when final billing information is being entered.
• Select the Both radio button to display the custom field both on individual registration and final billing pages.
  • 2 Users Found This Useful
Was this answer helpful?

Related Articles

DT Register - Create / Edit an Event

Event ManagementThe following steps assume that you have already:• installed the DT Register...