Login
Home CMS Documentation Home CMS 10 Administration Publishing System Publishing Targets Configuring Publishing Targets Configuring Preview Settings

Configuring Preview Settings

Prerequisites:

To accommodate .NET technology, the Publishing System features a Preview Provider drop-down menu where administrators can select the preview rendering method.

The Preview Settings UI differs depending on your CMS site version. Follow the steps that correspond with your version.

CMS 10.6 Steps

To set a preview provider via CMS 10.6:
  1. Navigate to Administration > Publishing System.
    The Publishing Targets screen displays.
  2. Select the appropriate publishing target from the Manage Publishing Targets list.
    The Info tab displays.

    Publishing Target Info Tab

  3. Scroll to the Preview Settings section, and select one of the following options from the Preview Provider drop-down list.
    • Use the Dynamic Site Server preview provider to use, for example, the sample MVC solution included with the CMS.
      1. Clear the Use External Preview Provider checkbox

        The Preview Virtual Directory Path field displays.

        Preview Settings with Cleared Use External Preview Provider Checkbox

      2. Enter the path to the preview virtual directory in the Preview Virtual Directory Path field.

        Note
        Keep the following in mind.
        • To prevent cross-site scripting, the system requires the virtual directory to reside within the CMS installation or under the parent site of the CMS.

          The path starts with a slash (/) and may be several levels deep (e.g., /preview/dsspreview).

        • To use the sample MVC solution as the preview provider, maintain the default value DssPreview/IGXDynamicPreview in the field.

    • Use the External preview provider to enable the external preview system.

      1. Select the Use External Preview Provider checkbox to edit Multi-Format Output (MFO) content via the ICE (In-Context Editing) system.

        The External Preview Provider URL and The URL to provide updated field markup for In-Context Edit system fields display.

        Preview Settings with Selected Use External Preview Provider Checkbox

      2. Complete the following fields.
        Note
        After entering the correct URLs for the External provider, users with permissions can preview MFO content in the Edit tab's ICE mode and the Preview windows.
        FieldDescription
        External Preview Provider URLEnter the preview URL, which is a child of the CMS site.

        Note
        The external preview feature supports URLs starting with a slash (/), meaning the preview URL can use the path relative to the default site root. We generally recommend using a relative path in this field.

        The URL to provide updated field markup for In-Context Edit systemEnter the URL that replaces the built-in previewpage.asp file.

        The URL that you provide for the ICE system will receive updated element values and will return rendered markup.

  4. Select Save in the top right corner of the publishing target view.

CMS 10.0–10.5 Steps

To set a preview provider:
  1. Navigate to Administration > Publishing System.
    The Publishing Targets screen displays.
  2. Select the appropriate publishing target from the Manage Publishing Targets list.
    The Info tab displays.

    CMS 10.0–10.5 Publishing Target Info Tab

  3. Scroll to the Preview Settings section, and select one of the following options from the Preview Provider drop-down list.
    • Use the Dynamic Site Server preview provider to use, for example, the sample MVC solution included with the CMS.
      1. Select Dynamic Site Server in the Preview Provider drop-down list.

        The Preview Virtual Directory Path field displays.

        CMS 10.0–10.5 Preview Settings with Dynamic Site Server Preview Provider Selected

      2. Enter the path to the preview virtual directory in the Preview Virtual Directory Path field.
        Note
        Keep the following in mind.
        • To prevent cross-site scripting, the system requires the virtual directory to reside within the CMS installation or under the parent site of the CMS.

          The path starts with a slash (/) and may be several levels deep (e.g., /preview/dsspreview).

        • To use the sample MVC solution as the preview provider, maintain the default value DssPreview in the field.
    • Use the External preview provider to enable the external preview system.
      1. Select External in the Preview Provider drop-down list to edit Multi-Format Output (MFO) content via the ICE (In-Context Editing) system.

        The External Preview Provider URL and The URL to provide updated field markup for In-Context Edit system fields display.

        CMS 10.0–10.5 Preview Settings with External Preview Provider Selected

      2. Complete the following fields.
        Note
        After entering the correct URLs for the External provider, users with permissions can preview MFO content in the Edit tab's ICE mode and the Preview windows.
        FieldDescription
        External Preview Provider URLEnter the preview URL, which is a child of the CMS site.

        Note
        The external preview feature supports URLs starting with a slash (/), meaning the preview URL can use the path relative to the default site root. We generally recommend using a relative path in this field.

        The URL to provide updated field markup for In-Context Edit systemEnter the URL that replaces the built-in previewpage.asp file.

        The URL that you provide for the ICE system will receive updated element values and will return rendered markup.

  4. Click Save in the top right corner of the Manage Publishing Targets pane.

Next Steps: Choose one of the following steps.