Release Notes for XWiki 7.0 Milestone 2
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 7.0 Milestone 1)
Full list of issues fixed and Dashboard for 7.0.
<feature N>
<description of feature N>
Miscellaneous
- The user/group displayer is now showing the wiki for local users/groups in edit mode too (the wiki was shown only in view mode previously).
See the full list of JIRA issues fixed in this release.
For Developers
Mail Sender API Improvements
The Mail Sender API has been improved to allow sending mails to a list of users, a list of groups and a list of email addresses, all at once. It also supports excluding users, groups and email addresses. Last, it ensures that recipients don't get duplicate mails. Before 6.4.2/7.0M2, you could send a mail either to a list of users or to a group (and to an email address) but you had to use several API calls for that and you had to handle yourself potential mail duplication (if a user was inside your user list and inside the group you were sending to for example).
Using the new API, the following example will send a template email to all the users in the XWiki.MyGroup group, to the XWiki.User1 and XWiki.User2 users + to the john@doe.com email address.
Also note that contrary to the previous API to send email to a group, the new API handles nested groups (i.e. if the XWiki.MyGroup group contains other groups, all users of those other groups will also receive the template email)!
## Parameters for the 'template' MimeMessageFactory
#set ($templateParameters = {'language' : $xcontext.language, 'velocityVariables' : { 'var1' : 'value1' }})
#set ($templateReference = $services.model.createDocumentReference('', 'Space', 'MailTemplatePage'))
#set ($parameters = {'hint' : 'template', 'parameters' : $templateParameters, 'source' : $templateReference})
#set ($groupReference = $services.model.createDocumentReference('', 'XWiki', 'MyGroup'))
#set ($user1Reference = $services.model.createDocumentReference('', 'XWiki', 'User1'))
#set ($user2Reference = $services.model.createDocumentReference('', 'XWiki', 'User2'))
#set ($source = {'groups' : [$groupReference], 'users' : [$user1Reference, $user2Reference], 'emails' : ['john@doe.com']})
#set ($messages = $services.mailsender.createMessages('usersandgroups', $source, $parameters))
#set ($mailResult = $services.mailsender.send($messages, 'database'))
{{/velocity}}
Deprecated and Retired projects
<description of deprecated and retired projects>
Upgrades
The following dependencies have been upgraded:
- <list libraries that have been upgraded>
Miscellaneous
- $datetool has a new method to access the DateFormatSymbols:{{velocity}}
#set ($currentLocale = $services.localization.currentLocale)
#set ($dateFormatSymbols = $datetool.getDateFormatSymbols($currentLocale))
$jsontool.serialize($dateFormatSymbols.shortMonths)
## Output for French locale:
## ["janv.","févr.","mars","avr.","mai","juin","juil.","août","sept.","oct.","nov.","déc.",""]
{{/velocity}} - Message Stream script service now offers a getLastError() method to get the last error.
Translations
The following translations have been updated:
Tested Browsers & Databases
Performances tests compared to <last super stable version>
<a summary of the comparison with latest super stable version>
More details on <link to the test report>.
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 6.4.1:
