Recite CMS Documentation Portal
Recite CMS Documentation Portal
Table of Contents
This chapter contains topics that don't belong in other chapters.
Custom field lists are used in many situations when building your site in Recite CMS, such as:
Defining fields for a custom email form
When creating a calendar event type
When creating a new page type
When managing a field list, your changes are not saved in real-time. You must finalise the form on which the field list manager appears before your changes are saved.
To add a new field click . You will then have to select the type of field you want to add. Each field type is presented differently when the custom list is output the users.
You will now be prompted to enter options for the field. The title field is what is displayed to users who fill out the field list. The internal name is how you can reference the value from your templates. If you leave the internal name blank it will be auto-generated based on the title.
Once you have filled out the options click . The field list will now update to display the new field. The following figure demonstrates the list with the newly added field.
Beside each field are buttons to edit and delete the field, while on the left is a drag handle for re-ordering fields within a list.
To edit a field, click the edit icon beside the respective field. You will then be shown a form to make changes with. Changes are not saved until you complete the form on which the field list manager is present (so in the previous figure, changes would be saved when you click ).
Currently when you rename a field, any values stored for that field are not renamed. For example, if you rename a custom field stored in a user directory, the value for that field stored with each user is lost unless you rename the field back.
This was originally by design, but since this causes some limitations this functionality will be likely updated in upcoming versions of Recite CMS.
To delete a field in a custom field list, click the delete icon beside the field. You will be prompted to confirm deletion. This change is not saved until you complete the form on which the field list manager is present.
Currently when you delete a field, any values stored for that field are not deleted. For example, if you delete a custom field belonging to a user directory, any data stored for that field will be retained internally. This means if you then re-create a field with the same name, the old values will be picked up.
This was originally by design, but since this causes some limitations this functionality will be likely updated in upcoming versions of Recite CMS.
You can change the order of fields in a custom list by dragging fields to their desired position in the list. To drag a field, use the drag handle (the series of dots to the left of the field name). Changes to the ordering of a list are not saved until you complete the form on which the field list manager is present.
