Version 14.4 by Vincent Massol on 2014/06/19

Show last authors
1 {{box cssClass="floatinginfobox" title="**Contents**"}}
2 {{toc/}}
3 {{/box}}
4
5 This is the release notes for [[XWiki Commons>>http://commons.xwiki.org]], [[XWiki Rendering>>http://rendering.xwiki.org]], [[XWiki Platform>>http://platform.xwiki.org]] and [[XWiki Enterprise>>http://enterprise.xwiki.org]]. They share the same release notes as they are released together and have the same version.
6
7 <insert description of release here>
8
9 = New and Noteworthy (since XWiki 6.1 milestone 2) =
10
11 [[Full list of issues fixed and Dashboard for 6.1>>http://jira.xwiki.org/secure/Dashboard.jspa?selectPageId=12290]].
12
13 == Flamingo Skin ==
14
15 * The preview action has been implemented:(((
16 {{image reference="preview.png" width="60%"/}}
17 )))
18 * A lot of polishing have been made too, in order to have a skin usable in production.
19
20 == Miscellaneous ==
21
22 <insert misc user stuff and important bug fix descriptions here in a list, when they are too small to warrant a section by themselves - Change the version in the URL below!>
23
24 See the [[full list of JIRA issues>>http://jira.xwiki.org/sr/jira.issueviews:searchrequest-printable/temp/SearchRequest.html?jqlQuery=project+in+%28XCOMMONS%2C+XRENDERING%2C+XWIKI%2C+XE%29+and+status+%3D+Closed+and+resolution+%3D+Fixed+and+fixVersion+%3D+%226.1-rc-1%22&tempMax=1000]] fixed in this release.
25
26 = For Developers =
27
28 == Log from a script ==
29
30 A new API to get a SLF4J Logger has been added to the ##logging## script service.
31
32 {{code language="velocity"}}
33 $services.logging.getLogger('My script').info('Hello {}', 'world')
34 {{/code}}
35
36 == New contextual authorization manager role ==
37
38 A new role is now available to ease the replacement of the old Right Service (com.xpn.xwiki.user.api.XWikiRightService).
39 Compared to the old service, the component does not manage authentication which should have been ensured previously if needed. (No redirection to login is ever done)
40 The new component has a similar interface to the AuthorizationManager, but it take care of all external context aspects, like the currently executed macro block, the rendering context restrictions, the dropping of rights, etc...
41 This new role should be used from now on by any component that needs to check rights for the current user, in the current context.
42
43 == New security authorization script service ==
44
45 A new script service is now available to access the default AuthorizationManager and the ContextualAuthorizationManager.
46
47 Here is some sample:
48
49 {{code language="velocity"}}
50 #if ($services.security.authorization.hasAccess("edit"))
51 ... show some UI that require edit access on the current document by the current user ...
52 #end
53 #if ($services.security.authorization.hasAccess("edit", "xwiki:Sandbox.TestPage1"))
54 ... show some UI that require edit access on Sandbox.TestPage1 document by the current user ...
55 #end
56 #if ($services.security.authorization.hasAccess("edit", "xwiki:XWiki.User1", "xwiki:Sandbox.TestPage1"))
57 ... show some UI that require edit access on Sandbox.TestPage1 document by XWiki.User1 ...
58 #end
59 {{/code}}
60
61 {{code language="velocity"}}
62 $services.security.authorization.checkAccess("edit")
63 ... do some task that require edit access ...
64 {{/code}}
65
66 In this second sample, the macro will fail with an AccessDeniedException if the right is not allowed.
67
68 == Deprecated and Retired projects ==
69
70 <description of deprecated and retired projects>
71
72 == Upgrades ==
73
74 The following dependencies have been upgraded:
75
76 * [[commons-collections 4.0>>http://jira.xwiki.org/browse/XCOMMONS-605]]
77 * [[httpclient 4.3.4>>http://jira.xwiki.org/browse/XCOMMONS-606]]
78 * [[commons-beanutils 1.9.2>>http://jira.xwiki.org/browse/XCOMMONS-607]]
79 * [[reflections 0.9.9-RC2>>http://jira.xwiki.org/browse/XCOMMONS-608]]
80 * [[slf4j 1.7.7>>http://jira.xwiki.org/browse/XCOMMONS-609]]
81
82 == Miscellaneous ==
83
84 * The [[Mail Sender API>>extensions:Extension.Mail Sender API]] now allows to send Mails from a Template. This is achieved with 2 calls:
85 ** One for setting the Subject from the Template. The following will generate a ##MimeMessage## with the subject pre-filled. The value will be that of the ##subject## xproperty from an ##XWiki.Mail## xobject in the Document pointed to by the passed ##documentReference##:(((
86 {{code language="none"}}
87 #set ($message = $services.mailsender.createMessage("template", documentReference, to))
88 #set ($message = $services.mailsender.createMessage("template", documentReference, from, to))
89 {{/code}}
90 )))
91 ** One for setting the Body Part content from the Template:(((
92 {{code language="none"}}
93 $message.addPart("xwiki/template", $documentReference, {"velocityVariables" : { "var1" : "value1" }})
94 $message.addPart("xwiki/template", $documentReference, {"velocityVariables" : { "var1" : "value1" }, "attachments" : $attachments})
95 {{/code}}
96 )))
97
98 = Translations =
99
100 The following translations have been updated:
101
102 {{language codes="none, none"/}}
103
104 = Tested Browsers & Databases =
105
106 {{include reference="TestReports.ManualTestReportTemplateSummary"/}}
107
108 = Known issues =
109
110 * [[Bugs we know about>>http://jira.xwiki.org/secure/IssueNavigator.jspa?reset=true&jqlQuery=category+%3D+%22Top+Level+Projects%22+AND+issuetype+%3D+Bug+AND+resolution+%3D+Unresolved+ORDER+BY+updated+DESC]]
111
112 = Backward Compatibility and Migration Notes =
113
114 == General Notes ==
115
116 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.
117
118 == Issues specific to XWiki <version> ==
119
120 <issues specific to the project>
121
122 == API Breakages ==
123
124 The following APIs were modified since <project> <version - 1>:
125
126 {{code language="none"}}
127 <clirr output here>
128 {{/code}}

Get Connected