Release Notes for XWiki 7.2 Milestone 3

Version 74.2 by Vincent Massol on 2015/09/02

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 milestone release brings more changes to the Flamingo Skin in order to support Nested Documents. The top menu has been replaced by a drawer and the create, copy, rename and delete page actions have been revamped. This release also fixes some Watch List issues related to Nested Documents and provides a new configuration option for the LDAP module. The developers should check out the new job-related REST resources and the support for skins in Nested Spaces.

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 page breadcrumb has suffered some changes:
    • it is now also displayed on the wiki home page
    • the wiki home page is now included when it is part of the current document's hierarchy, i.e. for children and descendants of the wiki home page. See XWIKI-12423 for more details.
    • the sub-wiki pretty name is included between the home icon and the local page path
  • The actions menus (edit, create, more actions) are now available from the rename, copy and delete actions.
  • The create, copy and rename page actions have been modified to support nested documents:
    • The source and target documents are displayed using the breadcrumb
    • The target document can be selected using a document tree picker
    • For advanced users there is also the option to specify the target document using some text input fields (location advanced edit mode). This is useful especially if you want to create/move the page under a parent that doesn't exist yet (you cannot use the tree picker in this case because the parent would not be available in the tree).
  • 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 several applications bundled in XE (such as WatchList and Annotations), 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.


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

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.

API Breakages

The following APIs were modified since XWiki 7.1.2:

  • New configuration option to change the size of the Job statuses cache:
    org.xwiki.job.JobManagerConfiguration: Method 'public int getJobStatusCacheSize()' has been added to an interface
  • Added missing methods to the DocumentModelBridge class, which are already implemented by XWikiDocument;
    org.xwiki.bridge.DocumentModelBridge: Method 'public org.xwiki.model.reference.DocumentReference getContentAuthorReference()' has been added to an interface

Get Connected