Soft Locking
Magnolia Soft Locking module provides concurrent editing capabilities. Multiple editors can edit pages simultaneously and coordinate their activities within the authoring interface. Soft locking differs from JCR hard locking in that it stores information about who is editing content and this information is displayed as a warning to other users editing the same page. Whereas hard locking would prevent another user from editing the page, soft locking provides multiple-user access to content and facilitates efficient content contribution.
Download
Download the Soft Locking module from Magnolia Store or Nexus repository
Installing
Soft Locking is an enterprise module included in the Enterprise Edition bundle and typically already installed. Go to Magnolia Store > Installed modules in AdminCentral to check. To install the module individually, see the general module installation instructions.
Uninstalling
See the general module uninstalling instructions and advice.
Video
Configuration
The module is ready to use in its default configuration.
In Configuration > /modules/softlocking/config you can adjust module-wide options.
| Configuration node | Default value | Description |
|---|---|---|
class | DefaultSoftLockingSupport | Fully qualified name of the Java class containing the business logic. |
enabled | true | Enables and disables the module. To disable, set to false. |
timeoutSeconds | 300 | Time in seconds before a lock is released. The module checks periodically whether a user who started editing a page is still editing it. If the timeout has passed and the user is no longer editing, their username is removed from the list of current editors. |
Usage
Indicators and warnings prevent editing overlap and facilitate collaboration.
If a single user works on the site in edit mode, or multiple users work on different pages, the status indicator in the mainBar reads "Currently not collaborating".
When another user opens the same page, a notification is flashed to collaborating users: "Users currently editing this page: <names of users>".
When multiple users work on the same page, the status indicator displays the number of users currently working. When you click the user icon, details of other collaborators are displayed.
When a user saves a paragraph on a page, a message "User <username> has just saved this page" is flashed to other collaborators.
