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>.

Flamingo

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.

Miscellaneous

• 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).

• 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>

Upgrades

The following dependencies have been upgraded:

• JGroups 3.6.6
• httpcore 4.4.3
• Infinispan 7.2.5

Miscellaneous

• 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.

Translations

The following translations have been updated: 

• Language
• Language

Tested Browsers & Databases

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 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 org.xwiki.extension.internal.safe.AbstractSafeObject 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, org.xwiki.extension.internal.safe.ScriptSafeProvider)' has changed its type to org.xwiki.script.internal.safe.ScriptSafeProvider
  org.xwiki.filter.script.AbstractFilterScriptService: Changed type of field scriptProvider from org.xwiki.extension.internal.safe.ScriptSafeProvider to org.xwiki.script.internal.safe.ScriptSafeProvider
  org.xwiki.extension.script.AbstractExtensionScriptService: Changed type of field scriptProvider from org.xwiki.extension.internal.safe.ScriptSafeProvider to org.xwiki.script.internal.safe.ScriptSafeProvider

• 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