The Form Settings are divided into seven sections:

Multilingual Settings

Multilingual Settings

Locale

Select the locale for the values of the other fields. The dropdown list includes all enabled locales of your portal. You may also include disabled locales by activating the checkbox below this list.

Include disabled locales

By default, only enabled locales are displayed in the dropdown list. By activating this checkbox, you may also include disabled locales in the locales list.

Module title

Enter a module title in the given locale - this will override the module title you entered in the standard (non-ML) module settings.

Subject

The subject of the sent e-mail. This has been moved from the Submission settings, as it is also localizable. There is a default subject defined in the resource files, so if you do not want to change it, you can leave this field blank.
You can use the following tokens which will be replaced when sending the email:
  • [PORTAL_ID] - the portal ID
  • [PORTAL_NAME] - the name of the portal
  • [TAB_ID] - the ID of the tab (page)
  • [TAB_NAME] - the name of the tab (page)
  • [MODULE_ID] - the ID of the module
  • [MODULE_TITLE] - the (localized) module's title

Back to top

Submission Settings

Submission Settings

Submission Mode

Define how the form is to be transmitted: You may choose either Store in database or Send by e-mail (or both).

This is the only setting that is really necessary - if you activate Send by e-mail, you also have to provide an e-mail-address in the next field.

E-Mail address(es)

If you decide to submit the document by e-mail, you have to provide an e-mail address (where the form will be submitted to) in the E-Mail address(es) texbox. Separate multiple e-mail addresses by semicolons (;) if needed.

Redirect URL

If you want to redirect the user to another URL after submitting the form, write this URL in the Redirect URL field, or choose a page on your site.

Approval

If you decide not to approve submissions manually, you may check this. It saves a bit of work, but may not be useful if users submit rubbish - and: Approved submissions are displayed in the search results, even if you check "Not at all" as the submission display option.

Back to top

Email Options

Email options

E-Mail format

The standard format for mail submissions is plain text. If you want to submit e-mail in HTML format, then check this. It may look nicer, but it seems that on some SMTP servers this setting causes some cryptic mails. Just try it.

Note: Under some circumstances, HTML mail may not work. Please use text mail in this case.

Sender

This allows you to determine by whom the resulting e-mail is sent. If you choose Portal-Administrator, the current portal administrator (set under Admin >> Site Settings >> Advanced Settings >> Other settings) will be used. If you change that in the site settings, this will affect the sender address here as well. This behaviour is equivalent if you select Host. When you select any other administrator (display name followed by "[A]") or host user (display name followed by "[H]"), this will not change if you change the portal administrator or the host.

If you have form fields of the type "E-Mail Address", you may also select one of these form fields (Label followed by [F]). Then the submitted value from this field is used as the sender's address.

Reply-to

With this you may choose a reply-to field for outgoing emails. This is due to a feature request (Reply-to). For more information see openspf.org.

Options

Include IP-Address
You may check this if you want to have the sender's IP address included in the email.

Back to top

Module Appearance

Module Appearance

Theme

A theme let's you change the whole appearance of the module. There are four themes provided (Portal Themes - name ends with P in the DropDownList):
  • Default - this is the default theme
  • DNN_Feedback - let's the module appear similar to the DNN Feedback core module
  • Fancy - well, no one will use that (I hope). It shows what can be done with the module, and therefore is useful for a designer to customize the module appearance by writing an own theme.

Attention: The theme DNN_Feedback hides the required field markers explanation!

To add your own theme, create a folder with the theme name (e.g. "MyTheme") as a subfolder of (PortalRoot)/helferlein/helferlein_Form, and add a CSS file with the same name ("MyTheme.css"). These Module Theme names end with M.

Back to top

Form Appearance

Form Appearance

Width

Enter the form's width. If you leave that empty, the width will be set to 100% by default.

Form Header Template

Here you have another possibility to change the form's appearance. You may use HTML tags here, these will be put at the top of the form. These Templates are used, if no template is defined in the Form item itself (see Add/Edit Form items)

The default value is:
<table width="100%" cellpadding="2" cellspacing="2" border="0">
   <colgroup>
      <col width="30%">
      <col width="69%">
      <col width="1%">
   </colgroup>

This is actually the same as it was in former versions of the module, so if you are happy with this, you may leave the template fields blank. If you want to use a table-less design, you can try the following:

<div>

Form Item Template

Here you can use the following tokens:
  • [PENCIL] - displays the edit pencil, when a user with administrative rights visits the page with the module.
  • [LABEL] - displays the label (do not confuse it with a label form item - see below).
  • [FORMITEM] - displays the form item itself (i.e. the textbox, dropdown list etc.)
  • [VALIDATOR] - renders the validator for this item
  • [REQUIREDIMAGE] - displays the required image, if the field is required

Default:

<tr valign="top">
   <td>[PENCIL][LABEL]></td>
   <td>[FORMITEM][VALIDATOR]></td>
   <td>[REQUIREDIMAGE]></td>
</tr>

Table-less example:

[PENCIL][LABEL][FORMITEM][REQUIREDIMAGE]<br /><br />

Form Footer Template

This is used at the end of the form.

Default:

</table>

Table-less example:

</div>

Label Template

This is used for Label items (do not confuse it with the Label property of the other form items!). A Label is only a text to display, so you can only use the tokens [PENCIL] and [FORMITEM].

Default:

<tr>
   <td colspan="3">[PENCIL][FORMITEM]</td>
</tr>

Table-less example:

[PENCIL][FORMITEM]<br /><br />

Required Field Marker

Choose how required fields should be marked - either, the standard icon appears, or you may display an asterisk beneath the label or you can decide to display nothing at all.

Show required field marker explanation

Choose where the required field marker explanation should be displayed: Above the form, below the form or not at all.

Attention: The theme DNN_Feedback hides the required field markers explanation!

Show approved submissions

This defines where to display approved submissions to the public. You may choose either above the form, below the form or not at all.

Buttons

You may choose if the "Send" and "Back"-buttons of the form appear as a link, a button or a Command Button (DNN control with an image and a text link).

Options

Include Captcha
To avoid spam, you may check this to include a captcha (Completely Automated Public Turing test to tell Computers and Humans Apart - see http://en.wikipedia.org/wiki/Captcha) to the form.
Unauthenticated only
You may check this if you want the Captcha to be shown only for unauthenticated users.
Show validation summary as
You may decide to show a validation summary as a popping-up Message Box alert, or to be displayed at the end of your form. If you do not choose any, only an asterisk (*) will be displayed at the right side of the form item.

Back to top


Submission Appearance

Submission Appearance

Show Approved submissions

Here you can select where approved submissions shall be displayed: above or below the form - or not at all.

Keep for (days)

This is an important feature. It controls for how many days approved submissions will be displayed to the public (if you have chosen "Above the form" or "Below the form" above).
If left empty, submissions will be display forever, or at least until deleted or unapproved manually.

Group output by

You may chose one of the radiobutton or dropdownlist fields of the form to group the displayed (approved) submissions.

Render as Headline

You may choose any single-line-textbox', dropdownlist's or radio button's value to be displayed as a headline for each submission.
When you choose a headline, you may also set this as the subject for the sent mail by checking the approbriate option (this option only appears, if you set a headline). This overrides the subject from the ML settings above.

Align headline

If you have chosen any headline field, you may align the headline left, centered or right.

Options

Show date
When checked, the submission date is displayed in the approved submissions.
Show labels
When checked, the form items' labels will be displayed in the approved submissions
Show recipient's email address
When you use a "Send To" form item (see Add/Edit Form items), you can suppress the display of the recipient's email address by leaving this checkbox unchecked. Otherwise, it will be displayed.

Back to top

Settings for "Edit Submissions"

Settings for Edit Submissions

Display in Dropdown-List

You may choose one of the single line textboxes or e-mail field to be displayed in the dropdownlist under "Edit submissions".

Back to top

Other Settings

Other Settings

Include e-mail addresses in search results

Activate this if you want to display the submitted E-Mail addresses in the search results (not recommended).

Back to top

Last edited Nov 22, 2014 at 2:25 PM by Maikl, version 17

Comments

No comments yet.