Version 16.1 by Asiri Rathnayake on 2009/06/26
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.

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

Release Notes for XWiki Enterprise 2.0 Milestone 1

First milestone of the XWiki Enterprise 2.0 version (Roadmap).

New and Noteworthy (since XWiki Enterprise 1.9)

At a glance (see below for details):

  • Lots of improvements and new features in the new WYSIWYG editor
  • Lots of improvements and bugfixes in the rendering engine and the syntax converter
  • Lots of improvements and bugfixes in the 1.0 to 2.0 syntax converter
  • New Chart macro for XWiki 2.0 syntax
  • New info, warning and error macros
  • Improvements for the blog application

New Chart macro for XWiki 2.0 syntax

See Chart macro documentation.

New info, warning and error macros

See Message macro documentation.

New Search Interface

The default search page UI has been improved to be easier to understand and use.


New Tag Cloud Panel

A panels containing the tag cloud is now provided by default and can be used like any other panel.


New "wiki" parameter for all script macros

It's now possible to not parse velocity macro content for wiki syntax by using the wiki="false" parameter. For example:


{{velocity wiki="false"}}
#set($var = "**not bold**")

\ \

will render


**not bold**

\ \

New events for XWiki startup/shutdown

It's now possible for a component or a plugin to register to startup or shutdown events. It's very useful when some plugin need to start and stop an external service.

Velocity tools and Velocity properties can be easily changed

See and parameters in

Known issues

Backward Compatibility and Migration Notes

General Notes

If you're running in a multiwiki setup you'll also need to define the property to your xwiki.cfg file or explicitly name all databases to be migrated as in,db2,....

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

Always make sure you compare your xwiki.cfg file with the newest version since some configuration parameters were added. Of note, 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.

Velocity macro cleaning

We changed the default filter for the Velcity macro. The new one only remove indentation white space and does not touch new lines or other white spaces anymore. The former one can still be used by putting

{{velocity filter="html"}}{{/velocity}}

\ \

API Breakages

The following APIs were modified since XWiki Enterprise 1.9:

  • Rendering Module
    • Block.replace() has been replaced by Block.replaceChild()
    • ParseException constructor and methods have been modified since they were unused
    • XWikiXHTMLImageRenderer and XWikiXHTMLLinkRenderer classes have been moved to a XWiki-specific module so that the main Rendering module can be used standalone
    • Merged SimpleXHTMLImageRenderer and XWikiXHTMLImageRenderer into DefaultXHTMLImageRenderer which now handles the case where we're inside a wiki or not
    • Merged SimpleXHTMLLinkRenderer and XWikiXHTMLLinkRenderer into DefaultXHTMLLinkRenderer which now handles the case where we're inside a wiki or not

Get Connected