Publishing

Cascade CMS features a robust publishing engine designed to render and publish content to one or more environments. Once content is published, it's completely decoupled from the CMS, allowing it to operate independently in any standard environment.

Overview

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 use the Block by viewing its Relationships.

Publishing an Asset

To publish an asset:

Click the Publish button ( ) in the toolbar when previewing a publishable asset or right-click an asset and select Publish from the context menu.
From this menu, you can either click Publish to publish the asset now with the default settings, or configure one or more of the following options:
- Optionally Publish Later - schedule the asset to publish at a future date and time.
  - Before this date, the asset can be indexed but isn't publishable and won't be included in other publish jobs such as folder or site publishes.
  - You can cancel a future scheduled publish with the Unschedule link when previewing the asset.
- View Publish Settings
  - View & Publish Related Content (if applicable) - publish the asset's linked and manual Relationships.
  - Include Publish Set (if applicable) - publish the Publish Set associated with the asset's Content Type.
  - Generate a publish report - send a summary of the items published (including any errors) to your user 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 - Users who have the ability to "Publish readable Home area assets" will be able to unschedule a future Publish Later created by another User.

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.

Unpublishing

To unpublish an asset:

Click More > Unpublish when previewing a publishable asset or right-click an asset and select Unpublish from the context menu.
From this menu, you can either click Unpublish to unpublish the asset now with the default settings, or configure one or more of the following options:
- Optionally Unpublish Later - schedule the asset to unpublish at a future date and time.
  - Before this date, the asset can be indexed and included in other unpublish jobs such as folder or site unpublishes.
  - You can cancel a future scheduled unpublish with the Unschedule link when previewing the asset.
- Generate a publish report - send a summary of the items unpublished (including any errors) to your user Notifications.
- Select one or more Outputs to unpublish (for pages).
- Select one or more Destinations to unpublish from.

Note - If unpublishing one or more Page or File assets results in the assets' parent folder on the remote server being empty, Cascade CMS will first check to make sure the folder is empty and then attempt to delete the empty folder from the remote server (with the exception of the site's base folder).

Note - When you move, rename, or delete an asset, Cascade CMS will automatically unpublish the asset from all enabled Destinations and Outputs (for pages) by default. This is to prevent outdated files from being left on the remote server at their old location. If you're not using workflow, you can change which Destinations and/or Outputs are unpublished if needed.

Scheduled Publishing

Individual assets can be scheduled to publish once at a future date and time. See Scheduling Publishing for Individual Assets for more information.

Additionally, the following types of assets can be set to publish on a recurring schedule:

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 - publish to all Destinations that are enabled at the time the job is added to the Publish Queue.
Publish to selected Destinations - publish to selected Destinations.

Frequency

Every day - publish the asset daily at the time specified.
Each selected day(s) - publish the asset each given day of the week at the time specified.
Every n hours - publish the asset every specified number of hours starting at the time specified.
- This setting does not respect Daylight Saving Time (DST) changes.
Cron Expression - publish the asset on a schedule specified by a provided cron expression.

Notifications

Send report to - send a publish report to the Notifications of selected Users and/or Groups.
Only send report when errors are present - only generate a publish report if there are errors during the publish job.

Note - Once scheduled for publishing, an asset will be added to the site's Publish Queue at the specified time. Note that the actual rendering and publishing of the asset could begin later if there are jobs ahead of it in the Publish Queue at the specified time.

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 ( ).