Release Notes for XWiki 6.4-milestone-2

Version 22.1 by Vincent Massol on 2014/12/18
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.4-milestone-1)

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

Menu Application

Taking advantage of the ability to have LESS inside our StyleSheetExtensions, we improved the Menu Application, on Flamingo based skins, making it responsive and also adapting its styling according to the active Flamingo Theme.
Colibri based skins preserve the initial styling. 

Mail Feature

  • The mail feature has a new Category in the Admin UI (see the Mail Application for details).

    {{image reference="emailcategory.png}}

  • There's now the possibility to configure default BCC addresses which will be added by default to all emails sent using the Mail Sender API.


  • The Mail Sender API now checks for permission before sending emails, when using it from scripts (i.e. when using the Mail Sender Script Service). There are currently 2 possible strategies that you configure in your file
    #-# [Since 6.4M2]
    #-# Defines which authorization checks are done when sending mails using the Mail Sender Script Service.
    #-# Example of valid values:
    #-# - "programmingrights": the current document must have Programming Rights
    #-# - "alwaysallow": no check is performed. This is useful when running XWiki in a secure environment where we
    #-#   want to allow all users to be able to send emails through the Script Service.
    #-# The default is:
    # mail.sender.scriptServiceCheckerHint = programmingrights


  • A list of icons supported by XWiki have been created, with mapping for Silk and Font Awesome. Which means that we now propose a list of icons that are both present in Silk and Font Awesome.
  • The list off columns in the UserDirectory customization screen is now sorted alphabetically

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

For Developers

Mail Sender Permissions

There's now a pluggable permission checker used for checking if a mail should be sent, when using the Mail Sender Script Service. Two implementations are provided (see above) but you can also provide your own implementation by implementing the org.xwiki.mail.script.ScriptServicePermissionChecker component role:

public interface ScriptServicePermissionChecker
     * @param message the message to check for authorization
     * @exception MessagingException if the message is not allowed to be sent

   void check(MimeMessage message) throws MessagingException;

For example you could imagine implementing checks on the size of the email or who the recipients are, run the content of the mail through some filter, etc.

Icon Picker

An icon picker has been created to help users selecting an image in the list of supported icons.


This picker is already used in Application Within Minutes for the application's icon selection.

Skin Extensions

Now you can use LESS in your Skin Extensions!. You just need to set the new property "Content Type" to LESS inside your Skin Extension object:


Deprecated and Retired projects

<description of deprecated and retired projects>


The following dependencies have been upgraded:


  • It's now possible to know what namespace a ComponentManager instance is associated with by casting it to  org.xwiki.component.manager.NamespacedComponentManager. See Component Module documentation.
  • Added getCurrentWikiDescriptor() method to the wiki API and script service to be consistent with the existing getCurrentWikiId() method
  • The ClassLoader automatically set as Thread ClassLoader is now dynamic meaning that any modification of the context wiki will automatically change the actual Thread ClassLoader. It used to be set to whatever was the wiki in the URL at ExecutionContext init.


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.ManualTestReportSummaryXWiki64M2]. 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 39Not Tested
Firefox30.pngMozilla Firefox 34Not Tested
IE30.pngInternet Explorer 8Not Tested
IE30.pngInternet Explorer 9Not Tested
IE30.pngInternet Explorer 11 Jira Tickets Marked as Fixed in the Release Notes

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.2Not Tested
postgresql.pngPostgreSQL 9.3.4 Jira Tickets Marked as Fixed in the Release Notes

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

<issues specific to the project>

API Breakages

The following APIs were modified since <project> <version - 1>:

<clirr output here>

Get Connected