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 milestone contains a new mail API and module to replace the old mailsender plugin, Flamingo skin and Extension Manager improvements as well as various performances improvements and bug fixes.
8
9 = New and Noteworthy (since XWiki 6.1 Milestone 1) =
10
11 [[Full list of issues fixed and Dashboard for 6.1>>https://jira.xwiki.org/secure/Dashboard.jspa?selectPageId=12290]].
12
13 == Experimental Flamingo Skin ==
14
15 * Flamingo skin CSS is now computed at the runtime, using the [[LESS Module>>extensions:Extension.LESS Module]].
16 * Thanks to this, we have introduced a compatibility between this skin and the old color themes:
17 [[[[image:flamingo-default.png||width="32%"]]>>attach:flamingo-default.png]] [[[[image:flamingo-dusk.png||width="32%"]]>>attach:flamingo-dusk.png]] [[[[image:flamingo-mint.png||width="32%"]]>>attach:flamingo-mint.png]] [[[[image:flamingo-ruby.png||width="32%"]]>>attach:flamingo-ruby.png]] [[[[image:flamingo-nocolortheme.png||width="32%"]]>>attach:flamingo-nocolortheme.png]]
18 * Flamingo has a simplified Add menu
19 [[[[image:flamingo-menu.png]]>>attach:flamingo-menu.png]]
20 * A lot of fixes and polishing have been made too (changes to the layout, panels, menus).
21
22 == Applications Panel ==
23
24 The applications panel has been modified to adapt itself to the panel column width. The design is different when the size is small, to look closer to a "dock" bar:
25 [[[[image:appbar.png||width="32%"]]>>attach:appbar.png]] (on this screenshot you can see the small version on the left, and the normal version on the right).
26
27 == Extension Manager improvements ==
28
29 Extension-related jobs (install, uninstall, install plan calculation, etc.) which are not executing on the same namespace can now be run concurrently. You won't be stuck anymore, trying to install an extension when someone else is doing the same thing somewhere else on a farm.
30
31 == Miscellaneous ==
32
33 * [[extensions:Extension.SpaceIndex Macro]] has now a new parameter to sort the document by creation date, modification date, or by name.
34 * User Profile page display email hyperlink (if the email is not obfuscated) on view and preview mode.
35 * The SOLR index synchronization which is automatically run at XWiki startup can now be disabled using ##solr.synchronizeAtStartup## property in ##xwiki.properties## file
36
37 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-2%22&tempMax=1000]] fixed in this release.
38
39 = For Developers =
40
41 == LESS module ==
42
43 * The [[LESS Module>>extensions:Extension.LESS Module]] is now bundled with XWiki Enterprise.
44 * Some progress have been made on the DefaultLESSSkinFileCache. The cache is now cleared when a skin or a color theme is changed, but only on the concerned wiki.
45 * The LESS Compiler now compress the generated CSS.
46 * A new component has been added to compute a Color Theme compatible with [[extensions:Extension.Color Theme Application]] from a LESS file.
47
48 == New Mail module (Experimental) ==
49
50 Allows to send mails in Java and from wiki pages.
51
52 See [[Mail Sender API>>extensions:Extension.Action API]] for all details.
53
54 Example to send an email from a wiki page:
55
56 {{code language="none"}}
57 {{velocity}}
58 #set ($message = $services.mailsender.createMessage("[email protected]", "[email protected]", "subject"))
59 #set ($discard = $message.addPart("text/plain", "text content"))
60 #set ($discard = $message.send())
61 #set ($discard = $message.waitTillSent(10000))
62 #foreach ($error in $message.getErrors())
63 * $error.message
64 #end
65 {{/velocity}}
66 {{/code}}
67
68 == Job module improvements ==
69
70 A new ##org.xwiki.job.JobExecutor## component has been introduce to replace ##org.xwiki.job.JobManager## (which is now deprecated). This component adds support for parallel execution of jobs and also support grouping jobs that need to be executed in the same thread.
71
72 See [[extensions:Extension.Job Module]] for more details.
73
74 == Upgrades ==
75
76 The following dependencies have been upgraded:
77
78 * [[Groovy 2.3.3>>https://jira.xwiki.org/browse/XCOMMONS-598]]
79 * [[Official LESS Compiler for Java 1.7.0.1.1>>https://jira.xwiki.org/browse/XWIKI-10437]]
80 * [[Apache Lucene and Solr 4.8.1>>https://jira.xwiki.org/browse/XWIKI-10357]]
81
82 == Miscellaneous ==
83
84 * xwiki.cfg file properties are now accessible through ##org.xwiki.configuration.ConfigurationSource## component with role hint ##xwikicfg##
85 * Complete refactoring of the [[Resource module>>extensions:Extension.Resource API]]. Note that the Action module has been removed and folded into the new Resource module.
86 * The ##getInstance## methods in the [[Component Script Service>>extensions:Extension.Component Module||anchor="HAccessfromScripts"]] are now public and return ##null## if the Component cannot be looked up. A ##getLastError()## method was also added to get the last exception.
87 * New converter for ##java.lang.refect.Type## which allows converting from String to Type and opposite in Velocity and wiki macros parameters for example.
88 * The wiki manager API always returns a descriptor for the main wiki, and if there is no descriptor document it returns a "virtual" one that can be saved. Basically it now means that if a wiki exists there is always a corresponding descriptor, even for the main wiki.
89 * The "skin" parameter in the URL is now taken into account when generating the links to the skin CSS (see: [[XWIKI-10426>>https://jira.xwiki.org/browse/XWIKI-10426]]).
90 * Filesystem Attachment Storage now allows you to disable cleaning of empty directories on startup since on a large installation this may take considerable time. (see: [[XWIKI-10431>>https://jira.xwiki.org/browse/XWIKI-10431]])
91 * Start of implementation of the [[Resource Reference Serializer>>extensions:Extension.Resource API]] notion, still need more work.
92
93 = Translations =
94
95 The following translations have been updated:
96
97 {{language codes="none, none"/}}
98
99 = Tested Browsers & Databases =
100
101 {{include reference="TestReports.ManualTestReportXWiki61M2Summary"/}}
102
103 = Known issues =
104
105 * [[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]]
106
107 = Backward Compatibility and Migration Notes =
108
109 == General Notes ==
110
111 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.
112
113 == API Breakages ==
114
115 The following APIs were modified since XWiki 6.0:
116
117 * Young APIs
118
119 {{code language="none"}}
120 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
121 org.xwiki.activeinstalls.server.DataManager: Method 'public long getInstallCount(java.lang.String)' has been removed
122 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
123 org.xwiki.activeinstalls.server.script.ActiveInstallsScriptService: Method 'public long getInstallCount(java.lang.String)' has been removed
124 {{/code}}
125
126 {{code language="none"}}
127 org.xwiki.crypto.store.CertificateStore: Class org.xwiki.crypto.store.CertificateStore removed
128 org.xwiki.crypto.store.CertificateStoreException: Class org.xwiki.crypto.store.CertificateStoreException removed
129 org.xwiki.crypto.store.KeyStore: Class org.xwiki.crypto.store.KeyStore removed
130 org.xwiki.crypto.store.KeyStoreException: Class org.xwiki.crypto.store.KeyStoreException removed
131 {{/code}}
132
133 * Not supposed to be public
134
135 {{code language="none"}}
136 com.xpn.xwiki.store.XWikiHibernateBaseStore: In method 'protected void createHibernateSequenceIfRequired(java.lang.String, org.hibernate.Session)' the number of arguments has changed
137 com.xpn.xwiki.render.XWikiMacrosMappingRenderer: Removed org.xwiki.observation.EventListener from the set of implemented interfaces
138 com.xpn.xwiki.render.XWikiMacrosMappingRenderer: Method 'public java.util.List getEvents()' has been removed
139 com.xpn.xwiki.render.XWikiMacrosMappingRenderer: Method 'public java.lang.String getName()' has been removed
140 com.xpn.xwiki.render.XWikiMacrosMappingRenderer: Method 'public void onEvent(org.xwiki.observation.event.Event, java.lang.Object, java.lang.Object)' has been removed
141 {{/code}}

Get Connected