Introduction
If you've ever had to fill in forms, it's likely you've come across a section labelled 'Office Use Only'. This section provides a space where the people who process the form can append their own data to form.
The ContestPad platform provides a similar feature called Admin Forms. Unlike Entry forms, the entrant is not responsible for the entry of this data. The data defined in the Admin Form will be provided by either the contest administrators or moderators.
By default, there is one fields that is automatically included with the Admin form, that being Moderator Comments.
Moderator Comments is a text field that can be completed as part of the moderation Process. Should the moderator choose to reject an entry, the moderator can provide the reasons why and what may be done for a successful submission. These Moderator Comments will be returned to the entrant as part of the entry rejection notification.
Adding Custom Fields to the Admin Form
The Admin Form is not restricted to the just to Moderator Comments - just like the Entry form, adding, deleting and editing fields is completely configurable.
Step 1 - Select the Admin form
The management of Admin forms is located in Settings section - as shown in the screenshot below. Press the Manage button to edit the Admin Form.
Step 2 - Adding Fields
You can add a field to the form by pressing the Add Field button, shown in the top right of the screenshot:
When pressed, you'll be taken to the Admin Entry Form Field screen which allows you to define a field to the added to the form. You'll also be able to specify:
Whether a value is mandatory
If the field is active
Where the field should be made visible - such as the Entry Page, Moderation Page or Judging Page
What type of field an be added. The following field types are supported:
Text
Dropdown
Email
TextArea
Checkbox
Radio
Timezone
Location
Date Picker
Time Picker
Phone No.
Number
Description Text
Any type specific attributes, such as Placeholder value, options, text length, etc
Once you've completed the definition, press the Save button to add the field to the form.
Step 3 - Further Configuration of the Admin form
All the fields associated with the Admin form will be displayed in the Admin Form list, shown below:
Custom form fields can be deleted from the form, by pressing the associated Delete button located on the row of the field, show here:
Custom form fields can be duplicated on the form, by pressing the associated Copy button:
Finally, the fields are displayed in the order they appear in this list. To set the order, simply drag and drop the field into the desired order position:
Including custom fields in the Moderation Queue
Making Fields available to the Moderation screen
To make a custom field available to the moderator, the following configuration settings are needed:
Step 1 - Edit the Field
The management of Admin forms is located in Settings section - as shown in the screenshot below. Press the Manage button to edit the Admin Form.
Press the Manage button for the field you wish to add to moderation:
Ensure the following configuration is correct:
Active switch is set to On
Moderation Page switch is also switched On
Press Save to ensure any changes are set.
Step 2 - Make sure Moderation is enabled
The under Settings tab - select General from the sub-menu. Ensure the setting Entry Moderation is set to On.
Press Save to ensure any changes are set.
Step 3 - Making the field visible in the Entry and Moderation tables
Under the Entries tab, select Entries or Moderation from the sub-menu. You'll see a table of entries, with the various columns of meta-data. If the custom field is not a visible column, press the Columns button, a list of fields will appear.
Scroll down the list make sure the field's checkbox is checked. The screenshot above shows that a column displaying Classification field for each entry will now be visible.
Assigning the Admin Data to an entry in Moderation
Firstly, we need to see the moderation queue - which is available under the Entries tab, by selecting Moderation from the sub-menu. The Moderation queue is shown below:
The Admin form for an entry can be accessed by pressing the button (on the appropriate row). The button shown below:
When the Admin form is displayed, the moderate can enter the data and save it by pressing the Submit button. The Admin form is shown below, with an example Classification field added to the form:
Assigning the Admin Data to an entry from the Entries tab
Admin Form data can also be accessed via the Entry management screen. To access this data:
Enter the Entries tab, and select Entries from the sub-menu:
Find the entry to edit, and press the Manage button on the appropriate row.
Select the Admin Data tab. The Admin form will be displayed.
Edit fields as required. Note: If an Admin Form field is not visible, its likely the scope switch is not set to On. See:
To save your changes, press the Save button.