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 This release mostly focuses on the Flaming skin and sets it as the new default skin for XWiki. A new themes application for the new skin is introduces, along with the AppBar set by default and other various UI polishes and improvements. On the developers side, a new "blame" API has been introduced and some dependencies were upgraded. Finally, a considerable amount of bug fixes (34) and improvements (32) were made so make sure to try it out.
8
9 {{info}}
10 Since the Flamingo skin is now the default skin and we wish to make it as good as possible for the final 6.2 release, please report as many issues you notice in our [[Issue Tracker>>https://jira.xwiki.org/browse/XWIKI/component/13441]]. Thanks!
11 {{/info}}
12
13 = New and Noteworthy (since XWiki 6.2M1) =
14
15 [[Full list of issues fixed and Dashboard for 6.2>>https://jira.xwiki.org/secure/Dashboard.jspa?selectPageId=12494]].
16
17 == Flamingo ==
18
19 * **[[Flamingo>>extensions:Extension.Flamingo Skin]] is the new default skin in XWiki!**
20 * The [[applications panel>>extensions:Extension.Panels Application||anchor="HApplicationPanel"]] (also known as the "Applications Bar") has been set by default on the left panel.
21 * The default icon theme is now [[Font Awesome>>extensions:Extension.Font Awesome Icon Theme]].
22 * A new application has been made to manage color themes on Flamingo. It does not only permit to change colors anymore, but also the typography, etc... That is why it is called [[extensions:Extension.Flamingo Theme Application]].
23 {{image reference="FlamingoThemeEditor.png" width="50%"/}}
24 * By default, a new theme is enabled: ##FlamingoDefaultTheme##, made with the new application described above.
25 * [[extensions:Extension.Colibri Skin]] can use the themes from Flamingo thanks to a mapping between [[extensions:Extension.Flamingo Theme Application]] and [[extensions:Extension.Color Theme Application]]. The results may not be perfect though.
26 * Improved Login form(((
27 {{image reference="flamingoLogin.png"/}}
28 )))
29 * The page headers from Colibri ColorThemes can be displayed for Flamingo skin by setting the ##$displayPageHeader## to ##true## in ##layoutExtraVars.vm##. By default this variable is set to false(((
30 [[{{image reference="Flamingo_displayPageHeader_false.png" width="400px"/}}>>attach:Flamingo_displayPageHeader_false.png]] [[{{image reference="Flamingo_displayPageHeader_true.png" width="400px"/}}>>attach:Flamingo_displayPageHeader_true.png]]
31 )))
32 * You can control whether or not you want to display the create and the "more actions" menus with 2 new variables: ##$displayCreateMenu## and ##$displayMoreActionsMenu##. You can manually set them in the ##layoutExtraVars.vm## file.(((
33 You can see the results of all this changes in the following screenshot:
34 {{image reference="flamingo.png" width="65%"/}}
35 )))
36
37 == Miscellaneous ==
38
39 * ModalPopup and LightBox resource components are now responsive. For small resolutions their width will occupy the whole screen.(((
40 {{image reference="afterAddUsers.png"/}} {{image reference="afterSharebyEmail.png"/}}
41 )))
42 * Deleted document translations can now be restored, even if the main document or a different translation has already been restored (as long as no conflict exists). See [[XWIKI-9567>>https://jira.xwiki.org/browse/XWIKI-9567]] and the [[documentation>>extensions:Extension.Index Application||anchor="HRestoringatranslation"]].
43
44 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-2%22&tempMax=1000]] fixed in this release.
45
46 = For Developers =
47
48 == Building XWiki is now possible using Maven 3.1 and 3.2 ==
49
50 The packager Maven plugin was using temporary APIs used only in Maven 3.0, which [[made it impossible to build modules depending on that plugin with other versions of Maven than 3.0.x>>https://jira.xwiki.org/browse/XWIKI-9760]]. This has now been fixed, and the build works with any 3.x Maven version.
51
52 == Blame generic API and Script Service ==
53
54 Provides the implementation of the blame/annotate/praise algorithm.
55
56 Like the diff module API, this API is not tied to any type so you have to first transform the datas you want to blame into lists and you will be able to link them with any kind of revision metadata. Blame will link each elements of the initial list with the revision metadata of the original revision it came from. You will have to call blame in loop with each revised list, starting from the most recent one, until all element are annotated.
57
58 See [[Blame Module>>extensions:Extension.Blame Module]] for more information.
59
60 == Upgrades ==
61
62 The following dependencies have been upgraded:
63
64 * [[Velocity Tools 2.0>>https://jira.xwiki.org/browse/XWIKI-5347]]
65 * [[Jython 2.7-b3>>https://jira.xwiki.org/browse/XWIKI-10837]]
66 * [[httpclient 4.3.5>>https://jira.xwiki.org/browse/XCOMMONS-631]]
67 * [[Guava 18.0>>https://jira.xwiki.org/browse/XCOMMONS-632]]
68
69 == Miscellaneous ==
70
71 * New ##$doc.isTranslation()## method is available in the web API. See [[XWIKI-10805>>https://jira.xwiki.org/browse/XWIKI-10805]]
72 * ##xwiki-platform-font-awesome## has been moved in the ##xwiki-platform-icon## module and renamed ##xwiki-platform-icon-fontawesome##.
73 * [[Icon Theme>>extensions:Extension.Icon Theme Application]] can now use JavaScript Extensions.
74 * The [[Icon class>>https://github.com/xwiki/xwiki-platform/blob/master/xwiki-platform-core/xwiki-platform-icon/xwiki-platform-icon-api/src/main/java/org/xwiki/icon/Icon.java]] of the [[Icon Theme>>extensions:Extension.Icon Theme Application]] does not store the name of the icon anymore, since it is already stored in a map in the [[IconSet class>>https://github.com/xwiki/xwiki-platform/blob/master/xwiki-platform-core/xwiki-platform-icon/xwiki-platform-icon-api/src/main/java/org/xwiki/icon/IconSet.java]] (better memory usage).
75 * It is now possible to compile a LESS file or to compute a color theme from an other skin.
76 * ##xwiki-platform-less-css## has been renamed ##xwiki-platform-lesscss## in order to be consistent with our naming conventions.
77
78 = Tested Browsers & Databases =
79
80 {{include reference="TestReports.ManualTestReportXWiki62M2Summary"/}}
81
82 = Known issues =
83
84 * [[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]]
85
86 = Backward Compatibility and Migration Notes =
87
88 == General Notes ==
89
90 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.
91
92 == API Breakages ==
93
94 The following APIs were modified since XWiki 6.1:
95
96 * Young APIs:(((
97 {{code language="none"}}
98 org.xwiki.rendering.transformation.RenderingContext: Method 'public org.xwiki.rendering.syntax.Syntax getTargetSyntax()' has been added to an interface
99 {{/code}}
100
101 {{code language="none"}}
102 org.xwiki.wiki.descriptor.WikiDescriptorManager: Method 'public java.util.Collection getAllIds()' has been added to an interface
103 {{/code}}
104
105 {{code language="none"}}
106 org.xwiki.mail.MailSender: Method 'public void send(javax.mail.internet.MimeMessage, javax.mail.Session, org.xwiki.mail.MailResultListener)' has been removed
107 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
108 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
109 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
110 org.xwiki.mail.script.MimeMessageWrapper: Return type of method 'public javax.mail.internet.MimeMessage getMessage()' has been changed to org.xwiki.mail.internal.ExtendedMimeMessage
111 {{/code}}
112 )))
113 * The extended class got moved to a new package with the upgrade to velocity-tools 2.0 and the old location got deprecated.(((
114 {{code language="none"}}
115 org.xwiki.velocity.XWikiWebappResourceLoader: Removed org.apache.velocity.tools.view.servlet.WebappLoader from the list of superclasses
116 {{/code}}
117 )))

Get Connected