Release Notes for XWiki 7.2 Milestone 3

Last modified by Thomas Mortagne on 2023/10/13

This is the release notes for XWiki Commons, XWiki Rendering, XWiki Platform and XWiki Enterprise. They share the same release notes as they are released together and have the same version.

This milestone release brings more changes to the Flamingo Skin in order to support Nested Documents. The top menu has been replaced by a drawer and the create, copy, rename and delete page actions have been revamped. This release also fixes some Watch List issues related to Nested Documents and provides a new configuration option for the LDAP module. The developers should check out the new job-related REST resources and the support for skins in Nested Spaces.

New and Noteworthy (since XWiki 7.2M2)

Full list of issues fixed and Dashboard for 7.2.

Flamingo

Following the introduction of the Nested Documents feature, we have changed a lot our default Flamingo skin:

  • The top menu has been removed and replaced by a drawer menu that you can expand by clicking on the top right icon
  • The add menu has been relocated near the edit one
  • The L&F of the Add, Edit, and "More Actions" menus has been changed
  • A lot of actions have been moved to the "More Actions" menu
  • The page breadcrumb has suffered some changes:
    • it is now also displayed on the wiki home page
    • the wiki home page is now included when it is part of the current document's hierarchy, i.e. for children and descendants of the wiki home page. See XWIKI-12423 for more details.
    • the sub-wiki pretty name is included between the home icon and the local page path
  • The actions menus (edit, create, more actions) are now available from the rename, copy and delete actions.
  • The create, copy and rename page actions have been modified to support nested documents:
    • The source and target documents are displayed using the breadcrumb
    • The target document can be selected using a document tree picker
    • For advanced users there is also the option to specify the target document using some text input fields (location advanced edit mode). This is useful especially if you want to create/move the page under a parent that doesn't exist yet (you cannot use the tree picker in this case because the parent would not be available in the tree).
  • The delete action proposes to delete the children of the document.

LDAP improvements

It's now possible to disable subgroups resolution using xwiki.authentication.ldap.group_sync_resolve_subgroups property in xwiki.cfg configuration file. Resolving each member to check if it's a group might be very expensive with big groups so if you know there is no subgroup you should really disable it.

Miscellaneous

  • The Navigation panel displays nested documents:

    navigationpanel.png

  • When renaming or copying a nested document the document title is updated to reflect the new document name if its previous value was equal the old document name. This was happening already for terminal documents. We extended the behaviour to nested documents.
  • Fixed various issues for several applications bundled in XE (such as WatchList and Annotations), which should now work well with Nested Spaces.
  • The Administration mode for spaces and wikis now uses the standard reference-based breadcrumbs instead of the previously custom section-based breadcrumbs.

    administrationUI-breadcrumbs-standard.png

  • The Administration mode no longer features a select input on the right side for navigation between spaces since that input does no longer scale in the context of Nested Spaces. Thus, the breadcrumbs should be used instead and the future UI improvements that will soon become available in this direction.
  • It's now possible to create Skins in Nested Spaces.
  • Changed the exception message displayed when a script execution fails due to lack of rights to make it clearer that it's not a problem with the current user, but with the script.

See the full list of JIRA issues fixed in this release.

For Developers

REST

2 new resources have been exposed to the REST API:

REST script services

The Script service changed a bit, url(EntityReference) now return relative URL String by default and a new url(EntityReference reference, boolean external) has been added to force returning an external form URL. See Generate a REST URL for a resource for more details.

Upgrades

The following dependencies have been upgraded:

Miscellaneous

  • You can now reuse the velocity hierarchy macros defined in the Flamingo Skin's hierarchy_macros.vm template to display the breadcrumbs for a particular document. See XWIKI-12408.
  • You can see the children and backlinks of any document with the new parameters ?xpage=children and ?xpage=backlinks to add to the document URL. To get the children according to the parent/child mechanism, you can use ?xpage=children&hierarchy=parentchild.
  • In JavaScript, the class XWiki.Document has been modified to handle nested spaces. A new constructor have been created, and the old one is deprecated.

Translations

The following translations have been updated: 

Tested Browsers & Databases

Failed to execute the [velocity] macro. Cause: [The execution of the [velocity] script macro is not allowed in [xwiki:TestReports.ManualTestReportSummaryXWiki72M3]. Check the rights of its last author or the parameters if it's rendered from another script.]. Click on this message for details.

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

BrowserTest Result
Chrome30.pngGoogle Chrome 41Not Tested
Firefox30.pngMozilla Firefox 40Jira Tickets + Full test
IE30.pngInternet Explorer 10Not Tested
IE30.pngInternet Explorer 11Not Tested
Safari30.pngSafari 5Not Tested

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

DatabaseTest Result
hypersql.pngHyperSQL 2.3.2Not Tested
mysql.pngMySQL 5.5.44Jira Tickets + Full test
oracle.pngOracle 11.2Not Tested
postgresql.pngPostgreSQL 9.4.1Not Tested

For the full list of tests see this page.

Known issues

Backward Compatibility and Migration Notes

General Notes

When upgrading make sure you compare your xwiki.cfg, xwiki.properties and web.xml files with the newest version since some configuration parameters may have been modified or added. Note that you should add xwiki.store.migration=1 so that XWiki will attempt to automatically migrate your current database to the new schema. Make sure you backup your Database before doing anything.

API Breakages

The following APIs were modified since XWiki 7.1.2:

  • New configuration option to change the size of the Job statuses cache:
    org.xwiki.job.JobManagerConfiguration: Method 'public int getJobStatusCacheSize()' has been added to an interface
  • Added missing methods to the DocumentModelBridge class, which are already implemented by XWikiDocument;
    org.xwiki.bridge.DocumentModelBridge: Method 'public org.xwiki.model.reference.DocumentReference getContentAuthorReference()' has been added to an interface

Get Connected