Release Notes for XWiki Enterprise 3.5.1

Last modified by Thomas Mortagne on 2017/03/24

This is the first bugfix release for the 3.5 series, and, since 3.5 is the final major release in the 3.x cycle, a bugfix release for the whole 3.x cycle. The main focus has been on quality assurance, improving the compatibility with various database systems, polishing the new sheet mechanism, the new extension manager, the skin, the WYSIWYG, and other parts of the XWiki platform.

New and Noteworthy (since 3.5)

Database compatibility improvements

In XWiki 3.2 we upgraded to a new version of Hibernate and polished our mapping files, for improved performance and better consistency across different RDBMSs. However, this wasn't properly tested and caused upgrade problems when using Oracle or PostgreSQL. This release remedies the situation, and 3.5.1 has been fully tested both with new installations and with upgrades on all the supported databases.

  • XWIKI-7539 - Hibernate versioning broken with non-ascii characters when using a PostgreSQL database
  • XWIKI-7564 - Upgrade from a version before 3.3 fails when running on a PostgreSQL database
  • XWIKI-7644 - Add support for PostgreSQL as a known DatabaseProduct
  • XWIKI-7645 - Upgrading from a version before 3.3 causes all attachments to be broken when running on an Oracle database
  • XWIKI-7763 - Database migration (upgrade) fails from 3.5 to 4.0 with PostgreSQL
  • XWIKI-7770 - Failing migration from 3.5 to 4.0-rc-1 on Oracle
  • XWIKI-7771 - Failing migration from 3.5 to 4.0-rc-1 on PostgreSQL
  • XE-1133 - Use the PostgreSQL-specific mapping file when buiding the pgsql profile

Skin improvements

In XWiki 3.4 we refreshed a bit the Colibri skin, towards a more modern look, with rounded corners and gradients. Unfortunately, this change was not perfectly backwards incompatible with older color themes, possibly causing some custom color themes to be "broken". We improved the skin in this version to better support both old and new color themes, enabling gradients only when the color theme properly defines gradients. We've also improved the color theme wizard to support the new gradients.

  • XWIKI-7597 - Add new colortheme variables for the gradients introduced by 3.4 and allow their modification from the colorthemes wizard
  • XWIKI-7615 - Remove gradient filters for inputs, textarea and select fields for IE8, IE9
  • XWIKI-7616 - Bad display for ColorThemes that have empty gradient values in IE8 and IE9 (Ruby, Mint, Dusk + older colorthemes)
  • XWIKI-7636 - The color picker doesn't open if the list of configured colors doesn't contain only hex codes
  • XWIKI-7672 - Livetable's filter input's border-color should be consistent with the border color used for other form elements
  • XE-1122 - Add new colortheme variables for the gradients introduced by 3.4 and allow their modification from the colorthemes wizard
  • XE-1126 - Page header background color isn't updated in real time when editing a newly created Color Theme
  • XE-1127 - ColorTheme Wizard doesn't display the logo when creating a new ColorTheme or visualizing a theme that has a white header background
  • XE-1128 - Be able to preview value changes for the 3.4 gradients (#mainmenu, #contentmenu, .xwikipaneltitle, .button) from the ColorTheme Wizard
  • XE-1130 - Display gradients in the ColorTheme Wizard also for IE8 and IE9 browsers
  • XE-1135 - Small style improvements: on ColorTheme.WebHome make .x-theme-info style consistent (font, size) + polish 'Create theme' input

Rendering and WYSIWYG improvements

  • XRENDERING-177 - Empty lines around stand-alone macros are badly converted
  • XWIKI-4048 - Automatically add empty new line before/after macros when inserting standalone macros
  • XWIKI-6121 - Double clicking on text makes macro edit box appear
  • XWIKI-7489 - WYSIWYG editor misbehaves when entering . (period) at the end of <ul> line
  • XWIKI-7565 - Pass a relative URL to the inputURL WYSIWYG editor configuration parameter
  • XWIKI-7573 - WYSWIG Editor Undo Level is limited to 10
  • XWIKI-7593 - Links from other WYSIWYG fields are removed if the page is saved while a WYSIWYG field is edited in full screen
  • XWIKI-7606 - Cannot delete a table row when the selection spans across multiple cells
  • XWIKI-7619 - Infinite recursion when selecting a tree node if parent chain has cycles

Debian package improvements

There have been several bugfixes for the new Debian packages:

  • XE-1116 - Upgrade to jdeb 0.10
  • XE-1118 - conffiles and postinst files should ends with a new line in debian packages
  • XE-1119 - postgres debian packages don't have the right name
  • XE-1120 - /etc/xwiki/hibernate.cfg.xml file is not generated by debian installer
  • XE-1123 - hibernate configuration file does not have the right owner in debian installer
  • XE-1152 - Debian tomcat/mysql based package has wrong names

Sheet Module improvements

As with any new module, only intensive usage can reveal hard to spot bugs. Fortunately, we've been hard at work and we fixed most of the problems that we've detected, and this module should be more bulletproof now.

  • XWIKI-7325 - Class sheets are not applied on document translations
  • XWIKI-7529 - Comment preview doesn't work when a sheet is applied to a document

AppWithinMinutes improvements

  • XWIKI-7380 - Cannot go back from step 2 to step 1
  • XWIKI-7466 - AppWithinMinutes Sheet generator makes sheet flow only 50% of the page
  • XWIKI-7379 - Set AppWithinMinutes.WebHome as the parent of the application home page
  • XWIKI-7563 - Application created by Application Within Minutes cuts "?" both in page names and page titles
  • XWIKI-7610 - LiveTable generator does not escape XWiki syntax in JSON strings.

Extension Manager improvements

  • XWIKI-7588 - Extension JAR handler does not put the classloader associated to prefixed wiki name
  • XWIKI-7614 - When in a subwiki XAR extension should be installed on the current wiki by default
  • XWIKI-7646 - Jar extension does not produce component events when loaded at startup


  • XCOMMONS-118 - EmbeddableComponentManager#hasComponent does not fallback on parent CM
  • XWIKI-6784 - No error shown when having wrong CSRF token and saving with AJAX save and continue
  • XWIKI-6934 - Preview action doesn't displays the page's title
  • XWIKI-7513 - Failure to upload attachments using REST
  • XWIKI-7591 - Query wiki is not fully taken into account
  • XWIKI-7594 - Recent XWiki.XWikiPreferences properties are not created automatically
  • XWIKI-7599 - Activity macro doesn't work when logged in as superadmin
  • XWIKI-7617 - doc.fullName does not work as Livetable column because the JSON returns doc_fullname
  • XWIKI-7633 - Impossible to restart XWiki application alone without restarting the application server
  • XWIKI-7656 - Office Viewer plugin does not work with spaces in the attachments filename
  • XWIKI-7682 - Fix 'delete this attachment' title's translation key
  • XWIKI-7731 - ActivityStream subclasses can't provide their own subclasses of ActivityEvent anymore
  • XWIKI-7736 - Trying to change the parent with the REST service results in an error

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

Internet Explorer
Internet Explorer

Tested Databases

Here's the list of RDBMSs tested with this version (i.e. databases that we've tested as working, both for new installations and for upgrades - Check the list of supported databases):


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 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 the 3.5.1 version

As stated above in the Database compatibility improvements section, in XWiki 3.2 we changed the Hibernate mapping files which caused some incompatibilities for PostgreSQL and Oracle databases. All new installations should work without any problems, and upgrades from older versions have been thoroughly tested and there shouldn't be any problems except the one noted below. However, given that some column types have changed between since older versions, do make a backup of your database first. If you encounter any problems, please report them.

Upgrade from a version between 3.2 and 3.5 to 3.5.1 on PostgreSQL

The mapping file for PostgreSQL was broken for these versions, causing XWIKI-7539, so all history entries containing non-ASCII characters were broken. This data loss is permanent and can't be undone, there's no way of getting back a valid history from the database. While we tried to fix as many history entries as possible, this kind of entries will remain broken, leading to inaccessible older versions for some documents. We kept valid the history meta data though, so you can still see when and by whom each version was created.

API Breakages

No APIs were modified since 3.5.

Get Connected