Release Notes for XWiki 10.7
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.
One of the main focus of XWiki 10.7 was bug fixing thus this release starts by reducing the bug count by 33, in important areas such as as Notifications, Skin or the core. This version also contains autocomplete of links when using the WYSIWYG editor, Macro content prefill when inserting a Macro from the WYSIWYG editor, and the beginning of replacing the old XWiki Confirmation boxes with Bootstrap modals with a focus on the comments action box to start with.
New and Noteworthy (since XWiki 10.6)
Full list of issues fixed and Dashboard for 10.7.
Bug Fixes
Since this release was about bug fixing, here's the full list of bugs fixed:
For Users
Link Autocomplete in WYSIWYG Editor
You can now create links to existing wiki pages and attachments directly from the editing area using the link auto-complete feature. Just type [ (open square bracket) followed by at least 2 characters and you will get link suggestions based on the typed text. Checkout the CKEditor Integration documentation for more information.
Updated the comments modals
The comments pop-ups that are displayed for deleting a comment and for permalink are now bootstrap modals, having the same functionality as before.
Macro Content Prefill in WYSIWYG Editor
When inserting a macro, the macro content text area is prefilled with the text selected within the editing area. This means you can for instance transform a paragraph into an error message by selecting the paragraph text, click the Insert Macro button from the tool bar, select the Error Message macro and insert it. Checkout the CKEditor Integration documentation for more information.
Miscellaneous
Removed misleading shortcut: Removed the META+V shortcut used in the jump dialog as it was preventing users from pasting.
For Admins
External URL generation improvements
It's now possible to set the port to use when generating an URL for a wiki in the each wiki descriptor. When the port is not set for a wiki, XWiki fallback on the main wiki descriptor.
Subwiki secure property (which indicate if HTTPS should be used instead of HTTP when generating a URL for the wiki) now inherit main wiki value if not explicitly set.
The first time XWiki is accessed the main wiki descriptor is generated using what can be found in the request's URL. For example if you access your wiki using https:mydomain:9898/xwiki/ you will end up with the following main wiki descriptor:
- alias: mydomain
- secure: true
- port: 9898
Also XWiki now supports the Forwarded (RFC7239) standard HTTP header when extracting information from the URL used by the client.
Miscellaneous
Notifications Auto Watch is now disabled by default: An important bug has been discovered in the Notification Applications that prevents using the Auto Watch feature when the wiki contains a lot of pages. For this reason, the default behavior for the Auto Watch feature has been set to not automatically follow any page. Nevertheless, users and administrators can still decide to change their own settings.
Checksum policy for Maven repositories: It's now possible to control in xwiki.properties file the behavior of each Maven repository handler regarding failing checksum validation. The default is warn.
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:
- German
- Czech
- Danish
- Spanish
- French
- Croatian
- Italian
- Latvian
- Dutch
- Portuguese (Brazil)
- Russian
- Slovak
- Swedish
- Turkish
- Ukrainian
- Traditional Chinese
- Simplified Chinese
Tested Browsers & Databases
Here is the list of browsers we support and how they have been tested for this release:
Browser | Tests performed and results | |
---|---|---|
Google Chrome 68 | Jira Tickets Marked as Fixed in the Release Notes + New and Noteworthy Features Full tests on product/Smoke tests on extensions | |
Mozilla Firefox 61 | Smoke tests on product | |
Microsoft Edge 17 | Full tests on product/Smoke tests on extensions | |
Internet Explorer 11 | Smoke tests on product | |
Safari 11.1 | Not Tested |
Here is the list of databases we support and how they have been tested for this release:
Database | Tests performed and results | |
---|---|---|
HyperSQL 2.4.1 | Not Tested | |
MySQL 5.7 | Jira Tickets Marked as Fixed in the Release Notes + New and Noteworthy Features Full tests on product/Smoke tests on extensions | |
Oracle 11.2 | Not Tested | |
PostgreSQL 10 | Full tests on product/Smoke tests on extensions |
Here is the list of Servlet Containers we support and how they have been tested for this release:
Servlet Container | Tests performed and results | |
---|---|---|
Tomcat | Not Tested | |
Jetty (XWiki Standalone packaging) | Jira Tickets Marked as Fixed in the Release Notes + New and Noteworthy Features Full tests on product/Smoke tests on extensions | |
Jetty | Not Tested |
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 10.7
- An important bug has been discovered in the Notification Applications that prevents using the Auto Watch feature when the wiki contains a lot of pages. For this reason, the default behavior for the Auto Watch feature has been set to not automatically follow any page. Nevertheless, users and administrators can still decide to change their own settings.
API Breakages
The following APIs were modified since XWiki 10.6:
- Not a breakage.
- Violation type:java.annotation.attributeValueChanged
- Code:## Old:
@interface org.xwiki.stability.Unstable
## New:
@interface org.xwiki.stability.Unstable
- Violation type:
- Not a breakage: class moved to a legacy module
- Violation type:java.class.removed
- Code:## Old:
class org.xwiki.velocity.introspection.AbstractChainableUberspector
- Violation type:
- Not a breakage: class moved to a legacy module
- Violation type:java.class.removed
- Code:## Old:
interface org.xwiki.velocity.introspection.ChainableUberspector
- Violation type:
- Not a breakage: class moved to a legacy module
- Violation type:java.class.removed
- Code:## Old:
class org.xwiki.velocity.introspection.ChainingUberspector
- Violation type:
- Not a breakage: class moved to a legacy module
- Violation type:java.class.removed
- Code:## Old:
class org.xwiki.velocity.introspection.LinkingUberspector
- Violation type:
- Adding a REST endpoint is actually not an API breakage.
- Violation type:java.method.addedToInterface
- Code:## Old:
null
## New:
method java.lang.String org.xwiki.notifications.rest.NotificationsResource::getNotificationsRSS(java.lang.String, java.lang.String, java.lang.String, java.lang.String, java.lang.String, java.lang.String, java.lang.String, java.lang.String, java.lang.String, java.lang.String, java.lang.String, java.lang.String, java.lang.String, java.lang.String) throws java.lang.Exception
- Violation type:
- Not a breake: the REST endpoint is the same.
- Violation type:java.method.returnTypeChanged
- Code:## Old:
method org.xwiki.notifications.rest.model.Notifications org.xwiki.notifications.rest.NotificationsResource::getNotifications(java.lang.String, java.lang.String, java.lang.String, java.lang.String, java.lang.String, java.lang.String, java.lang.String, java.lang.String, java.lang.String, java.lang.String, java.lang.String, java.lang.String, java.lang.String, java.lang.String) throws java.lang.Exception
## New:
method javax.ws.rs.core.Response org.xwiki.notifications.rest.NotificationsResource::getNotifications(java.lang.String, java.lang.String, java.lang.String, java.lang.String, java.lang.String, java.lang.String, java.lang.String, java.lang.String, java.lang.String, java.lang.String, java.lang.String, java.lang.String, java.lang.String, java.lang.String) throws java.lang.Exception
- Violation type:
- Young API
- Violation type:java.method.addedToInterface
- Code:## Old:
null
## New:
method org.xwiki.notifications.filters.watch.AutomaticWatchMode org.xwiki.notifications.filters.watch.WatchedEntitiesConfiguration::getDefaultAutomaticWatchMode(org.xwiki.model.reference.WikiReference)
- Violation type:
Credits
The following people have contributed code and translations to this release (sorted alphabetically):
Adel Atallah
Alex Cotiugă
Andrei C
anonymous
Clément Aubin
CostiChD
Ecaterina Moraru (Valica)
Guillaume Delhumeau
Marius Dumitru Florea
oanalavinia
oana.lavinia
Thomas Mortagne
Valdis Vitolins
Vincent Massol
XWiki
吴国凯