Page tree
Skip to end of metadata
Go to start of metadata

The Activation module publishes content from an author instance to a public instance, see the Activation overview page for more information about how activation works. In the Enterprise Edition of Magnolia, the functionality of this module is extended by the Transactional Activation module which ensures synchronization of content between multiple public instances.

The module can be replaced with the Publishing module, which offers a neater and more logical structure of publishing (activation) functions, see Publishing vs Activation and custom commands.

Installing

Maven is the easiest way to install the module. Add the following dependency to your bundle:

<dependency>
  <groupId>info.magnolia.activation</groupId>
  <artifactId>magnolia-module-activation</artifactId>
  <version>5.6</version>
</dependency>

Pre-built jars are also available for download. See Installing a module for help.

Configuration

The Activation module is configured in Configuration > /modules/activation .

Activate and deactivate commands

Users typically activate content by clicking Publish in the Action bar. The click executes an activate command which pushes the content from the author instance to subscriber instances. Conversely, when users click Unpublish the system executes a deactivate command which deletes the content from public instances.

The activate and deactivate commands are configured in /modules/activation/commands . The default catalog contains commands which just publish the content without versioning. Magnolia also provides a versioned command catalog. It contains identically named activate and deactivate commands which first version the content and then delegate to the default commands.

Node nameValue

 modules


 activation


 commands


 default


 activate


 class

info.magnolia.module.activation.commands.ActivationCommand

 deactivate


 class

info.magnolia.module.activation.commands.DeactivationCommand

 versioned


 activate


 version


 class

info.magnolia.commands.impl.VersionCommand

 enabled

true

 activate


 class

info.magnolia.commands.DelegateCommand

 commandName

default-activate

 deactivate


 version


 class

info.magnolia.commands.impl.VersionCommand

 enabled

true

 deactivate


 class

info.magnolia.commands.DelegateCommand

 commandName

default-deactivate

To use one of these commands, define the catalog and the command name in the action definition. See an example in Executing commands with actions.

Activation log storage

The activationLogStorage property defines where information about activations are logged. The default implementation MemoryActivationStorage keeps the information in memory.

Node nameValue

 modules


 activation


 config


 activationLogStorage


 class

info.magnolia.module.activation.monitor.MemoryActivationStorage

How activation works

How activation works is described on the Activation overview page.

Troubleshooting