Release Notes for XWiki 11.2

Last modified by Marius Dumitru Florea on 2019/05/15

This is the release notes for XWiki Commons, XWiki Rendering and XWiki Platform. They share the same release notes as they are released together and have the same version.

This release brings a warning to the users when they are editing a page and other users are saving the same content. The Object editor has a new way of presenting XClasses meant to increase the user experience, while the top level application pages are not displayed anymore in the Navigation Panel. In addition the performance of the Notifications feature has been improved.

Some important bugs have been found since XWiki 11.2 has been released:

If one or several of these bugs impact you, then you should wait for the next version of XWiki (11.3) that will be released soon!

New and Noteworthy (since XWiki 11.1)

Full list of issues fixed and Dashboard for 11.2.

For Users

Improved view of XClasses in Object editor

 
It is easier now to find the XWiki Class of interest by using the new suggest box that replaces the old select element. The old way of searching is still available so the user still can explore the full list of available classes.

Exclude top level application pages from the Navigation Panel

 
The top level application pages are now excluded by default from the Navigation Panel. This allows the Navigation Panel to focus more on your own content pages.

Warning conflict when editing a page

 
The edition of document is now protected against edition conflicts. It means that a user might now obtain a warning conflict window, in case another user saved the document in the meantime. This window prevents from erasing the changes made by the first user having saved. 

Miscellaneous

  • Notifications Performances: The performance of the Notifications feature has been improved by implementing some in-memory caching of events for the users and more importantly its impact on the rest of the XWiki instance has been drastically reduced by limiting the resource allocated to it. This is a stopgap solution while waiting for a future redesign of the Notifications feature for better scalability for large volumes.

  • Backlink support improvements: The following areas containing backlinks are now refactored when renaming a page:

    • Images and attachments in wiki content
    • Wiki content in TextArea XObjects when the content is marked as containing markup

For Admins

No changes!

For Developers

No changes!

Upgrades

The following runtime dependencies have been upgraded (they have a different release cycle than XWiki Commons, XWiki Rendering and XWiki Platform):

Translations

The following translations have been updated:

Tested Browsers & Databases

Here is the list of browsers we support and how they have been tested for this release:

 BrowserTests performed and results
Chrome30.pngGoogle Chrome 73New and Noteworthy Features + Jira Tickets Marked as Fixed in the Release Notes + Smoke tests
Firefox30.pngMozilla Firefox 66Not Tested
Edge30.pngMicrosoft Edge 18Not Tested
IE30.pngInternet Explorer 11Not Tested
Safari30.pngSafari 12Not Tested

Here is the list of databases we support and how they have been tested for this release:

 DatabaseTests performed and results
hypersql.pngHyperSQL 2.4.1Not Tested
mysql.pngMySQL 5.7Not Tested
oracle.pngOracle 11.2New and Noteworthy Features + Jira Tickets Marked as Fixed in the Release Notes + Smoke tests
postgresql.pngPostgreSQL 10Not Tested

Here is the list of Servlet Containers we support and how they have been tested for this release:

 Servlet ContainerTests performed and results
tomcat-icon.pngTomcatNot Tested
jetty-icon.pngJetty (XWiki Standalone packaging)New and Noteworthy Features + Jira Tickets Marked as Fixed in the Release Notes + Smoke tests
jetty-icon.pngJettyNot Tested

Known issues

Backward Compatibility and Migration Notes

General Notes

  • When upgrading make sure you compare and merge the following XWiki configuration files since some parameters may have been modified, removed or added:
    • xwiki.cfg
    • xwiki.properties
    • web.xml
    • hibernate.cfg.xml
  • Add xwiki.store.migration=1 in xwiki.cfg so that XWiki will attempt to automatically migrate your current database to any new schema. Make sure you backup your Database before doing anything.

Issues specific to XWiki 11.2

Event Stream Mapping

The Event Stream Store now declares its mapping automatically. You must thus not declare the event stream store mapping into the hibernate.cfg.xml anymore. This means removing the following line:

<mapping resource="eventstream.hbm.xml"/>

Language Settings

The default value of the option xwiki.language.forceSupported is now set to true.
That means that only the supported languages defined in the Administration (section Content > Internationalization) will be used to display the wiki to our users.
If you want to support the previous behaviour, you can edit the default value of the option in xwiki.cfg by setting it to 0:

#-# Force only one of the supported languages to be accepted. Default set to true.
xwiki.language.forceSupported=0

API Breakages

The following APIs were modified since XWiki 11.1:

  • The annotation has been added in box macro but is used in Code Macro. It's not an api breakage.
    • Violation type:
      java.annotation.added
    • Code:
      ## Old:
      method void org.xwiki.rendering.macro.box.BoxMacroParameters::setTitle(java.lang.String) @ org.xwiki.rendering.macro.code.CodeMacroParameters

      ## New:
      method void org.xwiki.rendering.macro.box.BoxMacroParameters::setTitle(java.lang.String) @ org.xwiki.rendering.macro.code.CodeMacroParameters
  • The annotation has been added in box macro but is used in RSS Macro. It's not an api breakage.
    • Violation type:
      java.annotation.added
    • Code:
      ## Old:
      method void org.xwiki.rendering.macro.box.BoxMacroParameters::setTitle(java.lang.String) @ org.xwiki.rendering.macro.rss.RssMacroParameters

      ## New:
      method void org.xwiki.rendering.macro.box.BoxMacroParameters::setTitle(java.lang.String) @ org.xwiki.rendering.macro.rss.RssMacroParameters
  • Add URL parameters. Not a breakage in this context.
    • Violation type:
      java.method.numberOfParametersChanged
    • Code:
      ## Old:
      method javax.ws.rs.core.Response org.xwiki.notifications.rest.NotificationsResource::getNotifications(java.lang.String, java.lang.String, java.lang.String, java.lang.String, java.lang.String, java.lang.String, java.lang.String, java.lang.String, java.lang.String, java.lang.String, java.lang.String, java.lang.String, java.lang.String, java.lang.String, java.lang.String, java.lang.String) throws java.lang.Exception

      ## New:
      method javax.ws.rs.core.Response org.xwiki.notifications.rest.NotificationsResource::getNotifications(java.lang.String, java.lang.String, java.lang.String, java.lang.String, java.lang.String, java.lang.String, java.lang.String, java.lang.String, java.lang.String, java.lang.String, java.lang.String, java.lang.String, java.lang.String, java.lang.String, java.lang.String, java.lang.String, java.lang.String, java.lang.String) throws java.lang.Exception
  • Add new API to get the number of notifications. Not a breakage in this context.
    • Violation type:
      java.method.addedToInterface
    • Code:
      ## Old:
      null

      ## New:
      method javax.ws.rs.core.Response org.xwiki.notifications.rest.NotificationsResource::getNotificationsCount(java.lang.String, java.lang.String, java.lang.String, java.lang.String, java.lang.String, java.lang.String, java.lang.String, java.lang.String, java.lang.String, java.lang.String, java.lang.String, java.lang.String, java.lang.String, java.lang.String, java.lang.String, java.lang.String) throws java.lang.Exception

Credits

The following people have contributed code and translations to this release (sorted alphabetically):

Alex Cotiugă
apas008
Clemens Klein-Robbenhaar
Guillaume Delhumeau
Jarle Sandmo
Kenshabo
Marius Dumitru Florea
Niels P. Mayer
Rostyslav Fitsyk
Simon Urli
Thomas Mortagne
Tomasz Dąbrowski
Vincent Massol
Vyacheslav Sukharnikov
xrichard
Yuriy Safronov

Tags:
   

Get Connected