Release Notes for XWiki 5.3 Milestone 1
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.2)
Full list of issues fixed and Dashboard for 5.3.
<feature N>
<description of feature N>
Miscellaneous
- Some XSS fixes
See the full list of JIRA issues fixed in this release.
For Developers
DocumentReference Locale now taken into account in XWiki#exists and XWiki#getDocument
You can now use XWiki#exist method to check for some translation existence too, before that the only way was to either load the XWikiDocument or write your own XWQL or HQL query.
XWiki#getDocument has been modified accordingly too to be consistent so you don't need to go through XWikiDocument#getTranslatedDocument anymore.
It also mean that you need to be careful of what Locale is in the DocumentReference with those APIs now.
New Extension Manager APIs
Extension sub script services
The extension service now expose an extension point for extension related script service so that it's used as entry point for all of them.
By default the following are provided:
- $services.extension.core (for core extensions APIs)
- $services.extension.local (for local extensions APIs)
- $services.extension.installed (for installed extensions APIs)
- $services.extension.xar (for XAR extension APIS)
XWiki Enterprise Archetype
A new archetype is now available to easily create your own product based on XWiki Enterprise. To use:
-DarchetypeArtifactId=xwiki-enterprise-archetype \
-DarchetypeGroupId=org.xwiki.enterprise \
-DarchetypeVersion=5.3-milestone-1
XAR plugin improvements
The XAR plugin now provides the ability to change values in the XML pages. For example:
<groupId>org.xwiki.commons</groupId>
<artifactId>xwiki-commons-tool-xar-plugin</artifactId>
<configuration>
<transformations>
<transformation>
<file>Blog/WebHome.xml</file>
<xpath>/xwikidoc/object/property/itemsPerPage</xpath>
<value>100</value>
</transformation>
<transformation>
<artifact>org.xwiki.platform:xwiki-platform-administration-ui</artifact>
<file>XWiki/XWikiPreferences.xml</file>
<xpath>/xwikidoc/object/property/colorTheme</xpath>
<value>ColorThemes.Mint</value>
</transformation>
</transformations>
</configuration>
</plugin>
Miscellaneous
- Script Services implementations have been moved outside of the internal package in order for CLIRR to check them for backward incompatibilities and so that their API are made available in generated Javadoc.
Deprecated and Retired projects
<description of deprecated and retired projects>
Upgrades
The following dependencies have been upgraded:
- commons-fileupload 1.3
- cssparser 0.9.10
- XStream 1.4.5
- HttpClient 4.3
- Bean Validation 1.1 (and Hibernate Validator 5.0.1)
Translations
The following translations have been updated:
Tested Browsers & Databases
Known issues
Backward Compatibility and Migration Notes
General Notes
You may also want to import the default wiki XAR in order to benefit from all the improvements listed above.
Issues specific to XWiki <version>
<issues specific to the project>
API Breakages
The following APIs were modified since <project> <version - 1>:
