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.

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 also output a link to create a missing page translation in-place:

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

• Jakarta Mail 1.6.6
• Caffeine 2.9.0
• Snakeyaml 1.28
• Woodstox 6.2.4
• Commons Net 3.8.0
• Closure Compiler v20210202
• Jackson 2.12.2
• commons-lang3 3.12.0
• JBoss Marshalling 2.0.11.Final
• Protobuf Java 3.15.5
• ICU4J 68.2
• Byte Buddy 1.10.22
• Maven Shared Utils 3.3.3
• Velocity 2.3 and Velocity tools 3.1
• JNR FFI 2.2.2
• JNR POSIX 3.1.5
• Netty 4.1.60.Final
• Hibernate 5.4.29
• PostgresSQL connector 42.2.19
• JNA 5.7.0
• CKEditor Integration 1.53.2

Translations

The following translations have been updated:

• German
• Spanish
• French
• Korean
• Norwegian
• Russian
• Sinhalese
• Simplified Chinese

Tested Browsers & Databases

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

	Browser	Tested on:
	Google Chrome 89	Jira Tickets Marked as Fixed in the Release Notes   Tests run and results
	Microsoft Edge 89
	Mozilla Firefox 87	Not Tested
	Internet Explorer 11	Not Tested
	Safari 14	Not Tested

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

	Database	Tested on:
	HyperSQL 2.5.1	Tests run and results
	MariaDB 10.5
	MySQL 8	Not Tested
	Oracle 19c	Jira Tickets Marked as Fixed in the Release Notes
	PostgreSQL 13	Not Tested

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

	Servlet Container	Tested on:
	Tomcat 9.0.44	Jira Tickets Marked as Fixed in the Release Notes Tests run and results
	Jetty 9.4.29 (XWiki Standalone packaging)
	Jetty 9.4.29	Not Tested

Known issues

• Bugs we know about

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