CMSList+ Forms

Form Fields

1. List of supported form field types. List shows field type, associated HTML form tag and description.

   1. checkbox - (CHECKBOX) Single checkbox field.
   2. date - (DATE) Date field.
   3. editor - (TEXTAREA/TinyMCE) WYSIWYG editor field.
   4. email - (EMAIL) E-mail input field.
   5. imgselect - (SELECT) Select one from available image file attachments.
   6. multiple - (CHECKBOX) Select from a range of predefined checkbox options.
   7. notes - (TEXTAREA) Plain multi-line text input.
   8. numeric - (TEXT) Input field for numbers.
   9. pwd - (PASSWORD) Password input field.
   10. radio - (RADIO) Pick one from range of options.
   11. range - (INPUT) Select a number from a fixed range of numbers.
   12. select - (SELECT) Select one from multiple options in select format.
   13. tel - (TEXT) Telephone input field with validation.
   14. text - (TEXT) Single line text input field.
   15. time - (TEXT) Time input field in 12-hour format.
   16. url - (YRL) Hyperlink input field.
   17. uselect - (SELECT) User select input field. Will vary on category permission.
   18. static - (N/A) Exposes pre-defined read-only data only.
   19. hidden - (INPUT) Adds a hidden INPUT field with preset data that is already defined in the field definition file. (v0.1.38)

Form Field Attributes

1. Field attributes are mechanisms to control how input fields are presented and validated.

   1. Field types and applicable attributes:
      
      *tap on image to enlarge.

Custom Form Primer

1. What's the difference between tasks and forms?

   1. A task includes priority levels, ownership and date constraints, example: project tasks and to-do lists.

   2. A regular form doesn't include constraints, example: work portfolio, profiles, and general record keeping forms.

      1. There are two kinds of regular forms: form and contact.

         1. The difference between the two is contact form is associated with contact list categories, while the standard form can be used on all other types of list. You can only use contact forms on contact lists.

2. How to create a custom form?

   1. Create a new form field definition file.

      1. Make a copy of an existing field definition file in the task or form directory.
         

      2. Give the file a unique name.

         1. For forms: "cmslist_fields_<unique name>.php"
         2. For tasks: cmslist_task_fields_<unique name>.php.
         3. This will become the name of the form.

         4. Note:

            1. The unqiue name given to the file will become the form's selector in the form or task category admin screen.
            2. Keep the name short, between one to three words.
            3. Use an underscore to separate words.
            4. Use small letters, for alphanumeric names.

   2. Edit the fields of the new form.

      1. Remove the fields that are not needed.
      2. Add new fields you need.
      3. Change the labels, description and other attributes.
      4. Add form validation rules for each field, using Form Field Attributes as your guide.

   3. Test the form.

      1. Create a new category that will use the form.

         1. Task list can only use Task forms.
         2. Forms list can use either Forms or Contact forms.
      2. Create a new post without any content.
      3. Open the post to display the form.
      4. Click the Edit button to test the edit layout and validation rules.

3. How to make forms searchable?

   1. Name one field "details". This would be your descriptions or details field, where the most pertinent information about your form is entered.
   2. The 'details' form field is included in search queries.