Release Notes for XWiki 7.2 Milestone 3

Version 59.1 by Thomas Mortagne on 2015/09/01

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 7.2M2)

Full list of issues fixed and Dashboard for 7.2.


Following the introduction of the Nested Documents feature, we have changed a lot our default Flamingo skin:

  • The top menu has been removed and replaced by a drawer menu that you can expand by clicking on the top right icon
  • The add menu has been relocated near the edit one
  • The L&F of the Add, Edit, and "More Actions" menus has been changed
  • A lot of actions have been moved to the "More Actions" menu
  • The Breadcrumb is now also displayed for the home page
  • The Breadcrumb now also displays the home page (instead of hiding it as it used to) if it is part of the current document's hierarchy. See XWIKI-12423 for more details.
  • The actions menus (edit, create, more actions) are now available from the rename, copy and delete actions.
  • The delete action proposes to delete the children of the document.

LDAP improvements

It's now possible to disable subgroups resolution using xwiki.authentication.ldap.group_sync_resolve_subgroups property in xwiki.cfg configuration file. Resolving each member to check if it's a group might be very expensive with big groups so if you know there is no subgroup you should really disable it.


  • The Navigation panel displays nested documents:


  • When renaming or copying a nested document the document title is updated to reflect the new document name if its previous value was equal the old document name. This was happening already for terminal documents. We extended the behaviour to nested documents.
  • Fixed various issues for the WatchList application which should now work well with Nested Spaces
  • The Administration mode for spaces and wikis now uses the standard reference-based breadcrumbs instead of the previously custom section-based breadcrumbs.


  • The Administration mode no longer features a select input on the right side for navigation between spaces since that input does no longer scale in the context of Nested Spaces. Thus, the breadcrumbs should be used instead and the future UI improvements that will soon become available in this direction.
  • It's now possible to create Skins in Nested Spaces.
  • Changed the exception message displayed when a script execution fails due to lack of rights to make it clearer that it's not a problem with the current user, but with the script.

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

For Developers


2 new resources have been exposed to the REST API:

REST script services

The Script service changed a bit, url(EntityReference) now return relative URL String by default and a new url(EntityReference reference, boolean external) has been added to force returning an external form URL. See Generate a REST URL for a resource for more details.

Deprecated and Retired projects

<description of deprecated and retired projects>


The following dependencies have been upgraded:


  • You can now reuse the velocity hierarchy macros defined in the Flamingo Skin's hierarchy_macros.vm template to display the breadcrumbs for a particular document. See XWIKI-12408.
  • You can see the children and backlinks of any document with the new parameters ?xpage=children and ?xpage=backlinks to add to the document URL. To get the children according to the parent/child mechanism, you can use ?xpage=children&hierarchy=parentchild.
  • In JavaScript, the class XWiki.Document has been modified to handle nested spaces. A new constructor have been created, and the old one is deprecated.


The following translations have been updated: 

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

Backward Compatibility and Migration Notes

General Notes

When upgrading make sure you compare your xwiki.cfg, and web.xml files with the newest version since some configuration parameters may have been modified or added. Note that you should add 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>:

<clirr output here>

Get Connected