Release Notes for XWiki 6.4-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 6.4-milestone-1)
Full list of issues fixed and Dashboard for <version>.
<feature N>
<description of feature N>
Miscellaneous
- The new Mail Sender API now checks for permission before sending emails, when using it from scripts (i.e. when using the Mail Sender Script Service). There are currently 2 possible strategies that you configure in your xwiki.properties file#-# [Since 6.4M2]
#-# Defines which authorization checks are done when sending mails using the Mail Sender Script Service.
#-# Example of valid values:
#-# - "programmingrights": the current document must have Programming Rights
#-# - "alwaysallow": no check is performed. This is useful when running XWiki in a secure environment where we
#-# want to allow all users to be able to send emails through the Script Service.
#-# The default is:
# mail.sender.scriptServiceCheckerHint = programmingrights
See the full list of JIRA issues fixed in this release.
For Developers
Mail Sender Permissions
There's now a pluggable permission checker used for checking if a mail should be sent, when using the Mail Sender Script Service. Two implementations are provided (see above) but you can also provide your own implementation by implementing the org.xwiki.mail.script.ScriptServicePermissionChecker component role:
@Unstable
public interface ScriptServicePermissionChecker
{
/**
* @param message the message to check for authorization
* @exception MessagingException if the message is not allowed to be sent
*/
void check(MimeMessage message) throws MessagingException;
}
For example you could imagine implementing checks on the size of the email or who the recipients are, run the content of the mail through some filter, etc.
Deprecated and Retired projects
<description of deprecated and retired projects>
Upgrades
The following dependencies have been upgraded:
Miscellaneous
<other dev stuff to add and link to JIRA for all issues fixed>
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 <project> <version - 1>:
