Publishing overview
Publishing handles how content gets published from an author instance to a public instance. Publishing is installed by the Publishing module and extended by the Publishing Transactional module (in DX Core).
The publishing implementation also allows you to define and use custom publishing operations with which you can publish content to something that’s not a Magnolia public instance, for example to a custom API or a Content Delivery Network.
DX Core includes transactional publishing to keep content synchronized between multiple public instances. This includes rollback if any of them respond with an error. A locking mechanism is used to manage concurrent publishing actions. A four-eye approval workflow facilitates structured publishing and reliable results.
Locking
Each publishing request executes a lock for either a path or node where content is to be published.
Path-based locking has been introduced as the default way of locking with version 1.2.6 of the Publishing module.
Node-based locking is available for compatibility reasons.
See the lockManagerMode property on the module page for configuration details.
|
If two users publish to the same (sub)tree, the locking mechanism waits a predefined amount of time and tries to obtain a lock for the operation. If the operation receives the lock, it can proceed with content (un)publishing. If not, publishing is considered unsuccessful and the respective status code is returned to the sender.
Content publishing and content synchronization Always wait with content publishing actions until all content synchronization tasks have been finished. If you attempt to publish a page while the Synchronization module is mid-sync and hasn’t yet synchronized the page’s parent, the publishing process will fail. |
Recursive and non-recursive publishing
Magnolia supports two methods of publishing content:
-
Non-recursive, which publishes only the selected node and its properties.
-
Recursive, which publishes the selected node, its properties, and its children.
Items that are marked for deletion are permanently deleted if their parent node is published recursively. |
You can’t publish the root node programmatically, but you can recursively publish its subnodes using the publishing command. You also can’t unpublish the root node or its subnodes. Instead, you must unpublish subnodes under the root node one by one. |
Transactional publishing
Transactional publishing provides a way to publish content-managed transactions. Content is:
-
commited
if all receivers respond with success status. -
rollbacked
if at least one of the receivers respond with error status.
The transactional publishing receiver uses mgnlSystem
workspace to store the backups of the published content.
If content is to be commited, the backup is removed.
If content is to be rollbacked, the backup is restored to the workspace it belongs to.
Workspaces are publishable by default
The Publishing module makes all workspaces publishable by default.
Authentication and security
Publishing is authenticated using public-key cryptography.
The authentication configuration for publishing is stored in /server/activation
; see Publishing security for more on this.
Disable the publishing workflow in the Pages app
Magnolia ships with publishing approval and rejection workflows. By default, they are only enabled in the Pages app.
Disabling the workflow in the Pages app may be appropriate for a simple site workflow where there are no separate editor and publisher roles.
There are several options to disable the publishing workflow for the Pages app.
-
Create a DX Core webapp that excludes the Workflow and Personalization modules.
-
Decorate the
pages-app
and add a dependency toworkflow-pages
. The dependency is necessary so that the light module decoration isn’t overridden again.Click to see the decorations
-
Delete the content of the
workflow-pages
decoration. This approach doesn’t persist the changes when an instance is upgraded and involves extra configuration steps.Click to see more details
Editing a resource in the Resources files app creates a copy of the recourse in JCR. This isn’t recommended for deployment and maintenance. For productive environments, you should use a decorator, as described above. Resource Files app
-
Go to the Resource Files app.
-
Search for
pages-app
. -
Select the file
/workflow-pages/decorations/pages-app/apps/pages-app/pages-app.subApps.yaml
. -
Click Edit file.
Make a copy of the contents if you need to restore the four-eye workflow actions later. -
Delete its contents and Save changes.
Configuration app
-
Add the
itemTypes
property on the/modules/publishing-core/commands/default/publish/publish
node as shown below./modules/publishing-core/commands/default/publish/publish Node name Value ⸬ publish
⸬ publish
⬩ class
info.magnolia.publishing.command.PublicationCommand
⬩ itemTypes
mgnl:contentNode,mgnl:componentVariants
-