Last modified by Thomas Mortagne on 2017/03/24

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 Among others, this release adds various responsive UI improvements for the new Flamingo skin, a new structure for applications created with Application Within Minutes and the possibility to have alternative Icon Themes. Developers also get a new Mail Sender API and other API improvements. Finally, a considerable amount of bug fixes (31) and improvements (31) are provided so make sure to try it out.
8
9 = New and Noteworthy (since XWiki 6.1) =
10
11 [[Full list of issues fixed and Dashboard for 6.2>>https://jira.xwiki.org/secure/Dashboard.jspa?selectPageId=12494]].
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 == Icon Theme Application ==
32
33 A new application is now bundled in XWiki: [[extensions:Extension.Icon Theme Application]]. Its purpose is to let the user chose which icon set she would like to have in her wiki.
34
35 {{image reference="iconset-administration.png"/}}
36
37 This application is compatible with icon stored as images but also with font icons such as [[FontAwesome>>http://fortawesome.github.io/Font-Awesome/]]!
38
39 == Font Awesome ==
40
41 [[Font Awesome>>extensions:Extension.Font Awesome Icon Theme]] is our first alternative to [[silk>>http://www.famfamfam.com/lab/icons/silk/]] as an Icon Theme. It is now bundled in XWiki, but the Icon Theme mapping is still at a beta state.
42
43 == Application Bar ==
44
45 * The icons are now bigger.
46 * The icons displayed in the application bar use the new Icon Theme Application, in order to let the user choose the icon set she wants to see:
47 \\{{image reference="appbar-with-fontawesome.png" width="40%"/}} {{image reference="appbar-with-silk.png" width="40%"/}}
48 * On devices with small screen, when panels are displayed under the page content (currently, it is the case for Flamingo only), the appbar is now displayed differently to use all the available width:
49 \\{{image reference="AppBarLowRes.png"/}}
50
51 == Miscellaneous ==
52
53 * When using the standalone package, the logs can also be found in files under ##data/logs/##.
54 * The jetty configuration is now split in several files, making it easier to configure the needed parts.
55 * There's a sample configuration file for enabling HTTPS for the standalone Jetty server.
56 * 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.
57 * Jetty's messages are now more informative: internal information isn't displayed, while notifications for the users are printed both at startup and shutdown.
58 * 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.
59 * 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.
60
61 See the [[full list of JIRA issues>>https://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.
62
63 = For Developers =
64
65 == Wiki module improvements ==
66
67 * Added an API to directly get the wiki identifiers:
68 ** From Velocity:(((
69 {{code language="velocity"}}
70 #set($wikiIds = $services.wiki.allIds)
71 {{/code}}
72 )))
73 ** From Java:(((
74 {{code language="java"}}
75 Collection<String> wikiIds = wikiDescriptorManager.getAllIds();
76 {{/code}}
77 )))
78
79 == The ##XWiki.widgets.ConfirmationBox## widget can display a //Cancel// button ==
80
81 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.
82
83 == The ##XWiki.widgets.ModalPopup#createButton## method now accepts an ##extraClass## parameter ==
84
85 The fifth parameter can be used to add additional classes, besides the standard ##button##, to the created buttons.
86
87 == WikiStream module renamed to Filter module ==
88
89 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]].
90
91 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).
92
93 == Mail Sender API ==
94
95 * The new [[Mail Sender API>>extensions:Extension.Action API]] is now bundled by default in XWiki Enterprise.
96 * It's now possible to access the Mail Sending API configuration from scripts by calling ##$services.mailsender.configuration##.
97 * The ##send()## API now sends messages synchronously and a new ##sendAsynchronously()## API has been added
98 * Using the following will now automatically add a template body part too:(((
99 {{code language="none"}}
100 #set ($message = $services.mailsender.createMessage('template', $templateReference, $mailParameters)
101 {{/code}}
102 )))
103 * In addition the "template" Mime Message Factory supports passing "to", "from", "cc" and "bcc" addresses in the parameters list, for example:(((
104 {{code language="none"}}
105 #set ($mailParameters = {'from' : '[email protected]', 'to' : '[email protected]', 'language' : $xcontext.language, 'velocityVariables' : { 'var1' : 'value1' }})
106 #set ($message = $services.mailsender.createMessage('template', $templateReference, $mailParameters)
107 {{/code}}
108 )))
109
110 == Upgrades ==
111
112 The following dependencies have been upgraded:
113
114 * [[Bootstrap 3.2.0>>https://jira.xwiki.org/browse/XWIKI-10579]]
115 * [[HTML5Shiv 3.7.2>>https://jira.xwiki.org/browse/XWIKI-10615]]
116 * [[Jetty 8.1.15>>https://jira.xwiki.org/browse/XWIKI-10653]]
117 * [[Maven 3.2.2>>https://jira.xwiki.org/browse/XCOMMONS-616]]
118 * [[JFreechart 1.0.19>>https://jira.xwiki.org/browse/XWIKI-10689]]
119 * [[Joda-Time 2.4>>https://jira.xwiki.org/browse/XWIKI-10692]]
120 * [[xalan 2.7.2>>https://jira.xwiki.org/browse/XWIKI-10694]]
121 * [[Groovy 2.3.6>>https://jira.xwiki.org/browse/XCOMMONS-625]]
122
123 == Miscellaneous ==
124
125 * The user of an Activity Stream event is now always stored as an absolute serialized reference. See [[XWIKI-9066>>https://jira.xwiki.org/browse/XWIKI-9066]] for more details.
126 * A new user and group references related reference resolver have been provided:(((
127 {{code language="java"}}
128 @Inject
129 @Named("user/current")
130 private DocumentReferenceResolver<String> currentUserDocumentResolver;
131
132 @Inject
133 @Named("user/current")
134 private EntityReferenceResolver<String> currentUserEntityResolver;
135
136 @Inject
137 @Named("user")
138 private EntityReferenceResolver<String> defaultUserEntityResolver;
139 {{/code}}
140 )))
141 * Each XWiki class property can now control how it's merged. Just need to overwrite ##com.xpn.xwiki.objects.classes.PropertyClass#mergeProperty## method.
142 * 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).
143 * 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##
144 * Added the new component ##org.xwiki.skinx.internal.LinkSkinExtension## (with the hint "##linkx##") that wraps the ##$xwiki.linkx## plugin
145
146 = Translations =
147
148 The following translations have been updated:
149
150 {{language codes="da, lv, de, fr, ru"/}}
151
152 = Tested Browsers & Databases =
153
154 {{include reference="TestReports.ManualTestReportXWiki62M1Summary"/}}
155
156 = Known issues =
157
158 * [[Bugs we know about>>https://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]]
159
160 = Backward Compatibility and Migration Notes =
161
162 == General Notes ==
163
164 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.
165
166 == Issues specific to XWiki 6.2-milestone-1 ==
167
168 * After the upgrade, old Activity Stream events might not be visible anymore. Only new events will start to be displayed. See [[XWIKI-9066>>https://jira.xwiki.org/browse/XWIKI-9066]].
169 * 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.
170
171 == API Breakages ==
172
173 The following APIs were modified since XWiki 6.1:
174
175 * Young APIs.
176
177 {{code language="none"}}
178 org.xwiki.rendering.transformation.RenderingContext: Method 'public org.xwiki.rendering.syntax.Syntax getTargetSyntax()' has been added to an interface
179 {{/code}}
180
181 {{code language="none"}}
182 org.xwiki.wiki.descriptor.WikiDescriptorManager: Method 'public java.util.Collection getAllIds()' has been added to an interface
183
184 org.xwiki.mail.MailSender: Method 'public void send(javax.mail.internet.MimeMessage, javax.mail.Session, org.xwiki.mail.MailResultListener)' has been removed
185 org.xwiki.mail.MailSender: Method 'public void sendAsynchronously(javax.mail.internet.MimeMessage, javax.mail.Session, org.xwiki.mail.MailResultListener)' has been added to an interface
186 org.xwiki.mail.MailResultListener: Parameter 2 of 'public void onError(javax.mail.internet.MimeMessage, java.lang.Throwable)' has changed its type to java.lang.Exception
187 org.xwiki.mail.script.MimeMessageWrapper: Parameter 1 of 'public MimeMessageWrapper(javax.mail.internet.MimeMessage, javax.mail.Session, org.xwiki.mail.MailSender, org.xwiki.context.Execution, org.xwiki.component.manager.ComponentManager)' has changed its type to org.xwiki.mail.internal.ExtendedMimeMessage
188 org.xwiki.mail.script.MimeMessageWrapper: Return type of method 'public javax.mail.internet.MimeMessage getMessage()' has been changed to org.xwiki.mail.internal.ExtendedMimeMessage
189 {{/code}}

Get Connected