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

The highlights of this release are:

New and Noteworthy (since XWiki Enterprise 2.4)

Added mechanism for inserting custom links in the header

 This allows to:

  • custom navigational links (unversal edit, paged navigation, index, author...)
  • custom RSS feed links
  • custom metadata links (DOAP, FOAF, generic RDF...)

$xwiki.linkx.use($xwiki.getURL('Blog.BlogRss', 'view', "xpage=plain&blog=${blogDoc.fullName}"),
  {'rel' : 'alternate', 'type':'application/rss+xml', 'title': "$title"})

Introduced cancelable events

  • cancel document saving
  • cancel script execution for: security reasons (e.g. nested scripts) and errors in initialization

Better external search engine indexing support

Google search results didn't always point to canonical view of pages.

Keep the content menu visible when scrolling down


When scrolling down on a document, the content menu will follow, so the user will not have to scroll up on top of the page in order to access it.

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 the improvements listed above.

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

Migration Notes

Removed deprecated flickr plugin

Removed the old flickr plugin because it was outdated and the API was broken. We will have a new one, re-written, in the future.
It can stil lbe found in contrib-retired. Here is the link.

  • The main entry point for the search UI is now the Main.Search page that will use the configured search engine (Lucene by default). If you want to refer to Lucene or Database search explicitly you can use the Main.LuceneSearch and Main.DatabaseSearch pages. Note that nothing is broken here (Main.WebSearch page is still there and internally it includes the Main.DatabaseSearch page), it's just the new clean way of targeting the search page.

API Breakages

The following APIs were modified since XWiki Enterprise 2.3:

[ERROR] org.xwiki.rendering.transformation.MacroTransformationContext: Method 'public org.xwiki.rendering.internal.transformation.MacroTransformation getMacroTransformation()' has been removed
[ERROR] org.xwiki.rendering.transformation.MacroTransformationContext: Method 'public void setMacroTransformation(org.xwiki.rendering.internal.transformation.MacroTransformation)' has been removed
[ERROR] org.xwiki.rendering.transformation.Transformation: Method 'public void transform(org.xwiki.rendering.block.Block, org.xwiki.rendering.transformation.TransformationContext)' has been added to an interface
[ERROR] org.xwiki.rendering.transformation.TransformationManager: Method 'public void performTransformations(org.xwiki.rendering.block.Block, org.xwiki.rendering.transformation.TransformationContext)' has been added to an interface

Get Connected