ReleaseNotesXWikiEnterprise20M1

Last modified by Thomas Mortagne on 2017/03/24

ContentsThe [toc] macro is a standalone macro and it cannot be used inline. 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 Info, Warning and Error macro documentation.

New Search Interface

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

newsearchui.png

New Tag Cloud Panel

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

tagcloudpanel.png

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**")
$var
{{/velocity}}

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 velocity.tools and velocity.properties parameters in xwiki.properties.

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 xwiki.store.migration.databases=all to your xwiki.cfg file or explicitly name all databases to be migrated as in xwiki.store.migration.databases=db1,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 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.

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
    • Details:\
[ERROR] org.xwiki.rendering.block.AbstractBlock: Method 'public void replace(java.util.List)' has been removed
[ERROR] org.xwiki.rendering.block.Block: Method 'public void replace(java.util.List)' has been removed
[ERROR] org.xwiki.rendering.block.Block: Method 'public void replaceChild(org.xwiki.rendering.block.Block, org.xwiki.rendering.block.Block)' has been added to an interface
[ERROR] org.xwiki.rendering.block.Block: Method 'public void replaceChild(java.util.List, org.xwiki.rendering.block.Block)' has been added to an interface
[ERROR] org.xwiki.rendering.parser.ParseException: Parameter 2 of 'public ParseException(java.lang.String, java.lang.Exception)' has changed its type to java.lang.Throwable
[ERROR] org.xwiki.rendering.parser.ParseException: Method 'public ParseException(java.lang.Exception)' has been removed
[ERROR] org.xwiki.rendering.parser.ParseException: Method 'public ParseException(java.lang.Exception, java.lang.String, int)' has been removed
[ERROR] org.xwiki.rendering.parser.ParseException: Method 'public ParseException(java.lang.Exception, java.lang.String, java.lang.String, int)' has been removed
[ERROR] org.xwiki.rendering.parser.ParseException: Method 'public java.lang.String getFileName()' has been removed
[ERROR] org.xwiki.rendering.parser.ParseException: Method 'public int getLineNumber()' has been removed
[ERROR] org.xwiki.rendering.renderer.xhtml.XWikiXHTMLImageRenderer: Class org.xwiki.rendering.renderer.xhtml.XWikiXHTMLImageRenderer removed
[ERROR] org.xwiki.rendering.renderer.xhtml.XWikiXHTMLLinkRenderer: Class org.xwiki.rendering.renderer.xhtml.XWikiXHTMLLinkRenderer removed
[ERROR] org.xwiki.rendering.renderer.XHTMLRenderer: Method 'public XHTMLRenderer(org.xwiki.rendering.renderer.printer.WikiPrinter)' has been removed
[ERROR] org.xwiki.rendering.renderer.xhtml.SimpleXHTMLImageRenderer: Class org.xwiki.rendering.renderer.xhtml.SimpleXHTMLImageRenderer removed
[ERROR] org.xwiki.rendering.renderer.xhtml.SimpleXHTMLLinkRenderer: Class org.xwiki.rendering.renderer.xhtml.SimpleXHTMLLinkRenderer removed

Get Connected