Online Help

Help Table of Contents

CMS Dialog Box Reference

A complete list of all the CMS dialogs with a description of each field.

Button Properties

FIELD

DESCRIPTION

Label

The text identifying this button to Web page visitors, such as Submit Now.

Name

(Required.) The internal name of the Submit/Reset button in the database. When you first enter the Label, immediately press Tab to auto-populate the name field. If you change the Label later, tabbing does not automatically update the Name to match. You may wish to change the Name manually.

Width (Characters)

The width of the button as displayed on the Web page.

Button Type

Select the type of button you want, either Submit or Reset.

 

Button Group Properties

FIELD

DESCRIPTION

Group Properties

 

Include in group

Include the new button or checkbox in an existing group that you select from the drop-down, or create a New Group.

Label (Group)

The text (such as Form of Address) that identifies this group of buttons or checkboxes to Web site visitors. If an existing button group is selected in Include in group, this field auto-populates.

Name (Group)

(Required) The internal name of this button group in the database. If an existing group is selected in Include in group, this field auto-populates. When you create a New Group and enter its Label, immediately press Tab to auto-populate the Name. Note: If you change the Label later, tabbing does not automatically update the Name to match. You may need to change the Name manually.

Require at least one selection

(Select the Edit checkbox if this option is grayed out.) Select this checkbox to require at least one selection from the group.

Label

The text, such as Ms., identifying this single-button or checkbox option to Web page visitors.

Value (Option)

The (internal) alpha-numeric string stored in the database when this option is selected. When you first enter the single-button Label, immediately press Tab to auto-populate the Value field.

Initial State

Select this button's initial state, either not checked (default) or checked.

Drop-Down Menu Properties

TITLE

FIRST NAME

Label

The label identifying this drop-down menu to Web page visitors. For example: State or Favorite Species.

Name

(Required.) The internal name of this Menu field in the database. When you first enter a Label, immediately press Tab to auto-populate the Name. Note: If you change the Label later, tabbing does not automatically update the Name to match. You may need to change the Name manually.

Height (rows)

Enter the number of options from the drop-down list that can display at a time. The default is 1.

Allow multiple selections

Allow multiple menu selections using the CTRL key.

Required Field

Select to make this a required field.

For details on highlighting required form fields (for example, with a red border), see Styling Required Fields in Web Forms.

Dynamically build menu based on

Choose a source:

  • A list of content categories: Populate the drop-down with content categories already defined for your Web site. You can select a set from the Choose a set of categories menu. See Working with Content Categories.
  • A set of content items: Populate the drop-down with a set of related content items within your Web site. You can select the appropriate content filter in the resulting Choose a content filter menu, or create a new filter to suit your purpose. See Working with Content Filters for more information.

OR

Build your own list - Type in a label and value for each option in your menu. Click Add to add each new option (including the last one). Click Delete to delete a highlighted option. To change the order of the list, highlight an option and click Up or Down.

Embed Content Item

The following table describes the available options in the Embed Content Item component dialog.

FIELD

DESCRIPTION

Embed an item from:

Select one of the following:

  • CMS - Embed a content item from the current CMS or WSM site, or from a different site (host) within the same hostgroup. Use the associated fields to refine your embedding options.
  • An external Web site - Embed an item such as a video from an external Web site. Use the text area to paste in the HTML "embed" code.
Choose a method for selecting an item to embed:

(Only displays when embedding an item from CMS or WSM)

Select one of the following:

  • Use a specific item - Select this option, then choose an item and a display template for the item.
  • Use an item related to the current page - (Only displays if the associated content type has a related-items field) Select this option, then choose the desired related-items field in the Properties step as a source, and a display template for the item.

Note: The related-item option is recommended only when embedding the item in a single display template. When editing a Web page, it is preferable to use a template tag in the source code.

Choose the item to embed: (Only displays when embedding an item related to the current page in CMS or WSM) This drop-down menu includes any related-item fields in the Properties step of the current content type. Select the field that you want to use as a source. The related item for the page using the single display template that you are editing will display as the embedded item. If there are multiple related items, only the first will display.
Choose a field to get the related item: (Only displays when embedding an item related to the current page in CMS or WSM) This drop-down menu includes any related-item fields in the Properties step of the current content type. Select the field that you want to use as a source. The related item for the page using the single display template that you are editing will display as the embedded item. If there are multiple related items, only the first will display.
Choose a display template for the item (Only displays when embedding a specific or related item from CMS or WSM) Choose a display template to use when rendering either the specific item you selected manually or the related item.
OK/Cancel Click OK to save current edits to the component, or Cancel to discard unsaved edits. Either action closes the dialog.

File Upload Properties 

FIELD

DESCRIPTION

Label

The text identifying this field to Web page visitors, such as Choose a file.

Name

(Required.) The internal name of this field in the database. When you first enter the Label, immediately press Tab to auto-populate the Name. Note: If you change the Label later, tabbing does not automatically update the Name to match. You may wish to change the Name manually.

Required Field

Select this checkbox to require the Web site visitor to upload a file.Embed PageBuilder Page: Admin_CMS_Styling_Required_Fields_in_Web_Forms_REUSABLE_CONTENT

 

Hidden Field Properties

Note: The Reset button returns the form to its default state without saving unsubmitted entries. If a Web site visitor clicks this button, the Web form fields re-display as blank, or with any default initial values that have been configured by client administrators.

FIELD

DESCRIPTION

Name

(Required.) The internal name of the Submit/Reset button in the database. When you first enter the Label, immediately press Tab to auto-populate the name field. If you change the Label later, tabbing does not automatically update the Name to match. You may wish to change the Name manually.

Value

The (internal) alpha-numeric string stored in the database when this option is selected. When you first enter the single-button Label, immediately press Tab to auto-populate the Value field.

 

Include Properties Dialog

The Include Properties dialog displays when you insert or edit an Include component.

FIELD

DESCRIPTION

Include

From the drop-down menu, choose an existing Include or select New Include to create a new one.

Include content from all sites in group

When this is selected, the Include menu expands to include all Includes available in all sites within the current host group.

Title

Title of the new or selected Include.

Include Text

Using the HTML Editor, enter or edit the content to be saved within this Include.

Use these settings as the default

(Available to Website Administrators only.)

Select to make this the default Include for the current Web site.

Note: One of the existing, saved Includes always serves as the default.

Text Box Properties

FIELD

DESCRIPTION

Label

The label identifying this Text Box field to Web page visitors.

Name

(Required.) The internal name of this Text Box field in the database. When you first enter a Label, immediately press Tab to auto-populate the Name. Note: If you change the Label later, tabbing does not automatically update the Name to match. You may need to change the Name manually.

Initial Value

The initial text, if any, that you want this Text Box to display.

Width (characters)

The width of the Text Box as displayed on the Web page. This value does not restrict the total number of characters that can be entered (configurable in the Length field, up to the standard maximum of 4000). Users can press the left or right arrow keys to scroll through a long text string.

Height (rows)

The height of the Text Box as displayed on the page.

Required Field

Select this checkbox to make the Text Box a required field.Embed PageBuilder Page: Admin_CMS_Styling_Required_Fields_in_Web_Forms_REUSABLE_CONTENT

Text Field Properties

FIELD

NOTES

DESCRIPTION

Label

 

The label identifying this field to the site visitor, such as First Name or Zip Code.

Name

Required

The internal name of this field in the database. When you first enter a Label, immediately press Tab to auto-populate the Name.

Initial Value

 

The initial text, if any, that you want this field to display. For example, you can add a simple prompt like Enter your address here.

Width (characters)

 

The width of the Text Field as it displays on the page. This value does not restrict the total number of characters that can be entered (configurable in the Length field, up to the standard maximum of 256.) Users can press the left or right arrow keys to scroll through a long text string.

Link to a button group or select list for alternate values

 

Enables site visitors to manually enter in the Text Field a value corresponding to a selected menu or button/checkbox option. For example, a user can select Other from a menu, then manually enter a text value. To link the Text Field to a menu or a button group:

  1. Create a drop-down menu or a button group.
  2. Add an option (such as Other) to the menu or group to which you are linking this Text Field.
  3. Select the checkbox Link to a button group or select list....
  4. Select a Link Field (such as the name of the menu) and a Link Value (such as other) to define which option the Text Field is linked to.

Required Field

Not available if Link to a button group or select list... is selected.

Select this checkbox to make the Text Field a required field.

Link Field/Link Value

Required and only available if Link to a button group or select list... is selected.

  1. Select the field and field value to which you are linking the Text Field.
  2. Select a Link Field (an existing group of options on this page such as a drop-down menu or radio buttons/checkboxes).
  3. Select a Link Value (a single option from the group, such as other). A site visitor who picks that option can manually enter a corresponding value in the Text Field.

Data Type

 

Select the type of data that may be entered in the Text Field:

  • Text: Any alpha-numeric characters.
  • Integer: Only whole integer values. No text, special characters or numbers with decimals.
  • Number: Only numeric values (with or without decimals). No text or special characters.
  • Date: MM/DD/YYYY format. Select the Show a date chooser for this field checkbox to add a calendar widget for date selection.
  • Email: Standard email format, containing an @ and valid top-level domain format (such as mydomain.com).

Length

Only available if the selected Data Type is Text.)

Specify the maximum number of characters allowed (the maximum is 256 characters).

Characters

Only available if the selected Data Type is Text.

Select one or more checkboxes:

  • Letters: Entry may include letters.
  • Digits: Entry may include numeric digits.
  • Whitespace: Entry must contain at least one space.

Decimal

Only available if the selected Data Type is Number.

Specify the number of decimal places allowed in the Text Field (number) value.

Range

Only available if the selected Data Type is Integer or Number.

To set a range of allowed numbers, select from the greater than/greater or equal and less than/less or equal drop-down menus, and enter the desired numbers.

Show a date chooser for this field

Only available if the selected Data Type is Date.

Select this checkbox to add a calendar widget next to the text field. Site visitors choose a date, which then appears in standard MM/DD/YYYY format in the field. (The date can still be typed in manually, if desired.)

Send a confirmation email to this address

Only available if the selected Data Type is Email.

Select this checkbox to send an automatic confirmation of the form submission to the email address entered by the site visitor.