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.

<insert description of release here>

New and Noteworthy (since XWiki <version - 1>)

Full list of issues fixed and Dashboard for <version>.

Notifications & Watchlist

• A new menu has been added to the top bar, on the right: the "notifications" menu (represented by a bell). In the future, it will be the place where you can find notifications about some events happening on the wiki (personal message, a page has been modified, etc...).

     

• In this menu, we have moved the Watchlist icons (watch this page, watch this wiki, etc...). These actions can be triggered with the new switch buttons:

     

Miscellaneous

• Some bootswatch themes have now a more accurate logo.
• When the search button on the top menu is clicked, it now closes all other menus.
• The Sandbox now uses the last XWiki 2.1 syntax.
• Non terminal pages are now exported with their corresponding WebPreferences page

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

For Developers

<developer feature N>

<description of developer feature N>

Deprecated and Retired projects

<description of deprecated and retired projects>

Upgrades

The following dependencies have been upgraded:

• slf4j 1.7.13
• Joda-Time 2.9.1
• commons-collections 3.2.2
• Maven 3.3.9
• Guice 4.0
• commons-dbcp2 2.1.1
• jboss-logging 3.1.4
• Woodstox 4.4.1
• commons-net 3.4
• commons-collections 4.1

Miscellaneous

• An extension point to add content inside the new  "Notifications" menu has been added:

  org.xwiki.platform.notifications

• A new extractFirstReference(EntityType) API has been added to EntityReference: Extract the first entity of the given type from this one by traversing the current entity to the root. This differentiates it from extractReference(EntityType) which extracts the last entity of the given type.
• The escape Velocity tool has a new method to escape CSS identifiers. This is similar to CSS.escape() available in JavaScript, and is useful if you want to create CSS selectors dynamicaly using untrusted input.
  $escapetool.css('a#b.c d[e=f]g{h:i;j}k')
  ## Output: a\\#b\\.c\\ d\\[e\\=f\\]g\\{h\\:i\\;j\\}k

Translations

The following translations have been updated: 

• Language
• Language

Tested Browsers & Databases

Performances tests compared to <last super stable version>

<a summary of the comparison with latest super stable version>

More details on <link to the test report>.

Known issues

• Bugs we know about

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.

Issues specific to XWiki 7.4 Milestone 1

• Better backward-compatibility for URLs has been added for the following 2 cases:
  • If the view action is omitted in the URL and the first space name doesn't match an action name, then the "view" action is implied
  • The view action can be specified even when the wiki is configured to hide the view action.
  • Note that this fixes some backward-compatibility issue introduced in XWiki 7.2

API Breakages

The following APIs were modified since <project> <version - 1>: