Multilingual Support

helferleinForm 02.00.00 or higher supports dynamic localization. There are some properties which are localizable (Label, HelpText, Value(s)...). In helferleinForm 02.00.00 or higher, these properties are grouped in the section "Localizable Properties". Other Properties are grouped in the section "Common Properties".

First, choose a type from the dropdown-list. You may use the types for the following purposes:

Type Description Usage as...
Single-line Textbox Entering a single of text Name, Phone,...
Multiple-lines Textbox Entering multiple lines of text Address, CV, Message,...
Dropdown-List Choose one element of many Profession, Country,...
Multiple Select Choose many elements of many Hobbies, Interests,...
Checkbox Single checkbox Order newsletter, agree with conditions...
Label Simple text to be dispayed on the form Welcome text, Attention,...
Radio Buttons Choose one Element of many Gender, Marital status,...
E-Mail Address Like textbox, but with validation of valid address E-mail address
Website A dropdownlist for the protocol and a textbox for the address. Must validate as a valid URL. Homepage,...
Date A textbox with a calendar control to pick a date. Birthdate,...
Send to A dropdownlist to select a recipient If you have different departments, this could show something like "Support", "Sales", "Recruiting" etc.
File Upload Select a file to attach to the submission Certificates, ...
Send copy A checkbox where the user may request an e-mail copy of his submission
Hidden A hidden field to post any value UserId, UserName...


Depending on the type, you have the following options:

Single-line Textbox

Single-Line Textbox

A Single-line Textbox may be used for names, dates, numbers etc.
  • Localizable Properties:
    • Label (required in the portal's default locale): Enter a label text for the textbox.
    • Help text: Enter a help text. This is used as an alternate text for the help icon left of the label.
    • Value(s): You may enter a default value for the textbox, if you wish. You may enter one of the following tokens (in square brackets) to set the default value according to the current (logged in) user:
      • [FULLNAME] - sets the user's full name
      • [FIRSTNAME] - sets the user's first name
      • [LASTNAME] - sets the user's last name
      • [DISPLAYNAME] - sets the user's display name
      • [USERNAME] - sets the user's username
      • DNN Tokens - see here
  • Common Properties:
    • Width: Enter the textbox's width in pixels. If you leave that empty, a width of 100% is assumed.
    • Required: If you check that, something must be written in the textbox, otherwise the form cannot be submitted.
    • Validation Expression: You may enter a validation expression (RegEx) to validate the input. Note: If there is an expression here and "Required" is not checked, an empty string may be submitted. Anyway, if the users enters anything, this will be validated against this expression.
    • Form Item Template: You can use this to override the default Form Item Template from the module settings. This allows you for examle to place two form items side by side.

Back to top

Multiple-lines Textbox

Multiple-lines Textbox

A Multiple-lines Textbox is useful for addresses, memos, messages etc.
  • Localizable Properties:
    • Label (required in the portal's default locale): Enter a label text for the textbox.
    • Help text: Enter a help text. This is used as an alternate text for the help icon left of the label.
    • Value(s): You may enter a default value for the textbox, if you wish.
  • Common Properties:
    • Width: Enter the textbox's width in pixels. If you leave that empty, a width of 100% is assumed.
    • Lines: Enter the number of lines for the textbox. If you leave that empty, 6 lines are assumed.
    • Required: If you check that, something must be written in the textbox, otherwise the form cannot be submitted.
    • Form Item Template: You can use this tho override the default Form Item Template from the module settings. This allows you for examle to place two form items side by side.

Back to top

Dropdown-List

Dropdown-List

With a Dropdown-List, you let the user select one option out of many. This can be used for countries, professions etc.
  • Localizable Properties:
    • Label (required in the portal's default locale): Enter a label text for the Dropdown-list.
    • Help text: Enter a help text. This is used as an alternate text for the help icon left of the label.
    • Value(s): Enter the values for the Dropdown-list's items separated by semicolons (;) or line breaks. E.g. Austria;Germany;Switzerland
    • Selected Value(s): You may preselect one value from the list above.
  • Common Properties:
    • Form Item Template: You can use this tho override the default Form Item Template from the module settings. This allows you for examle to place two form items side by side.

Back to top

Multiple Select

Multiple Select

A Multiple Select control lets the user choose many out of many options. This is useful for interests, skills etc.
  • Localizable Properties:
    • Label (required in the portal's default locale): Enter a label text for the checkboxes.
    • Help text: Enter a help text. This is used as an alternate text for the help icon left of the label.
    • Value(s): Enter the values for the checkbox items separated by semicolons (;) or line breaks. E.g. Austria;Germany;Switzerland
    • Selected Value(s): You may preselect values from the list above. Separate them by semicolons (;) or line breaks
  • Common Properties:
    • Repeat Columns: Enter the number of columns for the checkboxes to be displayed
    • Required: If you check that, at least one checkbox must be activated, otherwise the form cannot be submitted.
    • Form Item Template: You can use this tho override the default Form Item Template from the module settings. This allows you for examle to place two form items side by side.

Back to top

Checkbox

This displays a single Checkbox. It may be used for agreements to subscriptions etc.
  • Localizable Properties:
    • Label (required in the portal's default locale): Enter a label text for the checkbox.
    • Help text: Enter a help text. This is used as an alternate text for the help icon left of the label.
    • Value(s): You may enter two values if you want (e.g. Yes;No or True;False)
  • Common Properties:
    • Required: If you check that, the check box must be activated
    • Form Item Template: You can use this tho override the default Form Item Template from the module settings. This allows you for examle to place two form items side by side.

Back to top

Label

This is the simplest form control. It is used to display text on the form. Don't confuse it with the Label-property of the other item types!
  • Localizable Properties:
    • Value(s): The text that is displayed by the label control. You may use HTML in this field, but you have to HTML-encode special characters like the ampersand ("&"), quotes (""") etc.
  • Common Properties:
    • Form Item Template: You can use this tho override the default Form Item Template from the module settings. This allows you for examle to place two form items side by side.

Back to top

Radio Buttons

Radio Buttons may be used to select one out of many. This is quite similar to the Dropdown-List, but often more user-friendly. Examples: gender, marital status etc.
  • Localizable Properties:
    • Label (required in the portal's default locale): Enter a label text for the radio buttons.
    • Help text: Enter a help text. This is used as an alternate text for the help icon left of the label.
    • Value(s): Enter the values for the radio buttons' list items separated by semicolons (;) or line breaks. E.g. Austria;Germany;Switzerland
    • Selected Value(s): You may preselect one value from the list above.
  • Common Properties:
    • Repeat Columns: Enter the number of columns for the options to be displayed
    • Required: If you check that, one item must be selected, otherwise the form cannot be submitted. (Better way to do that: preselect one item!)
    • Form Item Template: You can use this tho override the default Form Item Template from the module settings. This allows you for examle to place two form items side by side.

Back to top

E-Mail Address

This one is quite similar to the Single-line Textbox, the difference is that if something is entered here it must be a valid-looking e-mail address, and, when displayed, it is rendered as a link.
  • Localizable Properties:
    • Label (required in the portal's default locale): Enter a label text for the e-mail address.
    • Help text: Enter a help text. This is used as an alternate text for the help icon left of the label.
    • Value(s): You may enter a default value for the textbox, if you wish. You may enter one of the following tokens (in square brackets) to set the default value according to the current (logged in) user:
      • [EMAIL] - sets the user's email address
      • DNN Tokens - see here - the only value that makes sense is [User:Email] which you can use instead of [EMAIL]
  • Common Properties:
    • Width: Enter the textbox's width in pixels. If you leave that empty, a width of 100% is assumed.
    • Required: If you check that, something must be written in the textbox, otherwise the form cannot be submitted.
    • Validation Expression: Per default an expression is provided to validate the e-mail address (the one that is defined in the portal's user settings). You may enter a different validation expression (RegEx) to validate the input. Note: If there is an expression here and "Required" is not checked, an empty string may be submitted. Anyway, if the users enters anything, this will be validated against this expression.
    • Form Item Template: You can use this tho override the default Form Item Template from the module settings. This allows you for examle to place two form items side by side.

Back to top

Web site

Web site

A Web site control consists of a dropdownlist for the protocol (http:// or https://) and a textbox. If somethinng is entered here it must validate as a valid Internet address. It is rendered as a link when displayed.
  • Localizable Properties:
    • Label (required in the portal's default locale): Enter a label text for the web site.
    • Help text: Enter a help text. This is used as an alternate text for the help icon left of the label.
  • Common Properties:
    • Width: Enter the textbox's width in pixels.
    • Required: If you check that, something must be written in the textbox, otherwise the form cannot be submitted.
    • Link target: You may select from "(None)", "New window (blank)", "Same window/frame (self)", "Parent window/frame (parent)" or "Top window/frame (top)" depending on where the link to the web site should be opened.
    • Validation Expression: Per default an expression is provided to validate the Url. You may enter a different validation expression (RegEx) to validate the input. Note: If there is an expression here and "Required" is not checked, an empty string may be submitted. Anyway, if the users enters anything, this will be validated against this expression.
    • Form Item Template: You can use this tho override the default Form Item Template from the module settings. This allows you for examle to place two form items side by side.

Back to top

Date

A Date control consists of a text box and a link to a calendar popup, where the user may pick a date.
  • Localizable Properties:
    • Label (required in the portal's default locale): Enter a label text for the date control.
    • Help text: Enter a help text. This is used as an alternate text for the help icon left of the label.
    • Value(s): You may enter a default value for the textbox, if you wish. Be sure it's a valid date!
  • Common Properties:
    • Required: If you check that, something must be written in the textbox, otherwise the form cannot be submitted.
    • Form Item Template: You can use this tho override the default Form Item Template from the module settings. This allows you for examle to place two form items side by side.

Back to top

Send to

The Send to item is a dropdownlist to select a recipient.
  • Localizable Properties:
    • Label (required in the portal's default locale): Enter a label text for the list.
    • Help text: Enter a help text. This is used as an alternate text for the help icon left of the label.
    • Value(s): The values field has to be formatted like this: Name1[emailaddress1];[Name2[emailaddress2];... Eg: Support[support@mycompany.com];Sales[sales@mycompany.com];Office[office@mycompany.com] Please note: The e-mail-address defined in the settings will be overwritten by the selection of this control.
    • Selected Value(s): You may preselect one value from the list above.
  • Common Properties:
    • Form Item Template: You can use this tho override the default Form Item Template from the module settings. This allows you for examle to place two form items side by side.

Back to top

File upload

The File upload control allows the user to upload files of allowed types (as defined in Host >> Host Settings >> Advanced Settings >> Other Settings) that do not exceed the size limit (as defined in the web.config file of your installation). After uploading the file, it will be attached to the sent email and stored in a folder called (PortalRoot)/helferlein/helferleinForm/ReceivedFiles/(ModuleID)_. To avoid overwriting of existing files, the file will be renamed to a GUID.
Please note: If you want to allow Anonymous users to upload files, make sure that the write permissions to this folder is set for all users in DNN's file manager.
  • Localizable Properties:
    • Label (required in the portal's default locale): Enter a label text for the file upload control.
    • Help text: Enter a help text. This is used as an alternate text for the help icon left of the label.
  • Common Properties:
    • Required: If you check that, a file must be uploaded, otherwise the form cannot be submitted.
    • Form Item Template: You can use this tho override the default Form Item Template from the module settings. This allows you for examle to place two form items side by side.

Back to top

Send copy

There are three requirements to get this entry from the dropdown list:
  • Submission by e-mail must be checked in the settings
  • A form field of the type E-Mail Address must be on the form, and
  • the sender has to be set to this form field

Only one "Send copy" field per form is allowed, so if you already have one, this is not displayed in the list anymore.
  • Localizable Properties:
    • Label (required in the portal's default locale): Enter a label text for the checkbox.
    • Help text: Enter a help text. This is used as an alternate text for the help icon left of the label.
    • Value(s): You may enter two values if you want (e.g. Yes;No or True;False)
  • Common Properties:
    • Form Item Template: You can use this tho override the default Form Item Template from the module settings. This allows you for examle to place two form items side by side.

Back to top

Hidden

This is a hidden field in the form.
  • Localizable Properties:
    • Label (required in the portal's default locale): Enter a label text for the item (this is used in the "Edit Submissions" control).
    • Value(s): You can use any DNN-Token, e.g. [User:Username]
  • Common Properties:
    • Form Item Template: You can use this tho override the default Form Item Template from the module settings. This allows you for examle to place two form items side by side.

Back to top

Last edited Jan 23, 2013 at 6:41 AM by Maikl, version 16

Comments

No comments yet.