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 introduces the ability to change the width of the panel columns and comes with an improved Active Installs feature. Developers can now use the LESS preprocessor for skin style sheets. A couple of bug fixes (18) and some small improvements (24) make this release worth trying.
8
9 = New and Noteworthy (since XWiki 6.0) =
10
11 [[Full list of issues fixed and Dashboard for 6.1>>https://jira.xwiki.org/secure/Dashboard.jspa?selectPageId=12290]].
12
13 == Improved Active Installs ==
14
15 The [[Active Installs feature>>extensions:Extension.Active Installs Server Application]] has been improved a lot and a new data format has been set up in order to be able to provide more information, namely:
16
17 * Graphing of Active Installs counter over time
18 * Display pie charts of XWiki versions, Java versions, Servlet Containers and Databases used for Active Installs
19
20 {{image reference="as-dashboard" width="650px"/}}
21
22 In addition it's now registered in the Applications Panel:
23
24 {{image reference="activeinstallsentry.png"/}}
25
26 == Improved Panels ==
27
28 * It is now possible to change the width of the panel columns:
29
30 {{image reference="panelWizard.png" width="65%"/}}
31
32 * Inside a panel, you can know the current width with the ##$xwikiPanelWidth## variable.
33
34 == Miscellaneous ==
35
36 * The [[user directory>>extensions:Extension.User Directory Application]] is now displaying the user id (alias) instead of the full user document reference which is too technical:(((
37 {{image reference="userDirectory.png" width="400px"/}}
38 )))
39 * Added [[ability to configure Pie Chart labels>>extensions:Extension.Chart Macro]] using the ##pie_label_format## property. For example using ##pie_label_format:{0} - {2}## would give:(((
40 {{image reference="pielabel.png"/}}
41 )))
42 * XWiki now support resolving a Maven extension with a parent from a different Maven repository
43 * More HTTP cache settings, configurable using ##xwiki.httpheaders.cache## in ##xwiki.cfg## or ##headers_nocache## in ##XWiki.XWikiPreferences##:
44 ** ##0##: **no Cache-Control header** sent, use the browser's defaults. RFC 2616 only specifies optional behavior in this case
45 ** ##1## (default): **no-cache**; caches must not serve this response in a subsequent response, but the page is stored for the bf-cache
46 ** ##2##: **no-store, no-cache and max-age=0**; the response will never be reused, not even for bf-cache; note that unsaved changes may be lost
47 ** ##3##: **private**; the response will be cached by personal caches, such as a browser cache
48 ** ##4##: **public**; the response may be cached by both personal and shared caches
49 * To ensure the compatibility with Internet Explorer 8, the Flamingo skin uses [[Respond.js>>https://github.com/scottjehl/Respond]] and [[HTML5Shiv>>https://github.com/aFarkas/html5shiv/]]. It enables CSS3 media queries and HTML5 tags.
50 * "Human" requests like ##view## or ##edit## are not waiting XWiki initialization forever and display a waiting page with initialization progress instead: {{image reference="init.png"/}}
51
52 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.1-milestone-1%22&tempMax=1000]] fixed in this release.
53
54 = For Developers =
55
56 == LESS integration ==
57
58 * We are happy to propose the ability of using the [[LESS preprocessor>>http://lesscss.org/]] directly in XWiki. Right now, it is only able to compile some files located in the skin directory in the WAR. See [[extensions:Extension.LESS Module]].
59
60 == Upgrades ==
61
62 The following dependencies have been upgraded:
63
64 * [[Apache Lucene and Solr 4.8.0>>https://jira.xwiki.org/browse/XWIKI-10305]]
65 * [[Guava 17.0>>https://jira.xwiki.org/browse/XCOMMONS-570]]
66 * [[reflections 0.9.9-RC1>>https://jira.xwiki.org/browse/XCOMMONS-204]]
67 * [[Groovy 2.3.1>>https://jira.xwiki.org/browse/XCOMMONS-579]]
68 * [[Jackson 2.3.3>>https://jira.xwiki.org/browse/XCOMMONS-593]]
69 * [[sisu guice 3.2.1>>https://jira.xwiki.org/browse/XCOMMONS-592]]
70 * [[commons-compress 1.8.1>>https://jira.xwiki.org/browse/XCOMMONS-591]]
71 * [[cssparser 0.9.14>>https://jira.xwiki.org/browse/XCOMMONS-590]]
72 * [[commons-lang 3.3.2>>https://jira.xwiki.org/browse/XCOMMONS-589]]
73 * [[JGroups 3.4.4>>https://jira.xwiki.org/browse/XWIKI-10354]]
74
75 == Miscellaneous ==
76
77 * [[XCOMMONS-582>>https://jira.xwiki.org/browse/XCOMMONS-582]]: ##$escapetool.json## should be used instead of ##$escapetool.javascript## for escaping manually constructed JSON; ##$jsontool.serialize## should be used for generating JSON, though, since it is safer.
78 * Introduced job progress helper API, see [[Job Module>>doc:extensions:Extension.Job Module||anchor="HNotifyaboutprogress"]] for more details.
79 * All component related API of ##com.xpn.xwiki.web.Utils## are now using the context ##ComponentManager## by default.
80 * We added a new method to the component script service to access the component manager corresponding to a specific namespace:(((
81 {{code language=""}}
82 {{groovy}}
83 def instanceForTestWiki = services.component.getComponentManager("wiki:test").getInstance(SomeRole.class)
84 {{/groovy}}
85 {{/code}}
86 )))
87
88 = Translations =
89
90 The following translations have been updated:
91
92 {{language codes="de, fr"/}}
93
94 = Tested Browsers & Databases =
95
96 {{include reference="TestReports.ManualTestReportXWiki61M1Summary"/}}
97
98 = Known issues =
99
100 * [[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]]
101
102 = Backward Compatibility and Migration Notes =
103
104 == General Notes ==
105
106 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.
107
108 == API Breakages ==
109
110 The following APIs were modified since XWiki 6.0:
111
112 * Young API
113
114 {{code language="none"}}
115 org.xwiki.activeinstalls.server.DataManager: Method 'public com.google.gson.JsonObject countInstalls(java.lang.String, java.lang.String, java.util.Map)' has been added to an interface
116 org.xwiki.activeinstalls.server.DataManager: Method 'public long getInstallCount(java.lang.String)' has been removed
117 org.xwiki.activeinstalls.server.DataManager: Method 'public com.google.gson.JsonObject searchInstalls(java.lang.String, java.lang.String, java.util.Map)' has been added to an interface
118 org.xwiki.activeinstalls.server.script.ActiveInstallsScriptService: Method 'public long getInstallCount(java.lang.String)' has been removed
119 {{/code}}

Get Connected