Control types
TextField
This field type consists of a classic TextBox control. You can set the textbox width in field configuration.
TextArea
This field type is rendered as a textarea, for which you can set width and height.
DropDownList
This field renders as a classic combobox. You can set a list of values and the default value in field' settings.
MultipleSelect
This field is rendred as an asp.net CheckBoxList. If set as mandatory, at least one value must be checked to validate.
CheckBox
A classic checkbox control.
Label
Just a description label you can use to publish custom info, for example at the head of your form or to identify form sections.
RadioButtons
Rendered with an asp.net RadioButtonList, that is a list of radiobuttons. Can set the default value in field configuration.
DNNRichTextEditControl
This field type allows the user to input HTML content as field data, using the configured DotNetNuke editor (FCK Editor or Telerik RadEditor, depending on the active Editor Provider set in web.config).
File Upload
This field type allows users to upload a file. You can set the Portal's folder in which file will be saved. Submission entry, be it stored in db or sent via email, includes a link to the file.
Installation
To install this ODS Form you just have to download the installer package from this site, and install onto your DotNetNuke host by accessing, as a SuperUser, your Host > Module Definitions > Install Module page.
Folow the instructions and, when finished installing, add an ODS Form module (choose "Form" in the module list) instance to a page of your site.
Configuration
Open your module settings to edit basic form configuration, where you can set the following features:
Submit Mode allows you to choose whether to save your form' submissions to the database and/or to send them by mail to a (list of) email address(es).
Redirect URL allows you to redirect users to the specified URL after submitting the form.
Width is to set the form width, by acting on the HTML table element containing form items. Next ODS Form version will use DIVs instead of a table, so this might change.
CSS Class for buttons allows you to customize the appearance of the Submit and Reset buttons. Version 1.0.1 has three different styles available in module CSS:
CSS FormButton: small/medium/large, various colors
Sample CSS class setting: medium FormButton orange
CSS-only buttons: various colors
Sample CSS class setting: btn blue
CSS buttons with background image: orange
Sample CSS class setting: button
Use Captcha allows you to add a captcha control to your form, to avoid spam submissions.
Usage
Once configured module settings, you can create your form by adding any number of fields to it.
For each field, you have to set:
- the field's label
- the field type, by choosing from the list of available control types (see above)
- if the field is required (mandatory) or not
Depending on field type, you will also set some more parameters like:
- field width and height (number of rows and columns for a TextArea field type, control width/height where applicable - currently TextBox and RichText Editor -)
- the list of values to populate multiple-select fields (RadioButtonList, DropDownList, CheckBoxList)
- the default value for multiple-select fields
- the DNN folder where to save files, for File Upload field type only.