How To Use Admin Forms

Admin Only Data for Entries

Templar Hankinson avatar
Written by Templar Hankinson
Updated over a week ago

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:

  1. Enter the Entries tab, and select Entries from the sub-menu:

  2. Find the entry to edit, and press the Manage button on the appropriate row.

  3. Select the Admin Data tab. The Admin form will be displayed.


  4. Edit fields as required. Note: If an Admin Form field is not visible, its likely the scope switch is not set to On. See:

  5. To save your changes, press the Save button.

Did this answer your question?