Publishing

Cascade CMS features a robust publishing engine designed to publish content to multiple environments (development, staging, production, etc.). Once content is published, it's completely decoupled from the CMS, allowing it to operate independently in any standard environment.

Overview

Cascade CMS features a robust publishing engine designed to publish content to multiple environments (development, staging, production, etc.). Once content is published, it's completely decoupled from the CMS, allowing it to operate independently in any standard environment.

Publishable Content

Publishable assets in Cascade CMS include folders, pages, and files. Note that files may include a wide range of content, including images, PDFs, CSS, and JavaScript files.

Although they sometimes contain HTML content, blocks are not publishable assets. To publish block content, you can publish the pages that utilize the block. You can view pages that include the block by viewing its Relationships.

Publishing an Asset

To publish an asset:

  1. Click the Publish button (  ) in the toolbar when previewing a publishable asset or right-click an asset and select Publish from the context menu.
  2. From this menu, you can either click Publish to publish the asset with the default settings, or click View Publish Settings for more options:
    • Enable View & Publish Related Content if you'd like to view and publish the asset's Relationships.
    • Enable Include Publish Set if you'd like the Publish Set associated with the asset's Content Type to be published as well.
    • Enable Generate a publish report if you'd like a summary of the items publish (including any errors) sent to your notifications.
    • For page assets, select the Outputs that you'd like to publish.
      • Because page outputs can be routed to specific Destinations at the Content Type level, the publish screen will indicate if a page output is set to publish to "All Destinations", publish to specific Destinations, or disabled for publishing altogether.
      • Outputs that are not publishable will be listed, but cannot be selected.
      • If an output is set to publish to "All Destinations", it will be eligible to publish to all Destinations but will only publish to those selected.
      • Likewise, if an output is set to publish to a specific Destination, it will only publish to that Destination if it's selected.
      • Outputs that have been disabled for publishing at the Configuration level will not appear on this screen at all.
    • Select the Destinations you'd like to publish to.
  Note - In most cases, Cascade CMS will prevent duplicate publish jobs from being added to the publish queue. Note that publishing an asset to different Destinations in separate submissions to the publish queue will not result in a duplicate publish warning. For example, if a user publishes Page A to Destination A and then publishes page A to Destination B; a duplicate publish warning won't be displayed.

Scheduled Publishing

The following types of assets can be set to publish on a schedule:

Once scheduled for publishing, an asset will be added to the publish queue at the specified time. Note that the actual publishing of an asset could begin later, depending on whether or not the publish queue is empty at the specified time.

Scheduled publishing can be configured on an asset when creating or editing it. Once enabled, the following options are available:

Destinations
  • Publish to all enabled Destinations - The asset will be published to all Destinations that are enabled when the scheduled job is added to the publish queue.
  • Publish to selected Destinations - The asset will be published to Destinations selected in the list of available Destinations accompanying this option.
Frequency
  • Every day - The asset will be published daily at the time specified.
  • Each selected day(s) - The asset will be published each given day of the week at the time specified.
  • Every n hours - The asset will be published every specified number of hours starting at the time specified.
    • Note: this setting does not respect DST changes. For example, if set to publish every 12 hours starting at 1:00 am, it will publish at 1:00 am and 1:00 pm. However, during Daylight Savings Time it will be publishing at 2:00 am and 2:00 pm. This is because at the day of DST change, 12 hours will pass between the 1:00 am and 2:00 pm.
  • Cron Expression (advanced) - The asset will be published on a schedule specified by a provided cron expression.
Notifications
  • Send report to - Select users and/or groups to receive a publish report in their notifications.
  • Only send report when errors are present - Enabling this option will only generate a publish report if there are errors during the publish job.

Publish Queue

Each site in Cascade CMS has its own publish queue that can process up to 2 jobs at a time. To view the publish queue, click the system menu button (  ) while in a site and select Publish Queue. When viewing a site's publish queue, you can also see which other sites have active publish jobs.

To reorder jobs in the publish queue, select a job from the list and use the arrow buttons to move it up or down in the queue. You may also drag-and-drop publish jobs into position in the list. Note that in-progress publish jobs can't be reordered.

To cancel jobs in the publish queue, select a job from the list and click the Delete button (  ).