OpenCms stores all resources in two versions. You edit them in the offline version and guests on your website see the online version. The process of copying offline resources to the online versions is called publishing. Depending on your permissions, you will have different options for publishing, or no option at all. Take a look at how to publish changes and what you should care about.
Where to press for publishing?
The workplace toolbar provides the symbol in some apps, in particular for all editors and the explorer. When you click the icon, the publish dialog appears. Here you can choose which resources you want to publish. In the explorer, the dialog can also be opened from the "Publish directly" option in the context menu of each resource.
The publish dialog
- This page
This option is available when you open the publish dialog from the page editor or in a content editor. The dialog shows the changed resources that are placed on the currently requested page (URL) - or placed in a container on the container page available at this URI
- My changes
Shows all changes done by the logged-in user. Changes are grouped in sessions, as shown in Figure publish_dialog.
Shows all changed resources belonging to the selected project.
- Direct publish
This option is only available if you click on "Publish directly" in a resource's context menu in the workplace's explorer view. If chosen, all resources published with the resource you want to publish directly are shown.
The Workflow selector is only enabled if the workflow option is enabled. If so, you can choose between publishing or releasing changes. Release does not mean publish. It means that the changes are placed in a separate project and someone is asked to publish your released changes.
The resources shown dependent on the selection can be checked or unchecked for publishing. Only checked resources will be published. Furthermore, for each resource, some more options are available, described in the next subsection. Below the resource selection, you can toggle two more options:
- Include related resources: If checked, changed resources of elements placed on a page will also be published, if the page is published. Also changed parent folders of a resource will be included on publishing. It is recommended to use this option. It usually helps to publish all related changes in one run. If you check the option, resources with related resources are preceded by a little plus sign. Click this sign to see the related resources.
- Include siblings: If checked, and a resource with siblings is published, all siblings are published as well. Otherwise, only the directly chosen siblings are published.
When you click Publish, your selection is checked and potential problems are displayed (i.e., if relations will be broken in the online project when you publish the chosen selection). If no problems are found, publishing is started directly. Otherwise you have to confirm, having been made aware of these problems first.
If you hover over a resource, you get several options for it. You can:
Errors and warnings
When publishing changes will break relations, you get the problems shown:
Hovering over the warning symbol, you get more information on the problem. Besides breaking relations, also permission problems may appear, resulting in an error. This is for example the case, if you can only release a resource, but not publish it.