Hide last authors
Eduard Moraru 1.1 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
Eduard Moraru 52.2 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.
Eduard Moraru 1.1 8
Thomas Mortagne 9.1 9 = New and Noteworthy (since XWiki 6.1) =
Eduard Moraru 1.1 10
Thomas Mortagne 54.1 11 [[Full list of issues fixed and Dashboard for 6.2>>https://jira.xwiki.org/secure/Dashboard.jspa?selectPageId=12494]].
Eduard Moraru 1.1 12
Guillaume Delhumeau 15.1 13 == Flamingo Skin ==
Eduard Moraru 1.1 14
Guillaume Delhumeau 15.1 15 * The user profile looks better on smartphones:(((
16 {{image reference="flamingo-user-profile.png" width="12%"/}}
17 )))
Eduard Moraru 1.1 18
Eduard Moraru 4.2 19 == New structure for apps created with App Within Minutes ==
20
Eduard Moraru 4.3 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"]].
Eduard Moraru 4.2 22
23 {{image reference="AppWithinMinutes-Step1.png"/}}
24
Thomas Mortagne 31.1 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
Guillaume Delhumeau 42.1 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
Guillaume Delhumeau 47.1 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
Guillaume Delhumeau 46.1 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%"/}}
Guillaume Delhumeau 52.1 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:
Guillaume Delhumeau 50.1 49 \\{{image reference="AppBarLowRes.png"/}}
Guillaume Delhumeau 46.1 50
Eduard Moraru 1.1 51 == Miscellaneous ==
52
Sergiu Dumitriu 25.1 53 * When using the standalone package, the logs can also be found in files under ##data/logs/##.
Sergiu Dumitriu 26.1 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.
Thomas Mortagne 28.1 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.
Eduard Moraru 29.1 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.
Eduard Moraru 1.1 60
Thomas Mortagne 54.1 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.
Eduard Moraru 1.1 62
63 = For Developers =
64
Thomas Mortagne 2.1 65 == Wiki module improvements ==
Eduard Moraru 1.1 66
Vincent Massol 21.3 67 * Added an API to directly get the wiki identifiers:
68 ** From Velocity:(((
Thomas Mortagne 2.1 69 {{code language="velocity"}}
Guillaume Delhumeau 48.1 70 #set($wikiIds = $services.wiki.allIds)
Thomas Mortagne 2.1 71 {{/code}}
Vincent Massol 21.3 72 )))
73 ** From Java:(((
Thomas Mortagne 2.1 74 {{code language="java"}}
75 Collection<String> wikiIds = wikiDescriptorManager.getAllIds();
76 {{/code}}
77 )))
78
Sergiu Dumitriu 22.1 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
Thomas Mortagne 23.1 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
Vincent Massol 24.2 93 == Mail Sender API ==
Vincent Massol 24.1 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
Vincent Massol 30.1 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 )))
Vincent Massol 24.1 109
Eduard Moraru 1.1 110 == Upgrades ==
111
Guillaume Delhumeau 6.1 112 The following dependencies have been upgraded:
Eduard Moraru 1.1 113
Thomas Mortagne 54.1 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]]
Eduard Moraru 1.1 122
123 == Miscellaneous ==
124
Thomas Mortagne 54.1 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.
Thomas Mortagne 16.1 126 * A new user and group references related reference resolver have been provided:(((
127 {{code language="java"}}
128 @Inject
129 @Named("user/current")
Thomas Mortagne 17.1 130 private DocumentReferenceResolver<String> currentUserDocumentResolver;
Eduard Moraru 1.2 131
Thomas Mortagne 16.1 132 @Inject
133 @Named("user/current")
Thomas Mortagne 17.1 134 private EntityReferenceResolver<String> currentUserEntityResolver;
Thomas Mortagne 16.1 135
136 @Inject
137 @Named("user")
Thomas Mortagne 17.1 138 private EntityReferenceResolver<String> defaultUserEntityResolver;
Thomas Mortagne 16.1 139 {{/code}}
140 )))
Thomas Mortagne 19.1 141 * Each XWiki class property can now control how it's merged. Just need to overwrite ##com.xpn.xwiki.objects.classes.PropertyClass#mergeProperty## method.
Vincent Massol 21.2 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).
Thomas Mortagne 33.1 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##
Guillaume Delhumeau 43.1 144 * Added the new component ##org.xwiki.skinx.internal.LinkSkinExtension## (with the hint "##linkx##") that wraps the ##$xwiki.linkx## plugin
Thomas Mortagne 16.1 145
Eduard Moraru 1.1 146 = Translations =
147
148 The following translations have been updated:
149
Eduard Moraru 52.3 150 {{language codes="da, lv, de, fr, ru"/}}
Eduard Moraru 1.1 151
152 = Tested Browsers & Databases =
153
Manuel Smeria 40.2 154 {{include reference="TestReports.ManualTestReportXWiki62M1Summary"/}}
Eduard Moraru 1.1 155
156 = Known issues =
157
Thomas Mortagne 54.1 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]]
Eduard Moraru 1.1 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
Vincent Massol 12.1 166 == Issues specific to XWiki 6.2-milestone-1 ==
Eduard Moraru 1.1 167
Thomas Mortagne 54.1 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]].
Vincent Massol 12.1 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.
Eduard Moraru 1.2 170
Eduard Moraru 1.1 171 == API Breakages ==
172
Eduard Moraru 52.4 173 The following APIs were modified since XWiki 6.1:
Eduard Moraru 1.1 174
Eduard Moraru 52.4 175 * Young APIs.
176
Eduard Moraru 1.1 177 {{code language="none"}}
Eduard Moraru 52.4 178 org.xwiki.rendering.transformation.RenderingContext: Method 'public org.xwiki.rendering.syntax.Syntax getTargetSyntax()' has been added to an interface
Eduard Moraru 1.1 179 {{/code}}
Eduard Moraru 52.4 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