Release Notes for XWiki Enterprise 4.2 Milestone 3

Version 24.1 by Vincent Massol on 2012/09/10
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.

<insert description of release here>

New and Noteworthy (since XWiki Enterprise 4.2 Milestone 2)

Improved upload UI

The new HTML5 FileUploader has been integrated in a few places:

  • The standard attachment upload form
  • The Import section of the Administration

See below for more details about this feature.

New logging administration UI

It's now possible to review and modify the log level for all registered loggers.


IRC Bot Application Improvements

The IRC Bot Application now recognizes XAR import events and when receiving one, it doesn't send subsequent IRC notifications for modified or created documents to avoid spamming the IRC channel.

New Content Macro

The new Content macro allows to enter content in any of the supported Syntaxes and thus allows to have content written in various syntaxes. For example:

This is in **bold**

{{content syntax="confluence/1.0"}}
This is *bold* too!

Experimental install/upgrade wizard






  • Display the request URL in the IRC channel when the Link Checker bot listener is active and a broken link is found, thus making it easier to reproduce and debug the broken link
  • The Chart macro will now automatically default to the inline Data Source type when not specified and the Chart Macro has some content.

For Developers

New HTML5 File Upload widget

The File Upload widget can enhance HTML input elements of type file to provide an interactive upload UI. It can submit files either automatically when the user selects local files, or after the user presses the container form's submit button.

To use this widget, it is enough to create a new instance of XWiki.FileUploader passing the target input element as the first parameter, and an optional configuration object as the second parameter.

new XWiki.FileUploader(targetInput, {
  autoUpload: true,
  progressAutohide: true



It's now possible by default to add skin extensions located in JAR files. Example usage:


Documents Macro improvements

The {{documents}} macro now supports specifying the list of columns to display. For example:

{{documents count="5" actions="false" space="Main" parent="Main.WebHome" columns="doc.title"/}}

would display:


Attachment Picker improvements

It is now possible to specify a different document for the source (and target in case of uploads) of attachments, using the new targetdocname macro parameter.

Search improvements

The Lucene index also stores the MIME type of the indexed attachments, allowing to customize the search to only include or exclude attachments of a certain type. The new field is named mimetype and it contains a valid MIME type string, as returned by the container in which XWiki is running. For example, add -mimetype:image/* to a query to exclude all image attachments from the results, or add mimetype:application/pdf to only search inside PDF attachments.

Remember that in case of an upgrade, you have to rebuild the entire index to have this new field for existing documents.

Extension Manager improvements

  • the custom Maven property <xwiki.extension.features> now accept any number of new lines and white spaces between elements
  • new custom properties added to overwrite standard Maven properties:
    • to overwrite <name>
    • xwiki.extension.summary to overwrite <description>
    • to overwrite <url>

XAR format improvement

It's now possible to indicate the extension identifier right in the XAR package descriptor (package.xml). Among other things this allow standard import UI to find what it currently importing and register it automatically as installed extension if it can be found in the registered repositories during import process.

The XAR Maven plugin automatically take care of adding this information to the generated package.xml for Maven project. If for some reason you need to indicate it by hand you can use the property <extensionId> under the the <infos> element in the package.xml file.

   <name>XWiki Platform - Extension - UI</name>
   <description>XWiki Extension Manager, an application for managing extensions in a wiki.</description>

Deprecated and Retired projects

<description of deprecated and retired projects>


The following dependencies have been upgraded:

  • Prototype.js 1.7.1
  • Jython 2.5.3
  • Pegdown 1.1.0 (used by the XWiki Markdown Parser)
  • Xalan 2.7.1


  • The AbstractMockingComponentTestCase testing framework class has been modified. Read the Testing page for more details on how to use it.


The following translations have been updated: 

Tested Browsers

Here's the list of browsers tested with this version (i.e. browsers that we've tested as working - Check the list of supported browsers):

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


Known issues

Test Report

You can check the manual test report to learn about what was tested and the results on various browsers.

Backward Compatibility and Migration Notes

General Notes

You may also want to import the default wiki XAR in order to benefit from all the improvements listed above.

Always make sure you compare your xwiki.cfg and files with the newest version since some configuration parameters were 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 <projet> <version>

<issues specific to the project>

API Breakages

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

<clirr output here>

Get Connected