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 is mostly about improvements but it also introduce new Velocity tools and macros and also add support for catching and display nicely exceptions in Velocity.

New and Noteworthy (since XWiki 6.2)

Full list of issues fixed and Dashboard for 6.3.

Extension Manager and Repository improvements

• <scm> element from Maven pom.xml is now supported and has been added to the standard in the API
• <issueManagement> element from Maven pom.xml is now supported and has been added to the standard in the API
• When importing an extension unknown but valid versions are not removed anymore

User Directory customized globally

The administrator of the wiki can customize the default columns to be displayed by the user directory.

For more information, see the documentation

Flamingo

• The 'Add' button has been moved back to the top bar and the search bar to the right:

  

• When you click on the 'add' button, the order of the choices have been inverted, to propose to create a page first, then a space, and finally a wiki:

  

• The Wiki/Space/Page buttons in the top bar have been changed and are no longer split into two parts. You do not need to click the arrow specifically any more to open the contextual menu:

  

• To navigate to the current Wiki/Space/Page in the top bar, there is now a new "Go to..." item:

  Wiki	Space	Page

• The languages selection is now located in the top bar. It is displayed only when the multilingual mode is enabled:

  
  When there is no translation available:
  
  When there is some translations available:
  

• The Livetable is now responsive to the screen size, so you can use them with smartphones:

  

• The "Add" button has now a default action to create a new page. You can still create other kind of contents (Wiki, Space) by using the arrow, just like we do with the different "edit" actions.

  

• The Flamingo Theme Application now uses a new Color Picker.

  

• To sum up, this is the new look:

  

Miscellaneous

• The default color themes (DefaultColorTheme and FlamingoDefaultTheme) have been renamed Azure and Charcoal.
• In the select field of the 'color theme' property, in the administration, the color themes are now ordered by name.
• In the administration, clicking the "Customize" button for customizing a Skin or a Color Theme now opens the page it leads to in edit mode.
• Improved L&F when a template fails to render:

  

• We have created dedicated groups for Colibri and Flamingo Themes inside the Administration. Every themes can be used with both skins but they looks better when they are used with the corresponding theme.

  

• The start/stop shell scripts provided with the Standalone Distribution have been improved to display usage information when an invalid parameter is passed or when the -h or --help parameters are passed. Also note that the start script doesn't stop anymore a running XWiki instance if the -k or --kill parameter is passed (this parameter has been removed).
• It's now possible to configure the maximum number of search results to be returned from a search operation using xwiki.authentication.ldap.maxresults property in xwiki.cfg file. See LDAP documentation.
• The "Empty is today" option on Date fields of classes created with Application Within Minutes is now working as expected. See XWIKI-10296
• Office macro can now take a URL as input. See Office Macro for more details

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

For Developers

Velocity macros to display users and groups

We extracted the code that displays in view mode a property of type 'List of Users' and 'List of Groups' from the corresponding custom displayers (found in displayer_users.vm and displayer_groups.vm) into two Velocity macros that can be used to display arbitrary users and groups, even when you don't have an object. Here's how you can use them:

New Velocity Tools

• New URL Tool $urltool: A new tool has been added with one method to parse query string from the URL $urltool.parseQuery(String). The value returned by this is method is a Map<String, List<String>> which maps parameter names to (possibly multiple) values, and can be passed e.g. directly into $escapetool.url(Map<String, ?>) to convert it back to a string. This is useful e.g. in cases where one want to pass a complete query string around between requests, as it happend for the PDF export; the $urltool allows for a sane deserialization of the value passed around.
• New Exception Tool $exceptiontool: A new tool to manipulate Java Exceptions (get root cause, convert into String, etc).
• $stringtool moved from org.apache.commons.lang3.StringUtils to org.xwiki.text.StringUtils which extends the first one and add new stuff

Ability to catch Exceptions from Velocity

A new Velocity Directive has been added to catch Exceptions from Velocity. In addition a new #displayUnhandledException() velocity macro has also been added to nicely display an exception to the user.

For example:

This generates the following in case of error rendering the page:

New #displayException macro

Displays an error message with a title that can be clicked and expands to display an exception.

Example from a wiki page:

Component Disposal

The order used by the ComponentManager to dispose its components is computed based on declared dependencies. However there might be cases when you wish a Component's dispose() method to be called before or after all other components. In this case you can use the DisposePriority annotation. The default priority is 1000. A higher value will mean disposing before all other components not having this annotation. For example:

See the Component Reference documentation for other details.

New LiveTable Filtering Option

You can now specify how the filter value should be matched against the stored value. One use case when this is useful is when you have a live table for an XClass that has a Database List property and you want to use a text input filter instead of the default drop down list filter. Currently the user has to enter the full value in the text input in order to filter. Would be good if partial matching would work. This is possible starting with this version:

Checkout the LiveTable Macro documentation for more details about the match option.

Miscellaneous

• The wiki provisioning job has now the current user set in the context.
• 10 new icons have been mapped into Font Awesome Icon Theme.
• It's now possible to overwrite the id of a Java bean property using an annotation. See Properties Module for more.
• It's possible to get DEBUG information only for shutdown operations by editing logback.xml and setting:
  <logger name="org.xwiki.shutdown" level="debug"/>
• When importing an extension unknown but valid versions are not removed anymore

Upgrades

The following dependencies have been upgraded:

• JGroups 3.5.1
• Tika 1.6
• reflections 0.9.9
• Groovy 2.3.7
• jQuery 1.11.1
• Doxia 1.6
• Joda-Time 2.5
• commons-compress 1.9

Tested Browsers & Databases

Here is the list of browsers we support and how they have been tested for this release:

	Browser	Test Result
	Google Chrome 38	Not Tested
	Mozilla Firefox 33	Jira Fixed For
	Internet Explorer 8	Not Tested
	Internet Explorer 9	Not Tested

Here is the list of databases we support and how they have been tested for this release:

	Database	Test Result
	HyperSQL 2.3.2	Jira Fixed For
	MySQL 5.6.17	Not Tested
	Oracle 11.2	Not Tested
	PostgreSQL 9.3.4	Not Tested

Known issues

• Bugs we know about

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.

Programming Rights disabled for TextArea Properties

If you have a class with a TextArea property and in your sheet you use $doc.display() to display this property then you must know that starting with this version the content of the TextArea is rendered without programming rights, even if the last author or content author of the document that has the object with the TextArea property has programming rights. In other words, if you use wiki syntax in the TextArea content and you use script macros inside, the code that requires programming rights won't be executed even if you have the necessary rights. The reason for this change is because we can't know for sure who is the last author of the TextArea's content. We may remove this limitation in the future if we add a way to know the author. A solution we are currently investigating is the usage of signed scripts in TextArea's content. Until then, if you really want to execute the content of your TextArea properties using programming rights then you can use $doc.getRenderedContent() in your sheet, passing the content of the TextArea property.

API Breakages

The following APIs were modified since XWiki 6.2: