Manage custom fields

[TOC] By default, on donation form, you can only collect basic information of donors: first name, last name, email, address...... If you want to add more fields to the form, you will have to create custom fields. Go to Joom Donation -> Custom Fields, you will be able to manage and create new custom fields. To process Ajax Upload, you should implement 2 steps:

1. Pre-populated custom fields

When you first install Joom Doantion, the following custom fields (which is called Core Fields) are populated by default :

  • First Name
  • Last Name
  • Organization
  • Address
  • Address2
  • City
  • State
  • Zip
  • Country
  • Phone
  • Fax
  • Email
  • Comment
    You can still make any changes to these core fields (change title, publish, unpublis, delete, change ordering...). For the two fields (First Name, Email), they are protected and could not be unpublished or deleted.

2. Supported Custom Field Types

The extension support following custom fields type:

  • Textbox
  • Textarea
  • Dropdown
  • MultiSelect
  • Checkbox list
  • Radio List
  • Date
  • Heading
  • Message
  • File upload
  • SQL

3. Create New custom fields

To create a new custom fields, on the custom fields managemenet screen, simply create new button in the toolbar. In the table below, you will see the information which you need to enter when creating custom fields and what's it's meaning:

PropertyDescription
Campaign Choose the campaign which you want this custom field will be displayed on donation form. Leave it to "Select Campaign" so that it will be displayed for all campaigns.
Name The name of custom field. Please only use alpha-numeric characters (a-z, A-Z, 0-9, _) for the name of the custom field.
Title Tile of the custom field.
Field Type Choose from one of supported custom field type supported above.
Description Description of the custom field. Enter the description if you want to have som explanation about the custom field.
Required Require users to enter data for this custom field or no. Set it to No if the field is optional.
Values Only needed for Dropdown, Checkboxes, Radio List, Multiple select custom field types. You can enter all values for all options of this custom field (each option in one line).
Default Values Default value of the custom field. If there is multiple default values (for Multiple Select and Checkbox List custom field), each default value need to be entered on one line.
Date type vailidation Usually use for textbox custom field. You can choose the validation rule you want to force subscribers to enter data in an expected format.
Rows Only use for Textarea custom field. It control the height of this custom field.
Cols Only use for Textarea custom field. It control the width of this custom field.
Size For textbox custom field, it controls the size of it. For checkboxes , radio list custom field, it controls how many options will be displayed per row.
Published Control this field will be showed or not.

4. Change ordering of custom fields

To change ordering of these custom fields, please go to Joom Donation-> Custom Fields, then click on the header of order column. After that, you will be able to change ordering of these custom fields.