Version 40.3 by Manuel Smeria on 2014/08/04

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) =
10
11 [[Full list of issues fixed and Dashboard for <version>>>http://jira.xwiki.org/secure/Dashboard.jspa?selectPageId=<fill id here>]].
12
13 == Flamingo Skin ==
14
15 * The user profile looks better on smartphones:(((
16 {{image reference="flamingo-user-profile.png" width="12%"/}}
17 )))
18
19 == New structure for apps created with App Within Minutes ==
20
21 When you create a new application using AWM, your application will be structured into 2 spaces (one for data and the other for code). For more details, see [[AWM's documentation>>extensions:Extension.App Within Minutes Application||anchor="HApplicationStructure"]].
22
23 {{image reference="AppWithinMinutes-Step1.png"/}}
24
25 == Initialization screen improvements ==
26
27 If XWiki initialization failed you get a detailed log and it stop refreshing the page.
28
29 {{image reference="init_errors.png"/}}
30
31 == Miscellaneous ==
32
33 * When using the standalone package, the logs can also be found in files under ##data/logs/##.
34 * The jetty configuration is now split in several files, making it easier to configure the needed parts.
35 * There's a sample configuration file for enabling HTTPS for the standalone Jetty server.
36 * The port on which Jetty listens for request can be configured using the ##JETTY_PORT## environment variables; ##JETTY_STOP_PORT## can be used to configure the port where stop commands are expected.
37 * Jetty's messages are now more informative: internal information isn't displayed, while notifications for the users are printed both at startup and shutdown.
38 * Single line fields in documents are not merged at character level anymore. This might increase a bit the number of potential conflicts but at the same time improve the suggestion in most cases in case of real conflict since most of the time this kind of field cannot really be merged.
39 * The XWiki Snapshots maven extensions repository is now used by default (when no other repositories are configured) on snapshot/development builds of XWiki Enterprise in order to make the testing of snapshot builds easier and faster.
40
41 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.2-milestone-1%22&tempMax=1000]] fixed in this release.
42
43 = For Developers =
44
45 == Wiki module improvements ==
46
47 * Added an API to directly get the wiki identifiers:
48 ** From Velocity:(((
49 {{code language="velocity"}}
50 #set($wikiIds = $services.wki.allIds)
51 {{/code}}
52 )))
53 ** From Java:(((
54 {{code language="java"}}
55 Collection<String> wikiIds = wikiDescriptorManager.getAllIds();
56 {{/code}}
57 )))
58
59 == The ##XWiki.widgets.ConfirmationBox## widget can display a //Cancel// button ==
60
61 By passing the ##showCancelButton : true## option in the ##interactionParameters## argument to the constructor, a //Cancel// button will be displayed next to the //Yes// and //No// ones. The label of the button can be specified with the ##cancelButtonText## interaction option, and an optional callback to execute with the ##onCancel## behavior option.
62
63 == The ##XWiki.widgets.ModalPopup#createButton## method now accepts an ##extraClass## parameter ==
64
65 The fifth parameter can be used to add additional classes, besides the standard ##button##, to the created buttons.
66
67 == WikiStream module renamed to Filter module ==
68
69 The heart of WikiStream being far more generic than wikis, most of it have been moved to commons in the already existing [[Filter module>>extensions:Extension.Filter Module]].
70
71 Most of WikiStream module moved to commons filter module (everything that wasn't really depending on any platform project) and it also been renamed to ##Filter## on platform side to follow commons naming. The structure of the API did not changed a bit except for the naming. In short every "WikiStream" in your code should be changed to ##Filter## or ##FilterStream##. None of the existing streams identifiers changed except for the generic XML streams which is is now ##filter+xml## (instead of wiki+xml).
72
73 == Mail Sender API ==
74
75 * The new [[Mail Sender API>>extensions:Extension.Action API]] is now bundled by default in XWiki Enterprise.
76 * It's now possible to access the Mail Sending API configuration from scripts by calling ##$services.mailsender.configuration##.
77 * The ##send()## API now sends messages synchronously and a new ##sendAsynchronously()## API has been added
78 * Using the following will now automatically add a template body part too:(((
79 {{code language="none"}}
80 #set ($message = $services.mailsender.createMessage('template', $templateReference, $mailParameters)
81 {{/code}}
82 )))
83 * In addition the "template" Mime Message Factory supports passing "to", "from", "cc" and "bcc" addresses in the parameters list, for example:(((
84 {{code language="none"}}
85 #set ($mailParameters = {'from' : 'localhost@xwiki.org', 'to' : 'john@doe.com', 'language' : $xcontext.language, 'velocityVariables' : { 'var1' : 'value1' }})
86 #set ($message = $services.mailsender.createMessage('template', $templateReference, $mailParameters)
87 {{/code}}
88 )))
89
90 == Deprecated and Retired projects ==
91
92 <description of deprecated and retired projects>
93
94 == Upgrades ==
95
96 The following dependencies have been upgraded:
97
98 * [[Bootstrap 3.2.0>>http://jira.xwiki.org/browse/XWIKI-10579]]
99 * [[HTML5Shiv 3.7.2>>http://jira.xwiki.org/browse/XWIKI-10615]]
100 * [[Jetty 8.1.15>>http://jira.xwiki.org/browse/XWIKI-10653]]
101 * [[Maven 3.2.2>>http://jira.xwiki.org/browse/XCOMMONS-616]]
102 * [[JFreechart 1.0.19>>http://jira.xwiki.org/browse/XWIKI-10689]]
103 * [[Joda-Time 2.4>>http://jira.xwiki.org/browse/XWIKI-10692]]
104 * [[xalan 2.7.2>>http://jira.xwiki.org/browse/XWIKI-10694]]
105 * [[Groovy 2.3.6>>http://jira.xwiki.org/browse/XCOMMONS-625]]
106
107 == Miscellaneous ==
108
109 * The user of an Activity Stream event is now always stored as an absolute serialized reference. See [[XWIKI-9066>>http://jira.xwiki.org/browse/XWIKI-9066]] for more details.
110 * A new user and group references related reference resolver have been provided:(((
111 {{code language="java"}}
112 @Inject
113 @Named("user/current")
114 private DocumentReferenceResolver<String> currentUserDocumentResolver;
115
116 @Inject
117 @Named("user/current")
118 private EntityReferenceResolver<String> currentUserEntityResolver;
119
120 @Inject
121 @Named("user")
122 private EntityReferenceResolver<String> defaultUserEntityResolver;
123 {{/code}}
124 )))
125 * Each XWiki class property can now control how it's merged. Just need to overwrite ##com.xpn.xwiki.objects.classes.PropertyClass#mergeProperty## method.
126 * The target syntax is now part of the Rendering Context when the Rendering is used to render some Blocks (otherwise it's ##null##. For example when parsing content).
127 * Added new ##org.xwiki.rendering.renderer.printer.WriterWikiPrinter## to output all calls to ##org.xwiki.rendering.renderer.printer.WikiPrinter## into a ##org.xwiki.rendering.renderer.printer.Writer##
128
129 = Translations =
130
131 The following translations have been updated:
132
133 {{language codes="none, none"/}}
134
135 = Tested Browsers & Databases =
136
137 {{include reference="TestReports.ManualTestReportXWiki62M1Summary"/}}
138
139 = Known issues =
140
141 * [[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]]
142
143 = Backward Compatibility and Migration Notes =
144
145 == General Notes ==
146
147 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.
148
149 == Issues specific to XWiki 6.2-milestone-1 ==
150
151 * After the upgrade, old Activity Stream events might now be visible anymore. Only new events will start to be displayed. See [[XWIKI-9066>>http://jira.xwiki.org/browse/XWIKI-9066]].
152 * The new Mail Sender API was using a property named ##smtp_from## when the from address was not specified when sending an email. Even though this property is used by the old Mail Sender plugin, it doesn't exist by default in ##XWikiPreferences##. We're now using the ##admin_email## property which is the one you see in the Admin UI.
153
154 == API Breakages ==
155
156 The following APIs were modified since <project> <version - 1>:
157
158 {{code language="none"}}
159 <clirr output here>
160 {{/code}}

Get Connected