Release Notes for XWiki 8.2 Milestone 2
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 features a redesigned default homepage, a new application index in the drawer and minor improvements to the template providers, the Flamingo skin and Ratings. For developers, we have some welcomed Livetable macro improvements and a long overdue change of behaviour for the getRenderedContent method.
New and Noteworthy (since XWiki 8.2 Milestone 1)
Full list of issues fixed and Dashboard for 8.2.
New Homepage
We replaced the Dashboard application from the main Homepage and added introductory steps as wiki syntax. This change will make it simpler for new users to edit the Homepage content, while also benefiting from some basic help concepts. The left panels area also showcases now the 'Navigation' panel, while the right panels area contain a 'Need Help?' panel.
Tour for Homepage
A tour has been created to present the UI elements existing on the Main.WebHome page. Every user will be guided through this tour in order to become familiar with XWiki.
The [gallery] macro is a standalone macro and it cannot be used inline. Click on this message for details.
Application Index
We removed some applications from the AppBar (like Scheduler, Invitation, Panels, etc.) with the intention to simplify the interface and promote a smaller number of applications inside the AppBar panel. In order for the applications to still be discoverable, we added in the Drawer an Application Index.
Template Icons
When creating a new page, the Template Providers for specific applications can now add an icon and a description. We added new icons and descriptions for the Blog and Dashboard default templates.
Miscellaneous
- Improved the edit section styling to be in consistency with the Flamingo Skin style
- Improved the way ratings stars are displayed by removing the white background from picture
See the full list of JIRA issues fixed in this release.
Upgrades
The following dependencies have been upgraded:
For Developers
Miscellaneous
- Added 2 new column types for the Livetable macro: "boolean" and "multilist"
Translations
The following translations have been updated:
Tested Browsers & Databases
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.
Issues specific to XWiki XWiki 8.2 Milestone 2
getRenderedContent
The behavior of the getRenderedContent methods located in Document/XWikiDocument changed a bit.
- methods taking a String to render in the context of the document: they are still rendering in the context of the document but with the right of whatever called the method
- methods rendering the document itself: they are still rendering in the context of whatever called this method but with the right of the document
API Breakages
The following APIs were modified in XWiki 8.2 Milestone 2:
- No actual breakage. Class was moved to another module
- Violation type:java.class.removed
- Code:## Old:
class org.xwiki.rendering.parser.ContentParser
- Violation type: