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 contains a long awaited feature allowing to manually order the pages displayed in a page tree. It also contains a few improvments and important bug fixes such as a fix for the duplicated attachments on the filesystem storage.

New and Noteworthy (since XWiki 16.3.1)

Full list of issues fixed and Dashboard for XWiki 16.4.0.

For Users

No changes!

For Admins

Pinned Pages

 
You can now manually change the order of the pages displayed in all the page trees used in the wiki (Navigation tree, Breadcrumbs tree, Page Index Tree, etc). It's not a fully manual order but rather a mix of manual and automatic order: some pages, we call them "pinned" pages, are displayed first (in manual order), followed by the rest of the child pages in automatic order (e.g. by page title). You can pin pages at any level in the page tree hierarchy using the dedicated administration section. For a given parent (nested) page the list of pinned child pages is saved in its page preferences. The list of top level pinned pages are saved in the wiki preferences.

The screenshots show the effect of pinning the Nested1/Nested2/Pinned Page Example page in various trees in the XWiki UI (namely: Navigation tree, Breadcrumbs tree and Page Index Tree).

Besides the new administration section, we also updated the Navigation Panel administration section to allow you to change the order of the top level pages and save this manual order using pinned pages. Basically, whenever you move a top level page to a new position, that page and all its previous sibling pages become pinned. You can of course unpin a top level page.

Miscellaneous

• Attachment storage size reduced: The current version of each attachment used to be duplicated in the storage, it's not the case anymore. See Filesystem. Note that it only applies to new attachments, existing attachments are not migrated during upgrades.

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

• JBoss Logging 3.6.0]
• bytebuddy 1.14.15]
• AspectJ 1.9.22.1]
• Jackson 2.17.1]
• Commons CSV 1.11.0]
• Guava 33.2.0-jre]
• Checker Qual 3.43.0]
• Error Prone annotations 2.27.1]
• Maven Resolver to 1.9.20]
• Commons Codec 1.17.0]
• Bouncy Castle 1.78.1]
• Commons CLI 1.7.0]
• JGroups 5.3.6]

Translations

The following translations have been updated: 

• German
• Galician
• Korean
• Portuguese (Brazil)

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 126	Not Tested
	Google Chrome 125	Tests run and results
	Microsoft Edge 125	Jira Tickets Marked as Fixed in the Release Notes Tests run and results
	Safari 17	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.2	Not Tested
	MariaDB 11.3	Jira Tickets Marked as Fixed in the Release Notes
	MySQL 8.4	Tests run and results
	PostgreSQL 16	Tests run and results
	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.89	Jira Tickets Marked as Fixed in the Release Notes Tests run and results
	Jetty 10.0.20 (XWiki Standalone packaging)	Tests run and results
	Jetty 10.0.20	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.

API Breakages

No API breakage since XWiki 16.3.1.

Credits

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

• Josué Tille 
• LucasC 
• Manuel Leduc 
• Mariana Batista 
• Marius Dumitru Florea 
• Michael Hamann 
• Nuria Rey 
• Pierre Jeanjean 
• Raphaël Jakse 
• Simon Urli 
• Simpel 
• Thomas Mortagne 
• Vincent Massol 
• daeseong.choi