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 includes an improvement to the wiki macro parameter suggestions in CKEditor. It also includes some admin and developer enhancements, as well as accessibility improvements. In addition to these features, it also includes a number of bug fixes and some security fixes.

New and Noteworthy (since XWiki 15.2)

Full list of issues fixed and Dashboard for 15.3.

For Users

Suggestions for the wiki macro parameter type

 
It's now easier to decide what value to set in the wiki macro parameter type as suggestions are proposed: "Unknown" (the default), and "Wiki" for a parameter containing wiki markup. It's still possible to explicitly set the Java type to use.

Miscellaneous

• Updated the menu structure to make it navigable with a keyboard. Now each menu with subsections contains a proper toggle button.

• Updated the notification count color to match the color theme. This should on a light color theme make this red darker.

• Increased the size of the lightbox dropdown buttons (download, details, ...).

For Admins

Increasing contrast

 
Some elements of the XWiki interface systematically didn't achieve the minimum contrast defined in the Web Content Accessibility Guidelines.

Instances using Iceberg - the default color theme - or no color theme, are now patched to avoid those systematic violations.

Contrast is notably higher on buttons or light texts.

Changes for the Iceberg UI:

• Navigation bar is very slightly darker
• Links are slightly darker
• Breadcrumb text is darker.
• Muted text (e.g. description of a template when creating a page, [+] to add tags, ...) is darker
•  The buttons have more contrast:
  • Blue buttons have a slightly darker background
  • Red buttons have a darker background
  • Green buttons have a darker background
  • Yellow buttons have a lighter background and their text is swapped from white to black

Changes for the no-theme UI:

• The anchors in the right side drawer are darker.
• Breadcrumb text is darker.
• Muted text is darker
• The buttons have more contrast:
  • Blue buttons have a slightly darker background
  • Red buttons have a darker background
  • Green buttons have a darker background
  • Yellow buttons' text swapped from white to black

Choose the authentication service at runtime

 
It's now possible to choose the authentication service to use at runtime (for authenticators which support it).

Miscellaneous

• Livedata colors now properly use the color theme variables. This fixes the display of livedata on color themes different from Iceberg. This difference is especially important on dark colorthemes.

For Developers

• Dynamic registration of rendering listeners: It is now possible to declare a rendering listener dynamically from an extension.

• Add concept of image to What's New API: In preparation for displaying images in the What's New UI for news items, the What's New API has been updated to support getting images for news items.

  @Inject
  @Named("xwikiblog")
  private NewsSourceFactory factory;
  
  @Inject
  @Named("xwikiblog")
  private NewsConfiguration configuration;
  
  ...
  List<NewsSourceDescriptor> descriptors = this.configuration.getNewsSourceDescriptors();
  NewsSourceDescriptor descriptor = descriptors.get(0);
  List<NewsSourceItem> items = this.factory.create(descriptor.getParameters())
   .forUser(...)
   .forCategories(...)
   .build()
  String imageURL = items.get(0).getImageURL().get();
  ...

Upgrades

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

• dompurify 3.0.1
• @sideway/formula 3.0.1
• webpack 5.76.1
• CSS4J 4.0
• ASM 9.5
• Caffeine 3.1.6
• Checker Qual 3.33.0
• Commons Configuration 2.9.0
• Groovy 3.0.17
• Infinispan 14.0.8
• Joda-Time 2.12.5
• MariaDB connector 3.1.3
• Netty 4.1.91.Final
• Plexus Archiver 4.6.3
• PostgresSQL connector 42.6.0
• Protostream 4.6.2.Final
• SLF4J 2.0.7
• common-compress 1.23.0
• Byte Buddy 1.14.4
• Oracle connector 23.2.0.0
• MySQL connector 8.0.33

Translations

The following translations have been updated: 

• German
• Russian
• Swedish
• 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 113	Not Tested
	Google Chrome 113	Not Tested
	Microsoft Edge 114	Jira Tickets Marked as Fixed in the Release Notes
	Safari 16	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.1	Not Tested
	MariaDB 10.11	Not Tested
	MySQL 8	Jira Tickets Marked as Fixed in the Release Notes
	PostgreSQL 15	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.75	Jira Tickets Marked as Fixed in the Release Notes
	Jetty 10.0.12 (XWiki Standalone packaging)	Not Tested
	Jetty 10.0.12	Not Tested

Security Issues

Security issues are not listed in issue lists or dashboards to avoid disclosing ways to use them, but they will appear automatically in them once they're disclosed. See the XWiki Security Policy for more details.

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 15.3

In the office document importer, the API of OfficeDocument for imported artifacts like images has been changed to use a map from filenames to a new type OfficeDocumentArtifact instead of a set of files. Any code that relies on the old method to get a set of files won't get access to the artifacts. Further, artifacts from custom implementations of OfficeDocument might not be imported. This could cause broken images in case of custom code or extensions. All usages of this API in XWiki itself have been adjusted so no breakage without custom code or extensions is expected.

API Breakages

The following APIs were modified since XWiki 15.2:

Unstable APIs

Not real backward compatibility breakages since they were done on APIs marked @Unstable (a.k.a Young APIs). Thus it's part of the contract that they can be broken until they become stable. They're listed purely for reference in case you decided to still use them (and thus agreed to be broken).

• Young API
  • Violation type:
    java.method.addedToInterface
  • Code:
    ## Old:
    
    
    ## New:
    method int java.lang.Comparable<T>::compareTo(T) @ org.xwiki.whatsnew.NewsSourceItem
• Young API
  • Violation type:
    java.method.addedToInterface
  • Code:
    ## Old:
    
    
    ## New:
    method java.util.Optional<java.lang.String> org.xwiki.whatsnew.NewsSourceItem::getImageURL()

Credits

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

• Andreas Jonsson 
• DenisF 
• Manuel Leduc 
• Marius Dumitru Florea 
• Michael Hamann 
• Nikita Petrenko 
• Sereza7 
• Simon Urli 
• Simpel 
• Thomas Mortagne 
• Vincent Massol