Get started - Publishing settings and permissions
Publishing dashboard
After installing Comala Publishing, the space administrator can use the space publishing dashboard to configure a space to publish pages in another space on the same Confluence Cloud site.
You can review and change the configuration in the setup wizard before first publishing a space. The publishing configuration is changed in the source space publishing dashboard. You must have added a target space to change any other publishing setting for the space.
When a target space is selected and saved in the publishing dashboard, publishing is enabled by default. A user can use the app to publish pages from the current space to the target (public) space.
Publishing permissions
Publishing configuration
To set up or change the publishing configuration, you must be a space administrator in the source space and the target space.
Publishing pages
To publish all the pages in a space, you need permissions in the source space and the target space.
In the source space:
a space administrator requires view and edit permission for all the pages
a page editor publishing an individual page needs view and edit permission
You also need view and edit space permissions in the target space to publish a page.
In the default publishing configuration, pages are published and synced using the Comala Publishing app add-on user permissions in the target space.
Using the add-on user permissions in the target space to publish pages lets you remove user edit permissions in the published target space, which can support compliance needs.
You can configure publishing to use the target space permissions for the publishing user instead of the app add-on user permissions.
The publishing user then needs at least the following space permissions in the target space to publish a page:
View All
Add and Delete Pages
Add and Delete Attachments
Do not change the permissions for the app add-on user!
Page-level restrictions on a page in the target space prevent a space administrator from publishing and syncing the source space page. As a space administrator, if you publish all the pages, a restricted page in the source space is not included in the list of 'Pages not published' in the whole space publishing report.
Publishing configuration
In the publishing dashboard, you must add a destination space for your published pages - the Target space - to change any other publishing setting in the dashboard. You can also use this option to change the target space and publish and sync pages to a different space.
When a target space is configured, Enable publishing is active by default.
The default publishing configuration lets you publish and sync pages from this source space to the target space using
single-page publishing - publishing a page by a page editor on a page-by-page basis
space publishing - publishing and syncing all the pages from this space to the target space
The publishing actions use the Comala Publishing app add-on user permissions in the target space to publish pages. Although publishing users must have view and edit permission in the source space, there is no need for a Confluence user who publishes content (a page editor or a space administrator) to have edit permissions in the target space
The space administrator can configure publishing to:
prevent any publishing from the space, for example, during a period of audit, by making Enable publishing inactive
change the User permission for publishing to require the user who triggers the publishing action to have view and edit permission in the target space
prevent editors from publishing on a page-by-page basis by making single-page publishing inactive
prevent the copying of page content properties. This is useful if there is a 3rd party app in the target space
only publish pages if they are in an applied Comala workflow final state when using space publishing - this publishes only pages that are out of sync and in the applied workflow final state
In Space publishing, a space administrator can use the Publish space button to publish and sync all the space pages in the space to the target space.
If all the pages have been previously by a space administrator, for example, if you used the setup tool and published the space, details of the last space publish action are displayed.
The See details link displays a report for the last publishing of all the pages in the space.
Next: Publishing pages
After a space is configured for publishing, you can publish and sync pages using single-page publishing as pages are updated and space publishing to publish and sync all the pages in a space.