Release Notes for XWiki 14.7-rc-1

Last modified by Ilie Andriuta on 2022/08/29

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 and performance improvement, 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):

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:
Firefox30.pngMozilla Firefox 103Jira Tickets Marked as Fixed in the Release Notes
Chrome30.pngGoogle Chrome 104Tests run and results
Edge30.pngMicrosoft Edge 104Not tested
Safari30.pngSafari 15Not Tested

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

 DatabaseTested on:
hypersql.pngHyperSQL 2.7.0Tests run and results
postgresql.pngPostgreSQL 14Not Tested
mariadb.pngMariaDB 10.6Not tested
mysql.pngMySQL 8Not Tested
oracle.pngOracle 19cJira 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.65Jira Tickets Marked as Fixed in the Release Notes
jetty-icon.pngJetty 10.0.7 (XWiki Standalone packaging)Tests run and results
jetty-icon.pngJetty 10.0.7Not 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 14.7-rc-1

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.7RC1+, the Formula macro will be removed from your wiki and you'll need to reinstall it 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

Tags:
   

Get Connected