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 is a minor milestone release that adds new template provider restrictions, improved support for the WildFly application server, default support for Let's Encrypt certificates and 26 additional bugfixes which contribute to stabilizing XWiki.

New and Noteworthy (since XWiki 8.3 Milestone 1)

Full list of issues fixed and Dashboard for 8.3.

Template Restrictions

It's now possible to specify visibility restrictions separate from creation restrictions on a template provider and to set default values. See the documentation for more details

Miscellaneous

• Added partial matches for the Document/Attachment Does Not Exist suggestions, in addition to the existing stemmed and fuzzy matches, for better results.
• XWiki can now be deployed fine in WildFly 10.x.
• Let's Encrypt root certificate is now automatically registered at runtime

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

For Developers

Upgrades

The following dependencies have been upgraded:

• Tour Application 1.0.4
• JSqlParser 0.9.6
• Bootstrap 3.3.7
• Jackson 2.8.2

Miscellaneous

• The Velocity #try() directive now accepts an optional parameter to specify the name of a Velocity variable into which to save the caught exception. For example:
  {{velocity}}
  #try("myexception")
  $services.query.xwql("zzzzz").execute()
  #end
  
  #if ($myexception != '')
    ... do something...
  #end
  {{/velocity}}
• Added an order field to the "After Header" extension point.

Translations

The following translations have been updated: 

• Catalan
• German
• French
• Dutch
• Simplified Chinese

Tested Browsers & Databases

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.

API Breakages

No API has been broken since XWiki 8.2.1.

Credits

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

• Ecaterina Moraru (Valica)
• Eduard Moraru
• Guillaume Delhumeau
• Lukas Raska
• Marius Dumitru Florea
• Thomas Mortagne
• Vincent Massol