Release Notes for XWiki 9.7-rc-1

Version 8.1 by Clément Aubin on 2017/08/23
Warning: For security reasons, the document is displayed in restricted mode as it is not the current version. There may be differences and errors due to this.
Contents

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 9.6)

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

For Users

Improved Attachment Index

 
The Attachments tab from the Page Index has been improved:

  • the Space and Page columns have been replaced with the Location column
  • the Type column is now the first column and you can sort and filter attachments by file type
  • the Type column uses the Icon Theme and shows a thumbnail preview for image attachments
  • there's a new column that displays the attachment file size, with support for sorting and filtering the attachments by their file size
  • attachments can be filtered by date using the new date range picker

We also fixed two important bugs:

  • the sort was not working correctly
  • attachments from hidden pages were displayed even if hidden pages were not visible

attachmentIndex.png

Improved Code Viewer with Blame View

 
The code viewer (More Actions > View Source) has been improved to look nicer and have proper line numbers that support highlighting and linking.

A new Blame View was also added to the code viewer. In this mode, each line of the document's content is annotated with the last author that modified it and the revision in which this modification was introduced. The blame view also works when viewing the source of a document revision (other than the latest one) so it can be accessed at any point in the history of a document. See the documentation for more details.

codeViewer.png
codeViewer-lineNumbers.png
codeViewer-blameView.png
codeViewer-blameView-author.png
codeViewer-blameView-versionAndDate.png

Include and exclude Notification filters

 
A user can now define notification filters that are either inclusive or exclusive.

Notifications that come from a document that matches an exclusive filter will then be discarded.

filters2.png

Gadget Wizard Update

 
The Gadget Wizard used to insert and edit the gadgets from the Dashboard has been updated to use the new Macro Wizard from the CKEditor.

selectGadget.png
editGadget.png

New default notification filters

 
Default notification filters can now be created.
When a default notification filter is created, it appears as activated on every profile of every user. Each user can then choose to disable it (or re-enable it) by clicking on the "Advanced filtering options" link in its notification center.

In this version, only one default filter is provided (called "System Filter") and allows each user to hide (or not) notifications coming from the system user of XWiki.

advancedFilters.png
advancedFiltersLink.png

Notifications Preferences

 
It is now possible to enable or disable all the notifications sent by an application.

NotificationPreferencesForApp.png

Improvements when viewing a document version

 
When viewing a document revision (other than the last one), we're now showing the version information in the "last modified" section. Also, the "More actions" options are now displayed and the "view source" option will work on the currently displayed revision (instead of working on the latest version). Read more about document versioning in the documentation.

document-revision-lastModifiedWithVersion-and-moreActions.png

Display extension id

 
The extension id is now also displayed in the Dependencies section of the Repository Application.

dependencies.png

Clickable versions in the changes view

 
When viewing the changes introduced between 2 document versions (diff), the compared versions are now clickable so that the document can be viewed at those specific revisions.

changes-versionLinks.png

Deprecated and Internal Macros Hidden by Default

 
When inserting a macro, the WYSIWYG Editor (CKEditor) is now hiding the deprecated and internal macros from the "All Macros" category that is selected by default. In order to insert a deprecated or internal macro you need to explicitly select the corresponding category from the list. The following macros have been moved to the Deprecated category: Spaces, SpacesIndex and Workspaces.

macroSelector-all.png
macroSelector-deprecated.png

Miscellaneous

  • The old WYSIWYG editor based on Google WebToolkit has been removed: In XWiki 8.2RC1 we made CKEditor the default WYSIWYG editor but the users could still use the old Google WebToolkit (GWT) editor by enabling it in the wiki administration. Starting with this version the old WYSIWYG editor is no longer available. CKEditor remains the only WYSIWYG editor option available in XWiki by default.

  • Macro List in Syntax Help: The Syntax Help page now displays the list of all the macros available in your wiki. This was previously covered by the XWiki.WikiMacros page which has now been removed.

  • Layout Macro Category: A new Layout Macro category was added and the following macros were moved to it: Dashboard, Container and Gallery.

  • CKEditor Upgrade: The CKEditor has been upgraded from version 4.6.2 to 4.7.2. This brings a lot of bug fixes and some improvements:

    • select and manipulate arbitrary rectangular table fragments (a few cells, a row or a column)
    • paste from Microsoft Excel
    • improved paste from Word
    • new color picker

    See the CKEditor release notes for more information.

For Admins

  • Extension Manager improvements: Extensions installed as dependencies but which don't have any backward dependencies anymore are now taken into account by the upgrade job.

  • Active Installs now sends java specification version: The Active Installs now sends the java specification version in its pings to extension.xwiki.org.
    See the documentation of the active installs for more informations.

For Developers

Syntax highlighting by default in the wiki editor

 
The Syntax Highlighting Application is now bundled and enabled by default.

wikiEditDocument.png
wikiEditXObject.png

Jobs REST API improvements

 
Fail job started with async=false now return an error code 500. A serialized error message with complete stack trace is also provided in the Job status.

Miscellaneous

  • Refactored notifications module: For this release, we refactored the xwiki-platform-notifications modules by splitting it into multiple submodules. Some young APIs have been moved to sub packages.

    See XWIKI-14575.

  • Script Service API to get Macro descriptors: Example of usage: #set ($macroDescriptors = $services.rendering.getMacroDescriptors('xwiki/2.1'). Returns a List<MacroDescriptor>. More information in the Rendering Script Service documentation.

Moved Modules

<description deprecated, retired and moved projects>

Upgrades

The following runtime dependencies have been upgraded (they have a different release cycle than XWiki Commons, XWiki Rendering, XWiki Platform and XWiki Enterprise):

Translations

The following translations have been updated: 

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 <version>

<issues specific to the project>

API Breakages

The following APIs were modified since XWiki 9.6:

Failed to execute the [groovy] macro. Cause: [https://api.github.com/repos/xwiki/xwiki-commons/contents/xwiki-commons-core/pom.xml?ref=xwiki-commons-<version>]. Click on this message for details.

Credits

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

aifrimxwiki
Clément Aubin
Ecaterina Moraru (Valica)
Eduard Moraru
Guillaume Delhumeau
Marius Dumitru Florea
Pierre Bondoerffer
Sergiu Dumitriu
Subbu Dantu
Thomas Mortagne
Vincent Massol

Tags:
   

About

About

Support

Platform

User Guide

Admin Guide

Developer Guide

Projects

XWiki

Extensions

Other

Contribute

Status

Practices

Under the Hood

Get Involved

Get Connected