Release Notes for XWiki 11.2-rc-1

Last modified by Vincent Massol on 2019/04/04

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 Navigation Panel.

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

  • 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 73Smoke tests
Firefox30.pngMozilla Firefox 66Not Tested
Edge30.pngMicrosoft Edge 18Smoke tests
IE30.pngInternet Explorer 11New and Noteworthy Features + Jira Tickets Marked as Fixed in the Release Notes
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.7New and Noteworthy Features + Jira Tickets Marked as Fixed in the Release Notes + Smoke tests
oracle.pngOracle 11.2Smoke 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
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-rc-1

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 11.1:

  • Not a breakage.
    • Violation type:
      java.annotation.attributeValueChanged
    • Code:
      ## Old:
      @interface org.xwiki.stability.Unstable

      ## New:
      @interface org.xwiki.stability.Unstable
  • Not a breakage: class moved to a legacy module
    • Violation type:
      java.class.removed
    • Code:
      ## Old:
      class org.xwiki.velocity.introspection.AbstractChainableUberspector
  • Not a breakage: class moved to a legacy module
    • Violation type:
      java.class.removed
    • Code:
      ## Old:
      interface org.xwiki.velocity.introspection.ChainableUberspector
  • Not a breakage: class moved to a legacy module
    • Violation type:
      java.class.removed
    • Code:
      ## Old:
      class org.xwiki.velocity.introspection.ChainingUberspector
  • Not a breakage: class moved to a legacy module
    • Violation type:
      java.class.removed
    • Code:
      ## Old:
      class org.xwiki.velocity.introspection.LinkingUberspector
  • 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

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