Profile Field Editor — Edit Field popup
This popup allows you to define a particular field to be displayed, and is accessed by clicking on a field in the Field Editor.
The first section includes the field's Label. The label must be provided, and unique among all field labels. This allows you (and this platform) to identify the field. You may choose not to display the label with the user data. If you've selected an icon, the icon will be displayed only if the label is displayed and the field is at the top level (i.e., icons are not displayed in subgroups.)
The following image shows an icon displayed with the first label ("Boards, Committees,...") and a second-level label ("Boards") which does not, cannot, include a label.
Labels (and icons) are not displayed for fields which do not have Break After selected. That is, if the field is inlined, it will display the input prompt, but not the label or icon, regardless of the Display label selection. One way to acheive a similar effect is to create a non-repeating group, attach a label to the group, and then add inlined (i.e., non-break-after) fields within. For example, create group, call it "Your Name", and then add two simple inlined fields "First" and "Last" within the group.
The second section allows you to provide a Prompt for the user while editing the field. This prompt is visible only while editing, and is displayed immediately under the field being edited. The following image shows prompts for multiple fields.
The final section allows to you select the Field Type. Once you make a selection, other options may be displayed or hidden, as appropriate for the selected field type.
- Text (Plain)
- Simple unformatted data entry. The user will be able to enter a large amount of text, but any line-breaks will be ignored, and the result will appear as a single line or paragraph. You can automatically alter the user-provided data by selecting one or more of the Bold, Italic, Underline checkboxes. This field type is appropriate for simple fields.
- Text (Formatted)
- Multi-line data entry. This field type provides a rich-text editor allowing the user to add basic formatting, line-breaks, and lists. This field type is appropriate where you want the user provide more detail than what might be provided via the Plain text field type.
- Simple unformatted data entry, like "Text (Plain)", but also provides the ability to specify link's URL and its Text.
- List (Single-selection)
- You will specify a list of items† from which the user may choose only a single value. The selected item will be displayed on a single line with a bullet (●) prefix, if this field has Break After selected. Otherwise, it will be displayed as only the selected text item, inline with other fields.
- List (Multi-selection)
- You will specify a list of items† from which the user may choose any number of values. The selected item(s) will be displayed on separate lines with a bullet (●) prefix, if this field has Break After selected. Otherwise, it will be displayed as a comma-separated list, inline with other fields.
A Group field allows you to aggregate a set of subfield. The group's subfield(s) are then displayed using a single label
and icon, or this group of fields makes up a set of fields. A good example of this might be a single group called
"Contact Info", where you have multiple plain text fields under it called "Phone", "Address", etc.
The following image shows what this might look like, where we choose to (also) display the subfield labels "Phone" and "Address".
Caution: If you change an existing repeating field into a non-repeating field, you will cause all data values for iterations other than the first iteration to be lost. For example, if you change a "Group (repeating)" list of publications into a non-repeating "Group", you will cause the deletion of all publications except the first for each user. This cannot be undone, once you've selected "Update" in the popup.
- Group (repeating)
A repeating Group field is a special type of Group field. The set of subfields are, as a set, repeated
any number of times. During data entry, the user is prompted to "Add" a new set.
The following repeating group field "Committees" has two field sets (i.e., two "rows"), each of which include two subfields, "Committee Name" and "Meeting Location". The user clicks to add another set of edit fields. Additionally, the field sets can be reordered using the arrows on the left of each field set, or deleted using the red on the right of each field set.
There is an automatic break after each repetition. You may separately choose to have a line break after each subfield within the group.
- Bullet Group (repeating)
- This field type is identical to Group (repeating) except that on display, each repeating set has a bullet (●) prefix. This type is ideal where you simply want a nicely displayed list of items.
Prefix and Suffix Text
Some fields allow you to specify text before or after the field's value. This text is shown only if the field has value and is useful for adding punctuation between inline fields (that is, fields which do not have Break After set.) See Advanced Formatting below for an example.
For some field types, you have the choice to have a "break" or new-line placed before and after the field. Often this is the desired option. However, if you have a few fields together in the same group (e.g., First Name & Last Name), it may make sense to have some (or all) of them to appear on the same line. For example, note the use of Break After in the image below. On the left, break is enabled for the publication title; on the right, break is not enabled.
If checked, this field's data will be indexed and available for search. The prompt on the search page will use this field's label, so if you have multiple similar fields, it will be useful to label them differently. For example, use "Job Title", "Publication Title", instead of "Title".
The following two images show how one might display a list of publications, where each publication consists of a title, month, and year. The first image shows the finished display, the second image shows what the Field Editor displays.
The "Publications" field is configured as a Bullet Group (repeating). As you can see, each publication is displayed with a leading bullet. Title and icon are configured for this first field, but not configured for the subfields. You can see this because only the first field in the editor displays an icon and the label itself is displayed in Black unlike the other fields which displayed in Gray.
The first subfield, "Title", is a simple text field, which is displayed inline without a break (Note no trailing ↵). In fact, all the subfields are displayed without a break.
As you can see in the image below, the "Title" field is specified to always be displayed using Italic. Also, we use the Suffix Text option to specify adding a comma (and a blank space) immediately after the title value.
The Month field in this example is a pick list ("January", "February", etc.). The second publication, you'll see the month was not specified, so the year field slides into place.