Release Notes for XWiki 6.2 Milestone 2

Version 24.1 by Guillaume Delhumeau on 2014/08/19
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.2M1)

Full list of issues fixed and Dashboard for 6.2.


  • Flamingo is the new default skin in XWiki!
  • The applications panel (also known as the "Applications Bar") has been set by default on the left panel.
  • The default icon theme is now Font Awesome.
  • A new application has been made to manage color themes on Flamingo. It does not only permit to change colors anymore, but also the typography, etc... That is why it is called Flamingo Theme Application.
  • By default, a new theme is enabled: FlamingoDefaultTheme, made with the new application described above.
  • Colibri Skin can use the themes from Flamingo thanks to a mapping between Flamingo Theme Application and Color Theme Application. The results may not be perfect though.
  • Improved Login form


You can see the results of all this changes in the following screenshot:


  • ModalPopup and LightBox resource components are now responsive. For small resolutions their width will occupy the whole screen.

    afterAddUsers.png afterSharebyEmail.png 

  • Deleted document translations can now be restored, even if the main document or a different translation has already been restored (as long as no conflict exists). See XWIKI-9567 and the documentation.

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

For Developers

Blame generic API and Script Service

Provides the implementation of the blame/annotate/praise algorithm.

Like the diff module API, this API is not tied to any type so you have to first transform the datas you want to blame into lists and you will be able to link them with any kind of revision metadata. Blame will link each elements of the initial list with the revision metadata of the original revision it came from. You will have to call blame in loop with each revised list, starting from the most recent one, until all element are annotated.

See Blame Module for more information.

Deprecated and Retired projects

<description of deprecated and retired projects>


The following dependencies have been upgraded:


  • New $cookietool available for working with cookies in Velocity. See XCOMMONS-627
  • New $doc.isTranslation() method is available in the web API. See XWIKI-10805
  • xwiki-platform-font-awesome has been moved in the xwiki-platform-icon module and renamed xwiki-platform-icon-font-awesome.
  • Icon Theme can now use JavaScript Extensions.
  • The Icon class of the Icon Theme does not store the name of the icon anymore, since it is already stored in a map in the IconSet class (better memory usage).


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.ManualTestReportXWiki62M2Summary]. 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:

Chrome30.pngGoogle Chrome 36Not Tested
Chrome30.pngGoogle Chrome 37Smoke testing
Firefox30.pngMozilla Firefox 31Jira Tickets Marked as Fixed in the Release Notes
IE30.pngInternet Explorer 8Not Tested
IE30.pngInternet Explorer 9Not Tested
IE30.pngInternet Explorer 10Full Tested

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

hypersql.pngHyperSQL 2.3.2Jira Tickets Marked as Fixed in the Release Notes Full Tested
mysql.pngMySQL 5.6.17Not Tested
oracle.pngOracle 11.2Not Tested
postgresql.pngPostgreSQL 9.3.4Not Tested

For the full list of tests see this page.

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