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

• CSS4J 0.42.3
• ASM 7.1
• SLF4J 1.7.26
• Apache PDFBox 2.0.14
• snakeyaml 1.24
• commons-codec 1.12
• Batik 1.11
• Javassist 3.24.1-GA
• JGroups 4.0.18
• Infinispan 9.4.9.Final
• Stax2 API 4.2

Translations

The following translations have been updated:

• French
• Norwegian
• Russian
• Ukrainian

Tested Browsers & Databases

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

	Browser	Tests performed and results
	Google Chrome 73	Smoke tests
	Mozilla Firefox 66	Not Tested
	Microsoft Edge 18	Smoke tests
	Internet Explorer 11	New and Noteworthy Features + Jira Tickets Marked as Fixed in the Release Notes
	Safari 12	Not Tested

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

	Database	Tests performed and results
	HyperSQL 2.4.1	Not Tested
	MySQL 5.7	New and Noteworthy Features + Jira Tickets Marked as Fixed in the Release Notes + Smoke tests
	Oracle 11.2	Smoke tests
	PostgreSQL 10	Not Tested

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

	Servlet Container	Tests performed and results
	Tomcat	Not Tested
	Jetty (XWiki Standalone packaging)	New and Noteworthy Features + Jira Tickets Marked as Fixed in the Release Notes
	Jetty	Not Tested

Known issues

• Bugs we know about

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:

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:

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