Skip to Content

Release Notes for $doc.getValue('product') $doc.getValue('version')

Version 8.1 by Simon Urli on 2024/05/22
Warning: For security reasons, the document is displayed in restricted mode as it is not the current version. There may be differences and errors due to this.

Failed to execute the [velocity] macro. Cause: [The execution of the [velocity] script macro is not allowed in [xwiki:ReleaseNotes.Data.XWiki.16\.4\.0RC1.WebHome]. Check the rights of its last author or the parameters if it's rendered from another script.]. Click on this message for details.

Contents

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 Failed to execute the [velocity] macro. Cause: [The execution of the [velocity] script macro is not allowed in [xwiki:ReleaseNotes.Data.XWiki.16\.4\.0RC1.WebHome]. Check the rights of its last author or the parameters if it's rendered from another script.]. Click on this message for details.
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.

pinned-example-nav.png
pinned-example-breadcrumb.png
pinned-example-allpage

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

Translations

The following translations have been updated: 

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

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 Failed to execute the [velocity] macro. Cause: [The execution of the [velocity] script macro is not allowed in [xwiki:ReleaseNotes.Data.XWiki.16\.4\.0RC1.WebHome]. Check the rights of its last author or the parameters if it's rendered from another script.]. Click on this message for details.
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 

About

About

Support

Platform

User Guide

Admin Guide

Developer Guide

Projects

XWiki

Extensions

Other

Contribute

Status

Practices

Under the Hood

Get Involved

Get Connected