WarningBefore upgrading to this version, be sure to have a working backup of your database(s).

This is the secondd and last milestone of the XWiki Enterprise 4.0 version (Roadmap). 

New and Noteworthy (since XWiki Enterprise 4.0 Milestone 2 version)

Extension Manager improvements

Annotations merged with Comments by default

Starting with version 4.0M2, annotations have been merged by default with comments. More specifically, this means:

• You can now reply to an annotation (threaded annotations)
• The Annotations tab is now replaced by the Comments tab where you can see both annotations and comments
• The default annotation class is now XWiki.XWikiComments instead of AnnotationCode.AnnotationClass

User profile customization

An admin can now configure which information is displayed in the user profile (the "Profile" tab of a user's profile page). A new section has been added in Administration where an admin can configure which fields of the XWikiUsers class to display. The admin still has to add the new fields to the class the old way, using the class editor for the page XWiki.XWikiUsers, but he no longer needs to write any code.

User directory improvements and user customized view

The UserDirectory can now display, as columns, filterable and sortable properties of users, as opposed to the previous version where you just had a fixed column that displayed a composed name in the form "first_name last_name (profilePageID)".

In addition, each user can now customize his view over the UserDirectory by adding or removing columns, or resetting to default.

The default displayed columns are "first_name" and "last_name", and the unmodifiable columns (that will always be displayed as first columns) are "_avatar" and "doc.fullName".

New Velocity tool to serialize Java objects to JSON format

ColorThemes gradients customizable from ColorTheme Wizard

In version 3.4 we deprecated the old default bundled ColorThemes (because of incompatible variable mix). In version 4.0 this is no longer the case, old default bundled ColorThemes (like Bordo, Nature, etc.) are now being compatible with the 3.4 Colibri Skin changes. We fixed this by adding new gradient ColorThemes variables. All these gradient ColorTheme variables are now changeble from the ColorTheme Wizard.

Bug fixes and improvements

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

For Developers

Upgrades

The following dependencies have been upgraded:

• Json-lib 2.4

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):

{{browser name='firefox' version= '11.0/}}

Chrome

18

Known issues

• Bugs we know about

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.

Annotations Application

If you were/are using a custom annotations class, other than the previously default AnnotationsCode.AnnotationsClass, in the annotations configuration then the merging-with-comments feature will not be available to you. What you can do is to enable back the Annotations tab by going to the Administration > Look and Feel > Page Elements and changing the value of "Show document annotations " from "No" to "Yes". Now you will still be able to use your custom annotations without being affected by the changes.

Also, a migration script will automatically convert all your existing default annotations (that are using the default AnnotationCode.AnnotationClass) to the new default class (XWiki.XWikiComments). After the migration, the new database version will be 40001.

API Breakages

The following APIs were modified since version 3.5: