Release Notes for XWiki Enterprise 4.0 Milestone 2

Version 10.2 by Eduard Moraru on 2012/04/03

Before 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

TODO

User profile customization

TODO

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

annotations-merged-with-comments-screenshot.png

New Velocity tool to serialize Java objects to JSON format

TODO

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.

ColorThemeWizard.png

Bug fixes and improvements

TODO

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

For Developers

TODO

Upgrades

The following dependencies have been upgraded:

  • Json-lib 2.4

TODO

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

Firefox
10.0.1
Chrome
17

TODO

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

If you're running in a multiwiki setup you'll also need to define the property xwiki.store.migration.databases in your xwiki.cfg file if you want to explicitly name some databases to be migrated as the default is now to migrate all databases. Database that are not migrated could not be accessed.

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 xwiki.properties files with the newest version since some configuration parameters were added. Note that you should add xwiki.store.migration=1 so that XWiki will attempt to automatically migrate your current database to the new schema. Make sure you backup your Database before doing anything.

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:

TODO

Tags:
   

Get Connected