Release Notes for XWiki 6.3-rc-1

Version 54.1 by Marius Dumitru Florea on 2014/11/07
Warning: For security reasons, the document is displayed in restricted mode as it is not the current version. There may be differences and errors due to this.

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 6.3-milestone-2)

Full list of issues fixed and Dashboard for 6.3.

Flamingo Themes Application

Now, when you click on "Manage color theme" in the Administration, you reach the new application to manage the Flamingo Themes:


You can use it to change the current theme, modify any theme or create new ones.

We have also added 3 new themes: Marina, Garden and Kitty.

Bootswatch Themes for Flamingo

XWiki comes with 16 new themes for Flamingo, that have been adapted from Bootswatch.

Document Tree Macro

We introduce a new wiki macro to display the hierarchy of documents:

{{documentTree /}}


Document Index Tree

The new Document Tree Macro is now used in the Wiki document index.


Navigation Panel

We also changed the Navigation Panel to use the new Document Tree Macro.



  • Updated XAR export URL format to allow exporting a full space, a full wiki, or any list of pages matching a pattern. For example:
    See the full list of JIRA issues fixed in this release.
  • Added an edit button to easily change the default Welcome message that is displayed on the homepage. Users have reportedly been struggling with this task for a while now and, until we come up with a new format for the homepage, this is the solution we have proposed to make things easier.


  • The configuration of the Applications Panel now works with touch-screen devices too.
  • The Standalone Distribution now has a new startup parameter to enable monitoring/managing the Jetty instance. You can use it with -j (or --jmx).
  • Updated the notification message when the panel layout is saved to use the standard notification widget.

For Developers


  • Suggest widget now has an extra propagateEventKeyCodes option where key codes can be listed so their events will be propagated. See the documentation.
  • Extended modalPopup.js to support specifying keyboard shortcut options for the defined actions. See the documentation.
  • You can now render an icon from any icon theme present on the wiki, referenced by its name:
    $services.icon.render('globe', 'Silk')
    $services.icon.render('globe', 'Font Awesome')


The following dependencies have been upgraded:


The following translations have been updated: 

Tested Browsers & Databases

Failed to execute the [velocity] macro. Cause: [The execution of the [velocity] script macro is not allowed in [xwiki:TestReports.ManualTestReportSummaryXWiki63RC1]. Check the rights of its last author or the parameters if it's rendered from another script.]. Click on this message for details.

Here is the list of browsers we support and how they have been tested for this release:

BrowserTest Result
Chrome30.pngGoogle Chrome 38Jira Tickets
Firefox30.pngMozilla Firefox 33Not Tested
IE30.pngInternet Explorer 8Not Tested
IE30.pngInternet Explorer 9Not Tested

Here is the list of databases we support and how they have been tested for this release:

DatabaseTest Result
hypersql.pngHyperSQL 2.3.2Not Tested
mysql.pngMySQL 5.6.17Not Tested
oracle.pngOracle 11.2Jira Tickets
postgresql.pngPostgreSQL 9.3.4Not Tested

For the full list of tests see this page.

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 6.3-rc-1

  • Wiki page does not have access anymore to Velocity macro defined in the skin template (except for macro.vm template).

API Breakages

The following APIs were modified since XWiki 6.2.3:

  • Add issue management and SCM information to extension descriptors. Should be safe enough since most repository handlers extend AbstractExtension instead of directly implementing Extension.
org.xwiki.extension.Extension: Method 'public org.xwiki.extension.ExtensionIssueManagement getIssueManagement()' has been added to an interface
org.xwiki.extension.Extension: Method 'public org.xwiki.extension.ExtensionScm getScm()' has been added to an interface
  • serializeReference method has never been public. AspectJ hacks...
com.xpn.xwiki.doc.XWikiDocument: Method 'public java.lang.String ajc$privMethod$com_xpn_xwiki_doc_XWikiDocumentCompatibilityAspect$com_xpn_xwiki_doc_XWikiDocument$serializeReference(org.xwiki.model.reference.DocumentReference, org.xwiki.model.reference.EntityReferenceSerializer, org.xwiki.model.reference.DocumentReference)' has been removed
  • Never really been supposed to be exposed as an API
com.xpn.xwiki.objects.BaseElement: Accessibility of field localEntityReferenceSerializer has been weakened from protected to private
  • Added new methods to the unstable Icon Module
org.xwiki.icon.IconManager: Method 'public java.lang.String render(java.lang.String, java.lang.String)' has been added to an interface
org.xwiki.icon.IconManager: Method 'public java.lang.String render(java.lang.String, java.lang.String, boolean)' has been added to an interface
org.xwiki.icon.IconManager: Method 'public java.lang.String renderHTML(java.lang.String, java.lang.String)' has been added to an interface
org.xwiki.icon.IconManager: Method 'public java.lang.String renderHTML(java.lang.String, java.lang.String, boolean)' has been added to an interface
org.xwiki.icon.IconSetCache: Method 'public void clear(java.lang.String, java.lang.String)' has been added to an interface
org.xwiki.icon.IconSetCache: Method 'public org.xwiki.icon.IconSet get(java.lang.String, java.lang.String)' has been added to an interface
org.xwiki.icon.IconSetCache: Method 'public void put(java.lang.String, java.lang.String, org.xwiki.icon.IconSet)' has been added to an interface
org.xwiki.icon.IconSetManager: Method 'public org.xwiki.icon.IconSet getIconSet(java.lang.String)' has been added to an interface

Get Connected