Wiki source code of Release Notes for XWiki 6.0

Last modified by Thomas Mortagne on 2017/03/24

Hide last authors
Marius Dumitru Florea 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
Thomas Mortagne 15.1 7 First version of the 6.x cycle having for main theme performances. This version marks the move to Java 7 as minimum version and comes with a new experimental Flamingo skin, new chart renderers, WebJars support and many other improvements.
Marius Dumitru Florea 1.1 8
Vincent Massol 18.1 9 {{error}}
Thomas Mortagne 23.1 10 A packaging issue was found that lead to the [[wrong inclusion of the Servlet JAR>>https://jira.xwiki.org/browse/XWIKI-10336]] in XWiki's ##WEB-INF/lib## directory. Some containers (like Tomcat) will refuse to start if this JAR is present. To fix this, simply remove it. This issue is fixed in 6.0.1 and 6.1-milestone-1 (not released yet at this time of writing).
Vincent Massol 18.1 11 {{/error}}
Thomas Mortagne 20.1 12
Marius Dumitru Florea 1.1 13 = New and Noteworthy (since XWiki 5.4.4) =
14
Thomas Mortagne 23.1 15 [[Full list of issues fixed and Dashboard for 6.0>>https://jira.xwiki.org/secure/Dashboard.jspa?selectPageId=12193]].
Marius Dumitru Florea 1.1 16
Thomas Mortagne 6.1 17 == Moved to Java 7 as minimum version ==
18
19 The minimum required Java version to run XWiki is now Java 7. It's not just the minimum officially supported version, XWiki won't work anymore on Java 6.
20
Thomas Mortagne 6.7 21 == Wiki Application Improvements ==
22
23 * In the Wiki Index, all the wikis that the user can not access [[are not displayed anymore>>extensions:Extension.Wiki Application||anchor="HNewmenusandWikiIndex"]].
24 * Now, by default, guest users can see a subwiki depending if they can see the main one. But of course, it is still possible to manually give view right to guest users in the subwiki's administration.
25
26 == New Chart Renderers ==
27
28 The ##stackedbar## and ##stackedbar3D## plot renderers were added in the [[Chart Macro>>extensions:Extension.Chart Macro]]:
29
Thomas Mortagne 9.1 30 {{image reference="[email protected]"/}}
Thomas Mortagne 6.7 31
Thomas Mortagne 9.1 32 {{image reference="[email protected]"/}}
Thomas Mortagne 6.7 33
34 == Panels Application Improvements ==
35
36 * The [[Panels Application>>extensions:Extension.Panels Application]] is now available from the Applications Panel:(((
Thomas Mortagne 10.1 37 {{image reference="[email protected]"/}}
Thomas Mortagne 6.7 38 )))
39 * The Panels Application's home page now uses a LiveTable to display the list of available Panels:(((
Thomas Mortagne 10.1 40 {{image reference="[email protected]"/}}
Thomas Mortagne 6.7 41 )))
42
43 == Standard XAR import scalability ==
44
45 The standard XAR import (in administration) is now based on [[WikiStream>>extensions:Extension.WikiStream Module]] by default. This means that you should (at last) be able to import a XAR of any size (as long as you can attach it to the import page since that's how import UI is working right now).
46
47 You can put back old system if any issue using ##xwiki.action.import.xar.usewikistream## property in ##xwiki.cfg## file.
48
Guillaume Delhumeau 3.1 49 == New experimental Flamingo skin ==
Marius Dumitru Florea 1.1 50
Thomas Mortagne 6.7 51 A new skin is now bundled in XWiki: **Flamingo**. The skin use the well-known [[Bootstrap framework>>http://getbootstrap.com/]] framework which gives us a modern look-and-feel and makes the UI responsive and thus working on mobile devices.
52
53 {{warning}}
54 The skin is currently an alpha version and should not be used in production. In addition, only the view and edit modes are currently implemented (no administration, might have problems with applications...).
55 {{/warning}}
56
Thomas Mortagne 10.1 57 {{image reference="[email protected]" width="65%"/}}
Thomas Mortagne 6.7 58
Thomas Mortagne 10.1 59 {{image reference="[email protected]" width="65%"/}}
Thomas Mortagne 6.7 60
61 To active the skin (for testing purpose only at the moment), edit ##XWiki.DefaultSkin## and put "##flamingo##" in the "base skin" field or add ##?skin=flamingo## to your URLs.
62
Thomas Mortagne 6.8 63 We have made some progress in the [[flamingo skin>>extensions:Extension.Flamingo Skin]].
Thomas Mortagne 6.7 64
Thomas Mortagne 6.8 65 * The administration is now implemented:(((
Thomas Mortagne 11.1 66 {{image reference="[email protected]" width="65%"/}}
Thomas Mortagne 6.8 67 )))
68 * The user profile too:(((
Thomas Mortagne 11.1 69 {{image reference="[email protected]" width="65%"/}}
Thomas Mortagne 6.8 70 )))
71 * The "advanced" edit modes are better (object, class, rights):(((
Thomas Mortagne 11.1 72 {{image reference="[email protected]" width="65%"/}}
Thomas Mortagne 6.8 73 )))
Thomas Mortagne 6.7 74
Thomas Mortagne 6.9 75 * The "page export" action is now handled via a modal popup:(((
Thomas Mortagne 12.1 76 image:[email protected]
Thomas Mortagne 6.9 77 )))
78 * Create/rename/delete actions are now handled by Flamingo:(((
Thomas Mortagne 12.1 79 image:[email protected]
Thomas Mortagne 6.9 80 )))
81
Guillaume Delhumeau 3.1 82 * [[AppWithinMinutes>>extensions:Extension.App Within Minutes Application]] is now compatible with Flamingo.
Marius Dumitru Florea 1.1 83
84 == Miscellaneous ==
85
Thomas Mortagne 13.6 86 * The document references are displayed as //wiki >> Space >> Page// path in the extension install log.(((
87 {{image reference="[email protected]"/}}
88 )))
89 * The "membership type" options are more clear(((
90 {{image reference="[email protected]"/}}
91 )))
92 * Added built in support for Apple's open directory groups in LDAP authenticator
93 * Generate extension event in Wikistream XAR input module when the XAR contains extension informations
94 * The [[Container Macro>>extensions:Extension.Container Macro]] is now responsive. So if there is not enough place to display several columns side by side, they are displayed instead one after the other in a vertical alignment.(((
95 [[{{image reference="[email protected]" width="35%"/}}>>attach:[email protected]]]
96 )))
97 * The Windows Installer (EXE) now also work on Windows 8 and Windows 8.1.
98 * By default the Total Installs and Active Installs figures displayed by the [[Active Installs Application>>extensions:Extension.Active Installs Server Application]] now counts non-SNAPSHOT XWiki Enterprise instances (it used to count everything: SNAPSHOTs installs and even non-XE instances).
99 * Authenticators can be installed as extensions. Note that they still require to modify xwiki.cfg to indicate the selected authenticator.
100 * A new macro ~{~{watchlist/}} can be used to embed the watchlist of the current user on any page. This is especially useful for a dashboard:(((
101 {{image reference="[email protected]"/}}
102 )))
103 * Debian installer allow XWiki to create new wikis by default in MySQL
Sergiu Dumitriu 17.1 104 * When authenticating over a HTTPS connection, the authentication will not be preserved when switching to HTTP, for improved security
Thomas Mortagne 13.2 105
Thomas Mortagne 23.1 106 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%2C+XEM%29+and+status+%3D+Closed+and+resolution+%3D+Fixed+and+fixVersion+%3D+%226.0%22&tempMax=1000]] fixed in this release.
Marius Dumitru Florea 1.1 107
108 = For Developers =
109
Thomas Mortagne 6.4 110 == WebJars Integration ==
111
Raluca Stavro 22.2 112 The [[WebJars integration>>extensions:Extension.WebJars Integration]] solves the issue of packaging JavaScript frameworks by bundling them as JARs. This allows XWiki Extensions to depend on JavaScript frameworks and be installable by the Extension Manager Application.
Thomas Mortagne 6.4 113
114 == Action API ==
115
116 This [[Action API module>>extensions:Extension.Action API]] is the entry point for all UIs and in charge of calling the correct backend code to display what the user has asked for (it's the Controller in MVC terminology).
117
118 Note that right now most Actions are still implemented the old way in the oldcore module without Components and using Struts. The goal is to progressively rewrite them using this new Action API.
119
Thomas Mortagne 6.5 120 == LiveTable Query Filters ==
121
122 It's now possible to specify which [[Query filters to apply when retrieving LiveTable data>>extensions:Extension.Livetable Macro]].
123
124 For example if you want to show always hidden docs, then you would use:
125
126 {{code language="none"}}
127 ...
128 'queryFilters': 'currentLanguage',
129 ...
130 {{/code}}
131
132 And if you wish to show all docs for all languages and hidden docs you would use:
133
134 {{code language="none"}}
135 ...
136 'queryFilters': '',
137 ...
138 {{/code}}
139
Denis Gervalle 19.1 140 == New Rendering Context ==
141
Thomas Mortagne 20.1 142 {{info}}
143 See the [[Rendering Architecture>>rendering:Main.Architecture]] for more details.
144 {{/info}}
Vincent Massol 19.2 145
Denis Gervalle 19.1 146 It's now possible to access the context of the rendering in progress from any components. The information initially provided by the ##org.xwiki.rendering.transformation.TransformationContext## and ##org.xwiki.rendering.transformation.MacroTransformationContext## (by arguments only to transformations and macro) are now available to any component using the ##org.xwiki.rendering.transformation.RenderingContext## role.
147
148 For this context to be properly actuated, any process that initiate a transformation without using the default implementation of ##org.xwiki.rendering.transformation.TransformationManager## role (or implement it) should take care of it. At the moment, there is no public API for this (internally we use org.xwiki.rendering.internal.transformation.MutableRenderingContext for this purpose), so it is highly recommended to use the transformation manager when possible.
149
Marius Dumitru Florea 1.1 150 == Deprecated and Retired projects ==
151
Thomas Mortagne 6.3 152 * ##xwiki-platorm-wiki-manager## has been removed from the platform. It is still available on the [[contrib repository>>https://github.com/xwiki-contrib/xwiki-platform-wiki-manager]] and via the extensions [[extensions:Extension.Wiki Manager Plugin]] and [[extensions:Extension.Wiki Manager Application]].
Marius Dumitru Florea 1.1 153
154 == Upgrades ==
155
156 The following dependencies have been upgraded:
157
Thomas Mortagne 23.1 158 * [[commons-codec 1.9>>https://jira.xwiki.org/browse/XCOMMONS-524]]
159 * [[JRuby 1.7.10>>https://jira.xwiki.org/browse/XWIKI-8680]]
160 * [[cssparser 0.9.13>>https://jira.xwiki.org/browse/XCOMMONS-526]]
161 * [[doxia 1.5>>https://jira.xwiki.org/browse/XRENDERING-330]]
162 * [[Groovy 2.2.1>>https://jira.xwiki.org/browse/XCOMMONS-527]]
163 * [[HttpClient 4.3.2>>https://jira.xwiki.org/browse/XCOMMONS-528]]
164 * [[SLF4J 1.7.6>>https://jira.xwiki.org/browse/XCOMMONS-530]]
165 * [[Commons FileUpload 1.3.1>>https://jira.xwiki.org/browse/XCOMMONS-532]]
166 * [[Aether 0.9.0.M4>>https://jira.xwiki.org/browse/XCOMMONS-444]]
167 * [[GWT 2.6>>https://jira.xwiki.org/browse/XWIKI-10073]]
168 * [[SmartGWT 4.0>>https://jira.xwiki.org/browse/XCOMMONS-536]]
169 * [[Jest 0.1.0>>https://jira.xwiki.org/browse/XWIKI-10158]]
170 * [[Maven 3.2.1>>https://jira.xwiki.org/browse/XCOMMONS-546]]
171 * [[commons-beanutils 1.9.1>>https://jira.xwiki.org/browse/XCOMMONS-547]]
172 * [[commons-compress 1.8>>https://jira.xwiki.org/browse/XCOMMONS-525]]
173 * [[commons-lang3 3.3.1>>https://jira.xwiki.org/browse/XCOMMONS-548]]
174 * [[Guava 16.0.1>>https://jira.xwiki.org/browse/XCOMMONS-481]]
175 * [[HSQLDB 2.3.2>>https://jira.xwiki.org/browse/XE-1377]]
176 * [[htmlcleaner 2.8>>https://jira.xwiki.org/browse/XCOMMONS-559]]
177 * [[HttpClient 4.3.3>>https://jira.xwiki.org/browse/XCOMMONS-560]]
178 * [[JFreechart 1.0.17>>https://jira.xwiki.org/browse/XWIKI-9968]]
179 * [[JGroups 3.4.3>>https://jira.xwiki.org/browse/XWIKI-10196]]
180 * [[Joda-Time 2.3>>https://jira.xwiki.org/browse/XWIKI-10197]]
181 * [[Logback 1.1.2>>https://jira.xwiki.org/browse/XCOMMONS-563]]
182 * [[Lucene and Solr 4.7.2>>https://jira.xwiki.org/browse/XWIKI-10256]]
183 * [[Jython 2.7-b2>>https://jira.xwiki.org/browse/XWIKI-10295]]
Marius Dumitru Florea 1.1 184
185 == Miscellaneous ==
186
Thomas Mortagne 6.5 187 * The XAR plugins's ##format## mojo now handles properly the ##defaultLanguage## element: if a document has translation we assume it means the document is not a technical document and thus we set the default language to be English. This allows the XWiki SOLR Search to return results when the English language is selected in language facet.
188 * The XAR plugin's ##verify## mojo now also handles the ##defaultLanguage## check accordingly.
189 * The XAR plugin's ##verify## mojo now checks for missing license headers (if the ##formatLicense## configuration property is set to ##true##).
190 * The XAR plugin's ##format## and ##verify## mojos now support including/excluding files.
Thomas Mortagne 13.5 191 * You can bind a list or an array to a XWQL or HQL parameter:(((
192 {{code language="none"}}
193 {{velocity}}
194 #set ($query = $services.query.xwql('where doc.name in (:myList)'))
195 $query.bindValue('myList', ['Activity', 'BlogPostClass', 'Welcome']).execute()
196 {{/velocity}}
197 {{/code}}
198 )))
Thomas Mortagne 13.6 199 * Add new Locale based API to manipulate current Locale:(((
Thomas Mortagne 16.1 200 {{code language="velocity"}}
Thomas Mortagne 13.6 201 $xcontext.locale
202 $xcontext.interfaceLocale
203 {{/code}}
204 )))
Thomas Mortagne 6.5 205 * ##$services.wiki.getAll()## makes a better use of its internal cache, so the performances are better.
206 * New API to test if logs of specific level exist in LogQueue.
207 * Added support for several sets of properties for the same reference in ##org.xwiki.model.reference.EntityReferenceSet##.
Thomas Mortagne 6.9 208 * The Wiki module does not handle the application descriptors of the deprecated [[Application Manager>>extensions:Extension.Application Manager Application]] anymore.
Marius Dumitru Florea 1.1 209
210 = Translations =
211
212 The following translations have been updated:
213
Thomas Mortagne 22.1 214 {{language codes="de, fr, it, lv, sv, pt_BR, nl, es, tr"/}}
Marius Dumitru Florea 1.1 215
216 = Tested Browsers & Databases =
217
Manuel Smeria 3.2 218 {{include reference="TestReports.ManualTestReportXWiki60Summary"/}}
Marius Dumitru Florea 1.1 219
220 = Known issues =
221
Thomas Mortagne 23.1 222 * [[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]]
Marius Dumitru Florea 1.1 223
224 = Backward Compatibility and Migration Notes =
225
226 == General Notes ==
227
228 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.
229
230 == API Breakages ==
231
Thomas Mortagne 6.8 232 The following APIs were modified since XWiki 5.4.4:
Marius Dumitru Florea 1.1 233
Thomas Mortagne 6.8 234 * Moved some method from EntityResource to Resource and changed EntityResource constructor:(((
Marius Dumitru Florea 1.1 235 {{code language="none"}}
Thomas Mortagne 6.8 236 org.xwiki.resource.EntityResource: In method 'public EntityResource(org.xwiki.model.reference.EntityReference)' the number of arguments has changed
237 org.xwiki.resource.EntityResource: Method 'public java.lang.String getAction()' has been removed
238 org.xwiki.resource.EntityResource: Method 'public void setAction(java.lang.String)' has been removed
239 org.xwiki.resource.Resource: Method 'public org.xwiki.resource.ActionId getActionId()' has been added to an interface
Marius Dumitru Florea 1.1 240 {{/code}}
Thomas Mortagne 6.8 241 )))
242
243 * This method is available on the standard JavaScript ##Window## object:(((
244 {{code language="none"}}
245 org.xwiki.gwt.dom.client.DOMUtils: Method 'public void stop(org.xwiki.gwt.dom.client.Window)' has been removed
246 {{/code}}
247 )))
248
249 * This method did not make any sense and was unusable:(((
250 {{code language="none"}}
251 org.xwiki.model.reference.LocalDocumentReference: Method 'public org.xwiki.model.reference.WikiReference getWikiReference()' has been removed
252 {{/code}}
253 )))

Get Connected