Magnolia 5.6 reached end of life on June 25, 2020. This branch is no longer supported, see End-of-life policy.
The new delivery endpoint provides direct access to specific content through the REST API. The content can be pages, components, stories or anything else stored in a workspace. You can define an endpoint with a few lines of YAML. The response is concise JSON, designed to meet the needs of front-end developers.
Content tags make new ways of finding and re-using content possible. Tag similar content items for personalized targeting or tag current items for periodic campaigns. You can render content based on tags and consume tagged content via REST. Tagging is quick and modern – the system autocompletes as you type.
New content tagging feature let's you tag content items. Tags help you find content faster and enables targeting content to visitors.
tagfn
templating functions let you consume tagged content in templates.Once tagging is enabled for a content app, authors can quickly create and apply tags by selecting item(s) and using a simple keyboard shortcut T or the Add tags action to open the tagging dialog.
You can search through your content on the basis of tags using the tag:
prefix in any search field, as well as see all the places any given tag is used thanks to the Tags app.
The tags you apply to content can be used to aggregate and display content in different ways. See the Tours by tag page in the Magnolia demo for an example, or watch a short video.
CONTTAGS-1, CONTTAGS-7, CONTTAGS-10
The introduction of content tagging affects node type and workspace names:
marketing-tag
node type and is stored in the marketing-tags
workspace.tag
node type and is stored in the tags
workspace.While still available for use in the 5.6 branch, the original Activation module has been refactored into the Publishing module. The corresponding Transactional Activation module has also been refactored into the Publishing Transactional module. This refactoring brings transparency to the configuration of publishing content from the author instance to the public instance. For more information see Publishing and activation.
Since the Publishing module is now the default option provided with Magnolia bundles and webapps, see Upgrading to Magnolia 5.6.x: Publishing vs Activation and custom commands before migrating to Magnolia 5.6.
The Virtual URI mappings subapp, a part of the About app, has been deprecated. Virtual URI mappings were improved in Magnolia 5.5.6, so the default virtual URI mappings used in Magnolia modules have been updated as well, see Mapping classes . Use the Definitions app instead to view the mappings, since mappings can now be configured as YAML files or as nodes in JCR.
The Google Analytics module has been deprecated and removed from EE bundles. The module has modern replacements: Google Universal Visualization Analytics and Marketing Tags (module and app), which together provide the same functionality. Another reason for the deprecation of the module is that it used obsolete technology, namely third-party plugins that are no longer actively maintained.
Nevertheless, we keep the dependency in the EE parent POM for backward compatibility and to provide a smooth transition for customers who still depend on the old Google Analytics module.
Google considers every application that doesn't authenticate over the OAuth 2.0 to be less secure (see New Security Measures Will Affect Older (non-OAuth 2.0) Applications), so the Mail module and app have been upgraded to support also the OAuth 2.0 method.
REST endpoints enable other software to get content directly from Magnolia. This is how mobile apps, front-end JavaScript apps, or systems, like e-commerce or banking systems, can connect with Magnolia. With the new delivery endpoint, this is easier and faster to set up, more powerful and more performant than ever. Watch a short video as an intro.
The UI in Magnolia 5.6 is built on Vaadin 8.1.5 (see Vaadin 8.1.5 release notes and Vaadin 8.1.5 Java API docs). Since the upgrade to Vaadin 8 may affect the way your custom modules work, please read Vaadin 8 and custom modules before upgrading.
Since ClientErrorInterceptor
does not exist in RESTeasy 3, its capabilities were removed from our client implementation, the REST client module.
Commenting and Forum modules are no longer included in Magnolia bundles. The reason is simply that fewer Magnolia customers using these modules anymore. The number of new JIRA issues entered against the modules started to taper off couple of years ago:
We also put the modules into maintenance mode, which means we continue to fix bugs but we do not make any improvements or add new features. Maintenance mode typically lasts for a year after which we deprecate the modules in line with our Deprecation policy.
If you are looking for commenting or forum services, you have several options:
We no longer provide STK-based webapps and bundles. The Standard Templating Kit (STK) was deprecated on September 15, 2017, reaching the end of life on December 31, 2018.
The replacement for STK is Magnolia Templating Kit (MTK), first released with Magnolia 5.4 on July 3, 2015. MTK is quicker to learn than STK and requires fewer skills. MTK is aimed at the increasing number of front-end developers who looked for something leaner and less time-consuming. MTE is front-end framework agnostic, which means you can integrate it with any modern framework such as Bootstrap or Foundation.
STK timeline:
With the the release of Magnolia 5.6 we have stopped producing preconfigured bundles and webapps with the STK based demo. If you still rely on STK, see how to add STK to your bundle.
If you still rely on STK, see how to create a custom webapp with STK modules yourself.
Previously, dependency management information about third-party modules was defined in the parent POMs of magnolia.main
and magnolia.ui
. You may now optionally use a software BOM (Bill of materials) project instead. The project can then be imported in all modules. This ensures that the versions of the third-party modules are the same.
For more details about BOM and how to use it in your project please see the BOM for third-party modules page.
Since virtual URI mappings have been relocated to the Virtual URI module, all of the following mapping classes now also implement VirtualUriMapping:
MultiSiteRegexpVirtualUriMapping
MultiSiteRootVirtualUriMapping
SiteMapVirtualUriMapping
See also Mapping classes.
Apache Log4j 2 is an upgrade to Log4j that brings in significant improvements for logging configurations. If you currently have a custom Log4j config file then you will need to migrate it to the new format of version 2. For more details, see the log4j2.xml update section in Upgrading to Magnolia 5.6.x. Alternatively, you can use the compatibility bridge until you have time to migrate.
Despite being deprecated in Magnolia 4.5 (see the links at bottom of the page), the so-called "old Content API" continued to live and some Magnolia modules were still using it. With Magnolia 5.6 we've begun removing the old content API from our modules. See Removal of old Content API for details about what we have done and what you need to know if you are upgrading custom bundles with custom modules.
See the 5.6 changelog for all the changes.
If you are upgrading from an earlier version, read the Upgrading to Magnolia 5.6.x page first and check the Known issues section on it.
The URL path for documentation now always includes the version of the current major release. For example, documentation for Magnolia 5.6 is available at https://documentation.magnolia-cms.com/display/DOCS56/, not at https://documentation.magnolia-cms.com/display/DOCS/. Page requests for the old URL (DOCS) will be redirected as page requests for Magnolia 5.6 documentation.
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 Pieter Ardinois, Sven Bach, Michael Büchele, Grégory Joseph, Jarkko Mantysaari, Nicole Stutz and Sebastian Tauch.
Extra special thanks go to Richard Unger for submitting the initial update of the Log Tools app.