Release Notes for XWiki 11.1-rc-1

Version 2.1 by Guillaume Delhumeau on 2019/02/04

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.

<insert description of release here>

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

Full list of issues fixed and Dashboard for <full version here even for RC, e.g. 10.5>.

For Users

Rename AWM Application

 
Starting with this version you can rename/move an application created with App Within Minutes by renaming/moving its home page. Be aware though that the application code is going to be regenerated if you rename the application, which means that code customizations will be overwritten as a consequence.

Checkout the App Within Minutes documentation for more information.

Inline editing of title for Box Macro

 
The title of the Box macro is now editable directly in the WYSIWYG editor, as it already was for its content.

Simplified Page Rename

 
The Rename Page dialog has been simplified:

  • the "Preserve Children" option is visible only if the page to rename has child pages.
  • the "Update Links" option is now visible only to advanced users. For simple users the back-links are always updated.

Display page reference in the information viewer

 
You can now retrieve quickly the page reference of any page by going to the Information tab. The reference is by default displayed to the local wiki, but you can switch it to get a global reference for all wiki in a farm. The right button allow you to quickly copy it to the clipboard.

Macro Category Count

 
When inserting a macro through the WYSIWYG Editor the macro selector now shows the number of macros available in each category.

Miscellaneous

  • Job Waiting Information: You might now see a new information box instead of the progress bar if another job is currently performed against the pages you selected. In that case, you have to wait that the other job is finished or cancelled before yours start. The UI would refresh automatically.

For Admins

No changes!

For Developers

Page Count for Data Types

 
The Data Types live table now shows the number of pages that use each data type.

Default Class Sheet Shows Object Count

 
The default class sheet now shows the number of objects (of the current type) found on each page.

Inline editing of macro parameters

 
It is now possible to allow inline editing of macro parameters when using the WYSIWYG editor. In order to do that, we reuse the same principle as for allowing inline editing of content in macro: you have to specify the type of the macro parameter by using @PropertyDisplayType on the parameter, and then you have to specify the metadata to put where the macro parameter is used in the UI, by using the AbstractMacro#getNonGeneratedContentMetaData("parameterName") method.

Miscellaneous

  • Copy / Rename Events: The refactoring module introduces dedicated events for document copy and rename operations. Checkout the documentation for more information.

  • XClass Rename: The xobjects of an xclass are now updated automatically when the xclass is renamed if:

    • the xclass is not moved to a different wiki
    • the "Update Links" option is checked (which is the case by default)

    Renaming xclasses is still considered a dangerous operation though, because xclasses are often used in scripts, which are not updated when an xclass is renamed.

  • Ability to inject content in the HTML header: It is now possible to inject content dynamically in the "head" tag of the HTML pages via a dedicated extension point named org.xwiki.platform.head. It is useful typically for adding metadata to the pages. Checkout the extension point documentation for more information and an example.

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 and XWiki Platform):

  • <list libraries that have been upgraded>

Translations

The following translations have been updated: 

Known issues

Backward Compatibility and Migration Notes

General Notes

  • When upgrading make sure you compare and merge the following XWiki configuration files since some parameters may have been modified, removed or added:
    • xwiki.cfg
    • xwiki.properties
    • web.xml
    • hibernate.cfg.xml
  • Add xwiki.store.migration=1 in xwiki.cfg so that XWiki will attempt to automatically migrate your current database to any new schema. Make sure you backup your Database before doing anything.

In this version, we have replaced the Activity Stream store by the Event Stream Store. To handle the upgrade, it means you need to modify hibernate.cfg.xml.

You need to remove this line:
<mapping resource="activitystream.hbm.xml"/>
 
and to replace it by:
<mapping resource="eventstream.hbm.xml"/>

Issues specific to XWiki <version>

<issues specific to the project>

API Breakages

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

Credits

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

<code contributors>

Tags:
   

Get Connected