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 focuses on stability, security and performance improvements, but also includes a few improvements for developers as well as admins.

New and Noteworthy (since XWiki 14.6)

Full list of issues fixed and Dashboard for 14.7.

For Users

No changes!

For Admins

Improved Macro picker for "not installed" macros

 
The WYSIWYG editor allows selecting not yet installed macros in the macros picker, but it was missing some usability information. You now see which recommended extensions a macro belong to, and you get a more explicit warning about what will happen when you select such macros.

Miscellaneous

• Notification handling memory improvement: The dispatching of notifications to the user has been rewritten to reduce a lot the memory required for it and improve reliability.

For Developers

Escaping of XWiki macro syntax in XML

 
The character { is now escaped in org.xwiki.xml.XMLUtils#escapeElementText and Document#display APIs.

Miscellaneous

• Improved Less SSX Caching: When writing a SSX using LESS, the SSX request parameters are now taken into account for caching the results of the LESS compilation output.

Moved Modules

• The Formula Macro has been extracted out of XWiki Standard and is now a contrib extension. See below for backward-compatibility considerations.

Upgrades

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

• java-diff-utils 4.12]
• Woodstox 6.3.1
• Tour Application 1.3.5
• Protobuf Java 3.21.5
• PostgresSQL connector 42.4.1
• Netty 4.1.79.Final
• MySQL connector 8.0.30
• MariaDB connector 3.0.7
• Joda-Time 2.11.0
• Jetty Client 9.4.48.v20220622
• Javassist 3.29.1-GA
• Hibernate Validator 6.2.4.Final
• HSQLDB 2.7.0
• Gson 2.9.1
• Goovy 3.0.12
• Error Prone annotations 2.15.0
• Closure Compiler v20220803
• Checker Qual 3.24.0
• CKEditor 4.19.1
• Byte Buddy 1.12.13

Translations

The following translations have been updated: 

• German
• French
• Ukrainian

Tested Browsers & Databases

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

	Browser	Tested on:
	Mozilla Firefox 104	Not Tested
	Google Chrome 104	Not Tested
	Microsoft Edge 104	Jira Tickets Marked as Fixed in the Release Notes
	Safari 15	Not Tested

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

	Database	Tested on:
	HyperSQL 2.7.0	Not Tested
	PostgreSQL 14	Not Tested
	MariaDB 10.6	Jira Tickets Marked as Fixed in the Release Notes
	MySQL 8	Not Tested
	Oracle 19c	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.65	Jira Tickets Marked as Fixed in the Release Notes
	Jetty 10.0.7 (XWiki Standalone packaging)	Not Tested
	Jetty 10.0.7	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 14.7

Removal of Formula Macro

It was decided that the Formula Macro was not a core extension and should not present by default in XWiki Standard. This was mostly motivated by the fact that there's a MathJax Macro offering similar features and we would like to promote it more over the Formula Macro as we think it provides a nicer visual result (amongst other features).

Thus when upgrading to XWiki 14.7+, the Formula macro will be removed from your wiki and you'll need to reinstall it (using a version >= 14.7) using the Extension Manager.

If you're a extension developer, this change can bring some small backward-compatibility issues:

• The PDFURIResolver legacy class was removed
• The TexAction class was removed
• The ImageData and ImageStorage classes were moved to the Formula Macro contrib extension

See this forum discussion for more details.

Escaping of { in XML context

For security reasons it was decided to also escape the character { in XWikiUtils#escapeElementText and the various Document#display APIs. It should not have any impact unless you use APIs like $doc.myfield and expecting it to return a value which is a very bad practice since this API is actually a displayer and #getValue('myfield') should be preferred for this need.

API Breakages

The following APIs were modified since XWiki 14.6:

Real breakages

Real backward compatibility breakages that we have unwillingly accepted to do for the reasons mentioned in each violation below.

• Requires a too big refactoring after Formula macro extraction to justify keeping it. See https://forum.xwiki.org/t/remove-legacy-pdfuriresolver-class/10808/
  • Violation type:
    java.class.removed
  • Code:
    ## Old:
    class com.xpn.xwiki.pdf.impl.PDFURIResolver
• Requires a too big refactoring after Formula macro extraction to justify keeping it. See https://forum.xwiki.org/t/remove-texaction-component/10888
  • Violation type:
    java.class.removed
  • Code:
    ## Old:
    class com.xpn.xwiki.web.TexAction

Credits

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

Alex Cotiugă
Andreea Chirica
Clément Aubin
Eduard Moraru
Manuel Leduc
Marius Dumitru Florea
Michael Hamann
Nikita Petrenko
Oana-Lavinia Florean
Pascal BASTIEN
Simon Urli
Simpel
Thomas Mortagne
Vincent Massol
slauriere