ELIS 2014 Manual

Admin Folder

Examples of Custom Field Types

To access the Custom fields go to the Program Management block > Admin > Custom fields. From there use the tabs at the top of the page to navigate to a section and create a new field. Custom fields are added to categories, if there isn't a category on the page one will need to be added.

Custom fields track tab

There are 6 custom field input control types:
  1. Checkbox
  2. Dropdown menu
  3. Text input
  4. Text area
  5. Password input
  6. Date/time
The control types are selected on the creating/editing screen for custom fields. The following image of this screen shows the section below the name and description area.

Custom field input control types

1. Checkbox

To demonstrate the checkbox input control type I will create a Custom Track Field. The first image shows the first section of the screen to create a custom field, the Common settings section.

The short text data type has been selected for this example. This data type enables a list to be added with a checkbox next to each value.

Checkbox custom field

The following image shows the second section of the custom field creation screen, the Manual editing section. The Input control type is selected here, checkbox is selected in this example. Since we are using the Short text data type, we can add a list of values that will be shown when adding a track.

Checkbox custom field

This image is showing the Add Track screen with the custom field we just added.

Checkbox custom field on creating track form

If we change the data type in this example to boolean, then the menu options will not be available on the Add Track screen, just a single checkbox will be available.

2. Dropdown menu

To demonstrate the dropdown menu input control type I will create another custom track field. The name of this custom field is Track Color. In the following image I am creating the custom field, I have scrolled down near the Manual editing section.
  1. The Short text data type has been selected.
  2. The dropdown menu input control type has been selected.
  3. 4 values or options have been added. I add the Choose... option for a default value, because with this setup the first option will be automatically assigned to new tracks unless edited.
  4. Not pictured is the source for menu options setting, selecting the '+ Show more' link will make this setting visible. The source of the menu options in this example is the manually entered list, which is the default setting. The available options here will change depending on the custom field being created, custom course fields will have an additional option to use completion elements as the source of menu options.
Dropdown menu custom field

The following image shows the add track screen with the new dropdown menu custom field.

Dropdown menu custom field

3. Text Input

The next example is the Text Input type. I'll be creating another custom track field for this example. The following screen is showing the Common settings section for this new field.
  1. Shortname of the new custom field
  2. Name
  3. The Data type will be 'long text'
Text input custom field

The next image shows the manual editing section. For the Input control type, Text input has been selected from the drop down menu.

Text input custom field

Save changes and the new option is displayed on the add/edit track screens. For this field, just add the text.

Example of a text input custom field

4. Text Area

This example will demonstrate the 'text area' Input control type. The following image is showing the setup screen for this custom field.
  1. 'Long text' has been selected for the Data type
  2. 'Text area' has been selected for the Input control type
Text area custom field

The following image shows the new custom field on the add/edit track screen. This Input control type enables an html editor.

Example of a text area custom field

5. Password Input

The following use case will demonstrate a Password Input type profile field:

An administrator wants to assign users to user sets by sending them a password that they will enter in a survey, which updates their profile and assigns them to a user set.

First, create a custom Moodle profile field. Go to Site Administration block > Users > Accounts > User profile fields. The are a couple reasons why we create a Moodle profile field first:
  1. User sets use Moodle profile fields to auto-assign users to user sets.
  2. The survey will use the Moodle profile field.
  3. Custom user fields in ELIS are created from Moodle profile fields. In this use case the custom user field in ELIS isn't necessary, but we will create it and synchronize it to copy values from Moodle anyways.
Adding the Moodle profile field:
Password profile field

Create the ELIS custom user field. Go to the Program Management block > Admin > Custom Fields > User tab. Select the Moodle field that will be used to create this field.

ELIS custom user field

Edit the settings for the new field.

ELIS custom user field settings

Save changes when finished.

Now we will create the user set. The user set is being auto-associated with the Moodle profile field 'Password Input' and the password '1234'. Other user sets could be created and assigned different passwords, e.g., 12345.

ELIS password user set

The new profile field needs to be added to the survey. We are adding the Moodle profile field to the survey.

Updating survey with password profile field

The administrator sends the users a password that they enter in the profile survey. In this example the password is 1234.

Student user completing the survey

When users enter their password in the profile survey it updates their profile, which auto-associates them with the user set. The user set could be auto-associated with programs/tracks - auto-enrolling users of the user set in programs, tracks, and classes.