Magnolia 5.3 reached end of life on June 30, 2017. This branch is no longer supported, see End-of-life policy.

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

Magnolia 5.3.15 fixes a filtering bug in select fields and introduces the ability to restore a previously deleted node and its children. The behaviour of the dot (.) character in simple URL patterns has also been updated and may impact your custom roles.

What's new

Filtering in select fields

You can filter options select fields by typing part of the value. The filteringmode can be startswith, contains or off (default). You also need to set the pageLength property to a value greater than 0 and textInputAllowed to true for the filtering to work.


See the updated Javadoc info.magnolia.ui.form.field.definition.SelectFieldDefinition#getFilteringMode


Changed behaviour of SimpleUrlPattern

SimpleUrlPattern is used for web access rules in the roles of the Security app. You may have to check the web access rules of your custom roles.

Consider the following cases:

  • You have . in a pattern and expect . to be a real dot. => No change needed.
  • You have . in a pattern and expect it to be a wildcard. => This will not work as expected. Change to use ? instead.
  • You have \. in a pattern and expect it to be a real dot. => This will not work as expected. Change to use . only and remove the backslash.


Restoring deleted items

An includingChildren property has been added to RestorePreviousVersionCommand to enable you to restore a previously deleted node with all its sub-nodes. This means you can restore a deleted folder in the Assets app with all the assets inside it, for example.

Fixed an additional issue with restoring versions when the versioned node had sub-nodes.


Bug fixes

  • Fixed an issue with UserManager#getUsersWithGroup, which could cause task notifications to be incorrect or missing. We are also clarifying the usage of GroupManager to retrieve super-groups vs. sub-groups. MAGNOLIA-6615
  • NPE error is no longer logged when a user adds a favorite. MGNLUI-2981
  • Migrating from 4.5 to 5.3 no longer throws warnings or exceptions due to the Data module. MAGNOLIA-6688

An aggregated change log for 5.3.15 contains all the changes.

This release is a recommended update for all users of Magnolia 5.3.

Updated modules

This release includes the following new module versions: 

  • Community Edition 5.3.15

  • DAM 2.0.14

  • Enterprise Edition 5.3.15

  • Magnolia 5.3.15

  • Magnolia Standard Templating Kit 2.8.11

  • Personalization 1.1.5

  • Resources 2.3.8

  • UI 5.3.15

The Magnolia team would also like to thank everyone who reported issues, contributed patches, or simply commented on issues for this release. Your continued interest helps us make Magnolia better. Special thanks go to: Ronald Ten Berge, Rainer Blumenthal, Nils Breunese, Thomas Duffey, Marc Johnen, Grégory Joseph, Michiel Meeuwissen, Frank Sommer, Dirk Tillinger and Trang Truong.

How to update from Magnolia 5.3.14 and earlier

Follow the standard update procedure.

How to update from Magnolia 5.2 and earlier

To update your project, follow the standard update procedure, then make the following changes:

  1. Update your content apps with the content app upgrade task. It automatically takes care of the following:
    • Using the content connector.

    • Updating configuration of availability rules and default rule classes

    • Updating selected action definitions with node-type based availability

  2. If you used the DAM: 
    • Replace DamManager with AssetProviderRegistry.
    • See DAM and the STK and DAM templating on how to use assets in your templates.
    • The DAM changes have no impact on the STK. There is no need to modify Freemarker scripts because the new DAM API is abstracted from STK.
  3. If you have a custom jBPM workflow:
    • In the info.magnolia.module.workflow.jbpm.JbpmWorkflowManager#completeWorkItem method, checking for present parameters is obsolete and refers to publication related workitems. The method is no longer used for completing a workitem in the new human task context. It is still valid in the context of completing service tasks, however.
    • Stop using the info.magnolia.module.workflow.jbpm.JbpmWorkflowManager#getWorkItem method. It was used to complete a work item for human tasks. Furthermore, the wrapper we initialize only holds the mgnlData map.

    • The previously hardcoded mgnlData parameter is now configurable in /modules/workflow/commands/workflow/activate/activate/parameterMapName.

  4. If you have custom widgets or Vaadin add-ons:
    • Magnolia's default widgetset was relocated to info.magnolia.widgetset.MagnoliaWidgetSet.
    • Update your webapps's file.
    • Otherwise Magnolia will automatically fall back to the new widgetset but will issue warnings during upgrade, and whenever a user logs in to Magnolia.

How to update from Magnolia 4.5 and earlier

Are you running on Magnolia 4.5 or earlier? It’s time to move to version 5. Contact us for migration support and look at the migration process.

Known issues

Memory consumption

Magnolia 5.3.15 ee-bundle may require you to allocate more memory the Java Virtual Machine (JVM). If you see a java.lang.OutOfMemoryError in the startup log or the system stops responding during installation, increase the Java heap size. The default maximum heap size is 512M. Try a higher amount such as 1024M. We are working on uncovering the root cause for the increased memory need; see Java out of memory.

This release – and the imaging module in particular – is know to have some issues with image generation depending on the java version used (e.g. Mac OS X and Java 8 or Linux and OpenJDK 1.7). We therefore provide version 3.1.5-java7 of the imaging module with this release. As it is not binary compatible to previous versions it is not bundled by default. 

Imaging module version incompatibilities with some OS / Java version combinations

Magnolia 5.3.15 contains Imaging module version 3.1.5. This module version has known issues in certain OS and Java environments. For example, if you use it on OSX with Java 8 the module creates images with wrong colors.

Use a special version of the Imaging module: 3.1.5-java7 if you are on:

  • Java 8 on OS X
  • Java 7 OpenJDK on Linux. (Java 7 from Oracle on Linux can use the regular imaging-module)

For further information please see:

Installing magnolia-module-imaging 3.1.5-java7

magnolia-module-imaging 3.1.5-java7 is not bundled by default. You have to install it manually.

Option 1: Maven

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


Option 2: Download and install the files

Pre-built jars are also available for download. 

For further information please see installing a module.

  • No labels

1 Comment

  1. Hi, the filter for the aggregated change log for 5.3.15 is broken.