Release Notes for XWiki Enterprise 3.2.1

Last modified by Thomas Mortagne on 2017/03/24

This is the first (and probably last) bugfix release for the 3.2 series. No new features are introduced in this version. One important change is the way relative references in an included document are resolved, reverting back to the pre-3.0 behavior. See below for more details. Other areas with several bugfixes are support for Oracle databases, the rending engine, the WYSIWYG editor, and the Activity Stream.


  • XCOMMONS-67 - DefaultExecutionContextManager#clone can corrupt current ExecutionContext if an initializer fail
  • XRENDERING-159 - Add support for HTTPS and other URL schemes for image attachments in XWiki Syntax 2.0
  • XRENDERING-161 - Rendering Blocks are taking a lot more space than they should in memory
  • XRENDERING-163 - SpaceBlock#clone does not clone anything
  • XRENDERING-171 - Introducing new metadata in to indicate the base reference to use to resolve references
  • XWIKI-6368 - Exception "inconsistent datatypes" on VisitStats in Oracle 10g
  • XWIKI-7028 - Strange behaviour when pressing back and forward on a page that has 2 WYSIWYG editors displayed
  • XWIKI-7045 - Property names in GroupsClass, LevelsClass and UsersClass are not set when new properties are created, which may cause upgrade failure
  • XWIKI-7055 - JavaScript error  related to Autosave when editing in Wiki mode
  • XWIKI-7064 - Concurrence issue with LDAP user membership synchronization
  • XWIKI-7074 - Activity stream event stream bridge does not honor limit and offset of passed query
  • XWIKI-7086 - Pressing enter at the end of a paragraph/section doesn't create a new line
  • XWIKI-7109 - XWiki.XWikiPreferences is re-saved on each restart
  • XWIKI-7121 - WYSIWYG Editor administration section doesn't save changes
  • XWIKI-7160 - Characters '<' and '>' are badly displayed in page title
  • XWIKI-7189 - URLs created by mailsender plugin called from a scheduler script can have a wrong context path
  • XWIKI-7224 - XWikiPreferences in view mode does no not redirect to admin mode
  • XWIKI-7254 - Invalid mapping with Oracle 11g and Hibernate 3.6
  • XWIKI-7278 - Virtual mode fails on Oracle with "ORA-01435: user does not exist"
  • XWIKI-7294 - Loss of all programming rights until system is restarted
  • XWIKI-7360 - Invalid "see changes" link in multiwiki mode for Activity stream event
  • XWIKI-7382 - Include macro with context=current should resolve reference based on current document instead of source document
  • XE-1048 - Comments Macro is not bundled in XWiki Enterprise

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

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

Issues specific to XWiki Enterprise 3.2.1

XWIKI-7382: The behavior of the {{include}} macro has changed back to the pre-3.0 behavior. Now relative links in a document {{include}}d with context="current" are resolved relative to the including document, not relative to the included one.

API Breakages

No APIs were broken since XWiki Enterprise 3.2. You can see the list of broken APIs since 3.1 in the XWiki Enterprise 3.2 release notes.


Get Connected