Skip to main content
Home  ›  Docs › Feature

Field Types (String, Number, Hyperlink etc.)

Warning ⚠️: New Docs Available

These are old docs and we haven't found the time to completely move them. You will find comprehensive new docs on docs.2sxc.org.

Introduced in Version 01.00.00

Overview

There are the following field types (and each has various configurations which affect how the user can edit the data):

  1. String = Text (single-line text, multi-line text, wysiwyg-text)
  2. Numbers (with or without decimals, also used for GPS etc.)
  3. Hyperlink / File - for referencing a link, image, document etc.
  4. Entity = Content-Item - for referencing one or many other items (like tags, authors, etc.)
  5. Boolean - yes / no
  6. DateTime - any date-time combination

Field Type String (Text)

Commonly used for things like

  1. Titles
  2. Short texts
  3. Multiline, unformatted texts
  4. Multiline, formated texts (WYSIWYG)

The input can be simple text boxes, multiline text boxes, drop-downs and WYSIWYG. 

Relevant Settings

  1. Input Type (unformatted, WYSYWYG, drop-down)
  2. Row Count (relevant if you want unformatted text or drop-down)
  3. Automatic Validition (applies some RegEx if desired)
  4. RegEx Server Side / Client Side: separate fields, because the syntax often differs a bit
  5. Dropdown Values (list of values used in the dropdown, if using key/value pairs, separate with a colon ":" like "Label:Value"
  6. WYSIWYG Height / Width

Field Type Number

Can be used for things like

  1. Simple numbers
  2. Numbers with decimal-digits
  3. GPS-Coordinates

Relevant Settings

  1. Number of decimals
  2. Minimum value (for example, if a number should never be smaller than 1970)
  3. Maximum value (eg. 2013)

Date and Time

no relevant settings to explain. 

Note that the output-template will usually choose to show only the date, only the time etc. So it's the same data-field no matter what you're actually entering. 

Hyperlink (File, Image, Download, Link)

Relevant Settings

  1. File Filter (list of extensions allowed in file/image picker)
  2. Paths (root paths for the picker dialog - ideal if you want all images for this Content-Type to be in the same folder)
    1. Use the syntax foldername - without "/" in front to specify a subfolder of the portal-root. Examples are "Apps" or "Gallery" or "Employees/Photos"
    2. You can also use subfolders - that would be "Employees/Photos"
    3. Always remember that this folder must already exist, and DNN must know that it is visible (readable) by the editing user. There are cases where the security settings were not set correctly in dnn - then the file picker won't show anything. 
  3. Dialog Type (document or image picker)
  4. Further dialogs allowed (will show these in the drop-down under the more button)
    1. Show Adam (new in 8.5)
    2. Show Page Picker
    3. Show File Manager
    4. Show Image Manager
  5. Buttons (new in 8.5) will let you specify which buttons are visible directly. The default is "adam,more" but you could also do "adam,page,more" or just "page". File / image are currently not supported, because as of now, DNN doesn't have a good image/file browser so we discourage its use. 

Things to know: 

  • the hyperlink will usually just keep a "File:53" reference, but will always return a full link when used in templates. 
  • You can add additional parameters behind a file-id, like "File:720?w=…&h=333#" - this allows you to add further image-resizing parameters 

 

Boolean

No relevant settings to be configured. 

What you should know: when using Tokens, a boolean values is converted to lower-case, to be JavaScript-like. So it will be true and false and not True/False.

Entity (Relationship)

  1. AllowMultiValue - allow more that 1 item to be selected. 
  2. EntityType - the name of entities you can select. For example "Tag" would only offer tag-entities in the drop-down

What you should know: when using Tokens, a boolean values is converted to lower-case, to be JavaScript-like. So it will be true and false and not True/False.