Release Notes for XWiki 5.4 Release Candidate 1

Version 16.1 by Thomas Mortagne on 2014/01/17

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 5.4 Milestone 1)

Full list of issues fixed and Dashboard for XWiki 5.4.

Distribution Wizard improvements

The upgrade mode has been removed, instead both modes are kind of enabled: it's always proposed to upgrade subwikis from main wiki and the Distribution Wizard is also always enabled on sub-wikis and displayed only if there is something to do.

Miscellaneous

  • Images that are copy-pasted as HTML in the WYSIWYG editor now work fine, thanks to the added support of the Data URI scheme in XWiki Syntax 2.1. The wiki syntax is:
    image:data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABAAAAAQCAYAAAAf8/9hAAAABHNCSVQICAgIfAhkiAAAAO9JREFUOE+lUrsNwjAUdCyWIBXjIEokVoCejgkyQ2gYAIkSsQUrUIUxwrund5bjX4OlyPG9u3v22Z2rjM1uWEtpkq//PC/fCs35UoHi/WGL8mTrErVsAJGJHU2KagGzHUi3I8iP+0s1nInXjBSPSfI/n2/vGTNFJZOVCRkYltdGl1FMRqmHYL0FFM6MjnFXaxCwNJMOZAbW6JyVkI1cbwcD3T5MGBjZLQxi8Lw9kp5iFFikUYwZr2dNQzQT7EavsDFOwl2ErNuIh5kgaX1E0bEyMTiZAcA0WAa26GSL7CUaHjJJz1wyqWLpe6gS/yn8AD9tcjFN7/ajAAAAAElFTkSuQmCC
  • Increased the size of the security cache to improve performances from 500 entries to 10000 entries. This setting could still be overwritten in the infinispan configuration of the cache named platform.security.authorization.cache. This new setting should be sufficient for most usages while the previous default were only valid for small single wiki. 

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

For Developers

<developer feature N>

<description of developer feature N>

Deprecated and Retired projects

<description of deprecated and retired projects>

Upgrades

The following dependencies have been upgraded:

  • <list libraries that have been upgraded>

Miscellaneous

  • We added a new parameter to the Live Table Velocity macro named 'selectedTags' which controls the list of tags that are selected initially in the tag cloud. You can still select different tags after the live table loads. With this new parameter you can have a permanent link to a live table that has the rows filtered initially by some tags:
    ## /xwiki/bin/view/Demo/WebHome?tag=news&tag=science
    #set ($options = {
      'className': 'Demo.DemoClass',
      ...
      'tagCloud': true,
      'selectedTags': $request.getParameterValues('tag'),
      ...
    })
  • The module xwiki-platform-wiki-rest replaces the old module xwiki-platform-wiki-manager-rest in order to move xwiki-platform-wiki-manager in contrib, but the API is unchanged.
  • Verbosity of the job is now configurable right from the org.xwiki.job.Request object
  • Log generator now generates BeginEvent/EndEvent variants based on marker informations
  • The following java.lang.Class methods are now allowed in Velocity by default: name, isArray, isAssignableFrom, isEnum, isInstance, isInterface, isLocalClass, isMemberClass, isPrimitive, isSynthetic
  • Default job status does not provide log tree anymore. Was making the API too complex. It can be created from the log queue very easily in Java and a helper method has been added in logging ScriptService to create one: $services.logging.toLogTree($logs)
  • Various APIs have been added to help translate log. See Logging Module for more details
  • It's now possible to add new Images Types when rendering in XHTML
  • Introduced org.xwiki.observation.AbstractEventListener

Translations

The following translations have been updated: 

Tested Browsers & Databases

Known issues

Backward Compatibility and Migration Notes

General 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 5.4RC1

New Velocity uberspector

If you modified velocity.properties = runtime.introspector.uberspect.chainClasses = ... property in xwiki.propertes file you should make sure to replace org.apache.velocity.util.introspection.SecureUberspector with org.xwiki.velocity.introspection.SecureUberspector.

API Breakages

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

<clirr output here>
Tags:
   

Get Connected