Release Notes for XWiki 7.2 Release Candidate 1

Version 47.1 by Marius Dumitru Florea on 2015/09/16

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.2M3)

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


Following the introduction of the Nested Documents feature, we have made some modifications to the Flamingo skin:

  • For non terminal documents, we have introduced a "Page Administration", where you will find settings that concern the document and its children (it's actually the old space administration behind the scene). But we have also introduced 2 sections for setting rights on these pages:
    • a section to set rights for the document only.
    • a section to set rights for the document and its children.
  • For terminal documents, nothing changes, you can change the access rights of the page in the "edit" menu. The only addition is a "Administer Parent" link in the "More actions" menu to administer the parent page (which again is the space administration behind the scene).
  • The create action has been relooked (with the introduction of the "page type" field) and proposes to import an office document.
  • A new "children" viewer is now accessible in the "more actions" menu, along with the other viewers.
  • For Terminal Pages, a new "siblings" viewer is present, which replaces the old "space index" feature.

Solr Search

You can now search for nested documents using the Solr Search Application. The display of the search result location has been updated to support nested documents.


The "Space" facet has been replaced with a "Location" facet that supports nested documents. This allows you to search in a specific location in the page hierarchy.


The "Page" facet has been removed by default because it doesn't bring value in the context of the nested documents: all non-terminal documents have the same name 'WebHome'. The "Wiki" facet is displayed by default only on the main wiki and only if you have multiple wikis.


  • When creating, copying or renaming a page you can now select a top level location from the tree picker (e.g. copy as top level page) even if you have a single wiki (i.e. only the main wiki). You do this by selecting the root of the tree (i.e. the wiki node).
  • The Document Tree Macro is now displaying a message when the tree is empty.


    With the new showRoot parameter you can force the document tree to show the actual root node (either the one specified by the root parameter or the default root node).

  • A couple of bugs in the App Within Minutes Application, that were caused by the introduction of the Nested Documents feature, have been fixed.
  • It's now possible create new FAQs in Nested Spaces.
  • When using the XWiki Jetty distribution, a memory dump is automatically created in XWiki's data/ folder when an Out Of Memory error occurs.
  • The Activity Stream now also displays activity for Nested Spaces.
  • Skin editor now properly works for a nested skin document

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

For Developers

XWiki Select Widget

A new widget has been introduced, to have a rich select box:


Deprecated and Retired projects

<description of deprecated and retired projects>


The following dependencies have been upgraded:


  • The URL parameters ?viewer=children and ?viewer=backlinks have been added.
  • A new "siblings" viewer has been added, accessible both with ?viewer=siblings and ?xpage=siblings.
  • For ?viewer=children, ?xpage=children, ?viewer=siblings and ?xpage=siblings a new displayHidden parameter has been added. By default, the hidden documents are not displayed unless the user's configuration overwrites this.


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.

Issues specific to XWiki <version>

<issues specific to the project>

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
  • AbstractWrappingObject, AbstractSafeObject and ScriptSafeProvider have been moved to xwiki-commons-script:
    org.xwiki.extension.wrap.WrappingIterableResult: Removed from the list of superclasses
    org.xwiki.extension.wrap.WrappingIterableResult: Removed org.xwiki.extension.wrap.AbstractWrappingObject from the list of superclasses
    org.xwiki.extension.wrap.WrappingIterableResult: Parameter 2 of 'public WrappingIterableResult(org.xwiki.extension.repository.result.IterableResult,' has changed its type to
    org.xwiki.filter.script.AbstractFilterScriptService: Changed type of field scriptProvider from to
    org.xwiki.extension.script.AbstractExtensionScriptService: Changed type of field scriptProvider from to
  • com.xpn.xwiki.XWiki#localStringEntityReferenceSerializer now exists in oldcore, we do not need it in the aspect anymore:
    com.xpn.xwiki.XWikiCompatibilityAspect: Method 'public org.xwiki.model.reference.EntityReferenceSerializer ajc$interFieldGetDispatch$com_xpn_xwiki_XWikiCompatibilityAspect$com_xpn_xwiki_XWiki$localStringEntityReferenceSerializer(com.xpn.xwiki.XWiki)' has been removed
    com.xpn.xwiki.XWikiCompatibilityAspect: Method 'public void ajc$interFieldInit$com_xpn_xwiki_XWikiCompatibilityAspect$com_xpn_xwiki_XWiki$localStringEntityReferenceSerializer(com.xpn.xwiki.XWiki)' has been removed
    com.xpn.xwiki.XWikiCompatibilityAspect: Method 'public void ajc$interFieldSetDispatch$com_xpn_xwiki_XWikiCompatibilityAspect$com_xpn_xwiki_XWiki$localStringEntityReferenceSerializer(com.xpn.xwiki.XWiki, org.xwiki.model.reference.EntityReferenceSerializer)' has been removed
  • Not a breakage. The legacy method was not in the right place (which mean that it was not available so it actually fix a breakage):
    com.xpn.xwiki.XWikiCompatibilityAspect: Method 'public java.lang.Object getRenderingEngine()' has been removed
  • Young API. ExportURLFactoryContext been renamed to FilesystemExportContext and moved to the Filesystem URL scheme module

Get Connected