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.

<insert description of release here>

New and Noteworthy (since XWiki <version - 1>)

Full list of issues fixed and Dashboard for <version>.

Flamingo

The "More Options" menu has been split and a new "Page Administration" menu has been introduced:

Breadcrumb

When the hierarchy of a Nested Pages is long, we do not display it entirely anymore. Instead, we display a limited version, that the user can expand by clicking on the "ellipsis" character ('...'):

• limited:

    

• full:

    

Note that this behavior have also been added to all hierarchy breadcrumbs, including location of search results, etc...

Page Index

Since we have introduced the concept of Nested Spaces we needed to replace the Space column in the LiveTable with a more generic solution. Thus, the Index Application has now merged the previous Page + Space columns into a single Location column and we've introduced new column (which is still called Page) but which now displays the title of pages, as can be seen on the following screenshot:

The same strategy is implemented for the children and the siblings viewers.

Note that you can filter at several path levels in the Location column. For example:

New Panels

• A Children Panel has been added to display the list of Children pages of the current Page.

  

• A Siblings Panel has been added to display the list of Sibling pages of the current Page.

  

• The SpaceDocs Panel has been deprecated and the Children Panel or Siblings Panel should be used instead. A warning message has been added (visible only to Admins) to explain this:

  

Miscellaneous

• The Active Installs Client module had a bug leading to the sinceDays field not being set correctly (was almost always set to 0).

See the full list of JIRA issues fixed in this release.

For Developers

Flamingo

The content menus are now implemented with UI extensions. The new Extension Points are:

The extension point DrawerItem has now a parameter separator to add a line separator before the drawer item.

Extensions repository improvements

New extension are now create in their own space by default (as the space how page). It will make easier to organize documentation of big extensions.

Deprecated and Retired projects

<description of deprecated and retired projects>

Upgrades

The following dependencies have been upgraded:

• Jackson 2.6.3
• LiveValidation 1.4

Miscellaneous

• a displayTitle option has been added to the hierarchy macros. By default, it is set to true. When disabled, the names of the references are displayed in the breadcrumb, instead of the document titles.
• custom extension repositories are now sent by the Extension Repository REST service

Translations

The following translations have been updated: 

• Language
• Language

Tested Browsers & Databases

Performances tests compared to <last super stable version>

<a summary of the comparison with latest super stable version>

More details on <link to the test report>.

Known issues

• Bugs we know about

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.

Issues specific to XWiki <version>

<issues specific to the project>

API Breakages

The following APIs were modified since <project> <version - 1>: