Release Notes for XWiki 9.2-rc-1

Last modified by Manuel Smeria on 2017/03/31

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

This release introduces the Notification menu to follow wiki activity more easily. The Administration has been re-organized with a collapsible menu. The Menu Application becomes responsive with burger menus. For the advanced users, the CKEditor integration adds support for dedicated Insert Macro tool bar buttons and the Extension Manager adds support for conflict resolution configuration when installing an extension. As usual, the release also brings many bug fixes and other small improvements.

New and Noteworthy (since XWiki 9.1.1)

Full list of issues fixed and Dashboard for 9.2.

For Users

Notifications


We have introduced a list of notifications in the top menu, that list some events that have occurred in the wiki recently: a page has been created, a new blog post has been published, etc...

See the Notifications Application's page to have more infos.

Administration Improvements


The Administration has been reorganized. Most of the administration sections from the "Applications" group have been moved to existing or new groups. We applied a consistent style across all the administration sections and we added more hints for the configuration options. The administration menu is now implemented using a collapsible accordion. 

Improvements of the Menu Application on Mobile


The space taken by the horizontal menus created with the Menu Application has been reduced by introducing menu burgers on Mobile display. The burgers are placed on the left side of the page, to avoid confusion between the Drawer menu and the horizontal menus.

CKEditor Integration Improvements


The integration with the CKEditor has been improved to support putting dedicated Insert Macro buttons on the tool bar. We enabled the native (in-browser) spellchecker and we fixed a few bugs.

For Admins

Extension Manager improvements


Extension Manager now gives a chance to users requesting it in their profile configure default conflict resolution behavior at the beginning of the install/upgrade/uninstall.

For Developers

Ability to store events in the event stream and display them as notifications


It is now possible to say to the Event Stream Module that some events, sent with the Observation Module, should be stored.

In addition, this events can be displayed in the notifications menu of users. See the tutorial: How to send notifications.

Filer Stream improvements


Instance Filter output stream now support xobjects without class definition so input filters don't have to generate events for it. It automatically fallback on the xclass located in the current wiki.

Jobs improvements

 

  • The JobStatus now indicates the job type. There is nothing to do for Job extending AbstractJob but other will have to properly support it in the their JobStatus.
  • The Job REST API now automatically injects context information (current user, current caller, current wiki, current document, current secure document, the request URL and parameters) in the job thread.

Miscellaneous

  • Extension Manager improvements: Extension Manager now generate events just before starting to install/uninstall/upgrade an extension.

Moved Modules

No modules have been deprecated, retired or moved.

Upgrades

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

Translations

The following translations have been updated: 

  • French
  • Croatian

Tested Browsers & Databases

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

BrowserTest Result
Chrome30.pngGoogle ChromeNot Tested
Firefox30.pngMozilla FirefoxNot Tested
IE30.pngInternet Explorer 10Not Tested
IE30.pngInternet Explorer 11Jira Tickets Marked as Fixed in the Release Notes + New and Noteworthy Features

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

DatabaseTest Result
hypersql.pngHyperSQLNot Tested
mysql.pngMySQL 5.7Jira Tickets Marked as Fixed in the Release Notes + New and Noteworthy Features
oracle.pngOracleNot Tested
postgresql.pngPostgreSQLNot Tested
All tests passed except Closed XWIKI-13636 which has been reported as Open XWIKI-14132.

Known issues

Backward Compatibility and Migration Notes

General Notes

When upgrading make sure you compare your xwiki.cfg, xwiki.properties and web.xml files with the newest version since some configuration parameters may have been modified or added. Note that you should add xwiki.store.migration=1 so that XWiki will attempt to automatically migrate your current database to the new schema. Make sure you backup your Database before doing anything.

API Breakages

The following APIs were modified since XWiki 9.1.2:

  • The ExtensionId.hashCode field was wrongly introduced as non transient and deserializing some data serialized with the previous XWiki version should at worse initialize it to the default value which is -1 and ok. In any case we're using the ignoreUnknownElements() option on the XStream side so we should be ok anyway!
    • Violation type: java.field.serialVersionUIDUnchanged
    • Old: field org.xwiki.extension.ExtensionId.serialVersionUID
    • New: field org.xwiki.extension.ExtensionId.serialVersionUID
  • Does not break anything: new static field with no impact on the serialization/unserialization
    • Violation type: java.field.serialVersionUIDUnchanged
    • Old: field org.xwiki.extension.job.AbstractExtensionRequest.serialVersionUID
    • New: field org.xwiki.extension.job.AbstractExtensionRequest.serialVersionUID
  • This method was wrongly exposed as protected and was exposing the Event class which is a private class and thus the method couldn't be used as protected anyway
    • Violation type: java.method.visibilityReduced
    • Old: method void org.xwiki.rendering.wikimodel.xhtml.filter.XHTMLWhitespaceXMLFilter::appendInlineEvent(org.xwiki.rendering.wikimodel.xhtml.filter.XHTMLWhitespaceXMLFilter.Event) throws org.xml.sax.SAXException
    • New: method void org.xwiki.rendering.wikimodel.xhtml.filter.XHTMLWhitespaceXMLFilter::appendInlineEvent(org.xwiki.rendering.wikimodel.xhtml.filter.XHTMLWhitespaceXMLFilter.Event) throws org.xml.sax.SAXException
  • This method was wrongly exposed as protected and was exposing the Event class which is a private class and thus the method couldn't be used as protected anyway
    • Violation type: java.method.visibilityReduced
    • Old: method void org.xwiki.rendering.wikimodel.xhtml.filter.XHTMLWhitespaceXMLFilter::sendInlineEvent(org.xwiki.rendering.wikimodel.xhtml.filter.XHTMLWhitespaceXMLFilter.Event) throws org.xml.sax.SAXException
    • New: method void org.xwiki.rendering.wikimodel.xhtml.filter.XHTMLWhitespaceXMLFilter::sendInlineEvent(org.xwiki.rendering.wikimodel.xhtml.filter.XHTMLWhitespaceXMLFilter.Event) throws org.xml.sax.SAXException
  • Not a breakage from REST API point of view
    • Violation type: java.annotation.removed
    • Old: field org.xwiki.rest.model.jaxb.JobStatus.id
    • New: field org.xwiki.rest.model.jaxb.JobStatus.id
  • Not a breakage from REST API point of view
    • Violation type: java.annotation.removed
    • Old: field org.xwiki.rest.model.jaxb.JobStatus.progress
    • New: field org.xwiki.rest.model.jaxb.JobStatus.progress
  • Not a breakage from REST API point of view
    • Violation type: java.annotation.attributeValueChanged
    • Old: class org.xwiki.rest.model.jaxb.JobStatus
    • New: class org.xwiki.rest.model.jaxb.JobStatus
  • Not a breakage from REST API point of view
    • Violation type: java.method.numberOfParametersChanged
    • Old: method org.xwiki.rest.model.jaxb.JobStatus org.xwiki.rest.resources.job.JobStatusResource::getJobStatus(java.lang.String) throws org.xwiki.rest.XWikiRestException
    • New: method org.xwiki.rest.model.jaxb.JobStatus org.xwiki.rest.resources.job.JobStatusResource::getJobStatus(java.lang.String, boolean, boolean, boolean, java.lang.String) throws org.xwiki.rest.XWikiRestException

Credits

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

  • Alexandru Cotiugă
  • Ecaterina Moraru (Valica)
  • Guillaume Delhumeau
  • Manuel Smeria
  • Marius Dumitru Florea
  • Raluca Stavro
  • Thomas Mortagne
  • Vincent Massol
Tags:
Created by Marius Dumitru Florea on 2017/03/02
   

Get Connected