This is the release notes for XWiki Commons, XWiki Rendering and XWiki Platform. They share the same release notes as they are released together and have the same version.

The maximum size of pages references, titles and short string properties has been increased from 255 to 768 characters. It also gives more control to administrators on user notification configuration and generally improve notification filters readability. Finally, it contains various bugfixes and improvements.

New and Noteworthy (since XWiki 13.1)

Full list of issues fixed and Dashboard for XWiki 13.2.

For Users

Distinguish between system filters and custom filters in notification settingsEdit

 
The Notification settings UI has been modified to allow a better management of Notification filters. In particular, we now distinguish "System filters" which are filters provided as components and that users can only enabled and disabled, and "Custom filters" which are filters dedicated to specific locations that users can create themselves, enabled, disabled or delete. The Notification settings then display separately the system and custom filters, and we tried to improve the wording to explain what is their exact meaning.

For developer and administrators, note that we deprecated the old macro for notification filter preferences in favor of two dedicated macros: notification system filter preferences and notification custom filter preferences.

 

Link to in-place editorEdit

 
You can now create a link to open a page directly in in-place editing mode, provided in-place editing is enabled:

You can [[edit in-place>>Some.Page||anchor="edit"]] this page.

You can also output a link to create a missing page translation in-place:

You can [[translate in-place>>Some.Page||anchor="translate"]] this page.

The Information tab uses this, for instance, to link to the missing page translations, when in-place editing is enabled.

Translate Page ButtonEdit

 
A new Translate button is now visible when viewing a page, if the wiki is multilingual and the page has not been translated to the current user interface locale. This button allows you to create the missing translation. It opens the in-place editor or it takes you to the stand-alone editor (Wiki or WYSIWYG) depending on your preferences. See the Internationalization documentation for more information.

Miscellaneous

  • Increased maximum size for pages title, reference and short strings: The maximum size of a page title, reference and short object properties strings moved from 255 to 768 characters.

    Edit

For Admins

Administrator can access user notification settingsEdit

 
It is now possible for administrators to get access to users' notification settings. This is done by clicking on the "Notifications" tab in the menu when looking a user profile. All the settings that a user can customize can now be set also by an administrator.

For Developers

No changes!

Upgrades

The following runtime dependencies have been upgraded (they have a different release cycle than XWiki Commons, XWiki Rendering and XWiki Platform):

Translations

The following translations have been updated: 

Tested Browsers & Databases

Here is the list of browsers we support and how they have been tested for this release:

 BrowserTested on:
Chrome30.pngGoogle Chrome 89Not Tested
Firefox30.pngMozilla Firefox 86Tests run and results
Edge30.pngMicrosoft Edge 89Jira Tickets Marked as Fixed in the Release Notes
IE30.pngInternet Explorer 11Not Tested
Safari30.pngSafari 14Not Tested

Here is the list of databases we support and how they have been tested for this release:

 DatabaseTested on:
hypersql.pngHyperSQL 2.5.1Not Tested
mysql.pngMySQL 8Not Tested
oracle.pngOracle 19cNot Tested
postgresql.pngPostgreSQL 13Tests run and results
mariadb.pngMariaDB 10.5Jira Tickets Marked as Fixed in the Release Notes

Here is the list of Servlet Containers we support and how they have been tested for this release:

 Servlet ContainerTested on:
tomcat-icon.pngTomcat 9.0.44
jetty-icon.pngJetty 9.4.29 (XWiki Standalone packaging)Not Tested 
jetty-icon.pngJetty 9.4.29Not Tested

Known issues

Backward Compatibility and Migration Notes

General Notes

  • When upgrading make sure you compare and merge the following XWiki configuration files since some parameters may have been modified, removed or added:
    • xwiki.cfg
    • xwiki.properties
    • web.xml
    • hibernate.cfg.xml
  • Add xwiki.store.migration=1 in xwiki.cfg so that XWiki will attempt to automatically migrate your current database to any new schema. Make sure you backup your Database before doing anything.

Issues specific to XWiki 13.2RC1

Orphaned Pages Panel Removal

We removed the orphaned pages panel (see the forum discussion). Consequently, the Extensions Manager will propose to remove the corresponding document (i.e., Panels.OrphanedPages) during the upgrade.

If you wish to re-integrate the panel after its removal, you can do so by following the Create a new panel instructions, and using the Orphaned Pages Panel snippet.

Old user, group, date and color pickers removed

The old user, group, date and color pickers are not bundled anymore. They were based on Prototype.js and were not used in XWiki Standard. We kept them so far in case someone was still using the old Colibri skin, which we stopped supporting a while ago. If you haven't written code that uses these pickers directly then you have nothing to worry because our current skin Flamingo provides an implementation of these pickers. If you're using the Velocity macros that correspond to these pickers then you don't have to worry either. You only need to take action if you're using directly the JavaScript code of the old pickers. In this case you have two options:

  • either update your code to use the new pickers
  • or copy the old JavaScript code and the Velocity macros from the XWiki instance you're upgrading from.

API Breakages

The following APIs were modified since XWiki 13.1:

  • Not a breakage for scripts
    • Violation type:
      java.method.removed
    • Code:
      ## Old:
      method java.lang.String org.apache.velocity.tools.generic.ComparisonDateTool::toString(long, int, int, boolean, java.util.Locale) @ org.xwiki.velocity.tools.ComparisonDateTool
  • Not a breakage for scripts
    • Violation type:
      java.method.removed
    • Code:
      ## Old:
      method java.lang.String org.apache.velocity.tools.generic.ComparisonDateTool::toString(long, int, boolean, java.util.Locale) @ org.xwiki.velocity.tools.ComparisonDateTool
  • Should not have any impact in practice.
    • Violation type:
      java.class.noLongerInheritsFromClass
    • Code:
      ## Old:
      class com.xpn.xwiki.web.SaveAction

      ## New:
      class com.xpn.xwiki.web.SaveAction

Credits

The following people have contributed code and translations to this release (sorted alphabetically):

  • Björn Ludwig
  • Christian Fröhlich
  • ClemDee
  • Francisco García Moreno
  • Geoffroy G
  • helabasa
  • Jaeseop So
  • Jarle Sandmo
  • jingkaimori
  • Manuel Leduc
  • Marius Dumitru Florea
  • plan3d
  • Simon Urli
  • Thomas Mortagne
  • Vincent Massol
  • xrichard
Tags:
   

Get Connected