LISTSERV Maestro 8.1-4 Help

Subscriber Dataset Custom Pages & Emails

The left pane displays the LISTSERV Maestro explorer tree, with the "Subscriber Datasets" subtree. This subtree contains all subscriber datasets and lists. In this tree, each dataset has its own little subtree, with the main dataset node as the root, and two or three child nodes. The Custom Pages & Emails node is such a child node.

While the Custom Pages & Emails node of a dataset is selected in the tree, the pane on the right shows the subscriber area layout customization for the dataset.

If at least some layout elements of the dataset have been customized, then the right pane contains a list of all customizable layout elements, on three sub-tabs: Subscriber Pages, Messages and Input Validation Errors and Default Profile Field Styles. The customizable layout elements are shown with icons explaining their current customization status.

The Default Profile Fields Styles tab shows the currently defined default styles that are used to display the profile fields on the subscriber pages.

During customization, the profile fields of a dataset or list are represented by placeholders in the customized HTML code. These placeholders, in turn, may be defined with optional attributes to fine-tune how each profile field is displayed on the final page.

Placeholders (and the associated input or display control) for a profile field can appear on several pages (for example on the External Subscribe pages and on the Internal Edit Profile page). Each such placeholder in the HTML code can contain custom style attributes which define how this particular occurrence of the placeholder for the associated profile field is displayed. If no custom style attributes are supplied as part of the placeholder syntax, then the default profile field style definition supplied on this screen is used instead.

To understand this defaulting behavior, see the following example:

Assume there is a profile field called "NAME" and that it should display with an edit field of size "40". If you include placeholder "{{maestro:profileNAME size="40"}}" directly on the page, this means that the default style defined for the field "NAME" is ignored and that the custom size of 40 is used instead. If you include the placeholder without attributes on the page ("{{maestro:profileNAME}}"), then the default style defined for the field "NAME" is used.

To define the default style for a profile field, simply click the field's name. In the edit screen that opens, supply the settings for the default style.

Note: The default versions of all subscriber area pages (the versions that are used if no customized versions are provided) all use the profile field placeholders without any individual attributes; therefore, any pages that are displayed in their default state will also use the default profile field styles defined on this screen.

For a dataset, see here for details about the Subscriber Pages tab or the Messages and Input Validation Errors tab.
For a list, see here for details about the Subscriber Pages tab.

Available Types of Input Controls

The following list describes the input control types that are available for the various types of fields or subscriber options. The default profile field style edit screen only lists the input control types that are available for the selected profile field or list option.

Style Attribute Settings

The following lists describe all available default profile field style attribute settings. Depending on your chosen type of input control and other settings of the profile field, the default profile field style edit screen contains only a subset of the full lists below.

Advanced Subscriber List Settings

The following settings only apply if the selected list is an Advanced Subscriber List. Similar to the various other subscriber choice option settings, these settings define the text with which certain LISTSERV list subscription options are presented as a choice (in the form of a drop-down option or radio button, see above) to the list subscribers.