Release Notes for XWiki 13.2

Last modified by Vincent Massol on 2021/04/02

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.

This release improves the notification filter management, by separating the system filters from the user-made filters, and the notification settings management, by allowing administrators to access and modify notification settings for any user from the corresponding user profile. In-place editing has been improved to update various parts of the UI (breadcrumbs, navigation tree, tabs) on save. The links to create a missing page translation from the Information tab now open directly the in-place editor if that is your preferred editor. Moreover, the Translate button that was previously available when editing in-place is now available in view mode also, when it makes sense. Last but not least, the maximum size of page references, titles and short string properties has been increased from 255 to 768 characters.

The following regressions were introduced in this release (and found after it was released). Please check them out and if they impact you we recommend waiting to upgrade to a version where they are fixed.

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 settings

 
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 editor

 
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 Button

 
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.

For Admins

Administrator can access user notification settings

 
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 89
Edge30.pngMicrosoft Edge 89
Firefox30.pngMozilla Firefox 87Not Tested
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.1Tests run and results
mariadb.pngMariaDB 10.5
mysql.pngMySQL 8Not Tested
oracle.pngOracle 19cJira Tickets Marked as Fixed in the Release Notes
postgresql.pngPostgreSQL 13Not Tested

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)
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.2

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

Get Connected