Skip to Content

Version 58.2 by Vincent Massol on 2013/12/13
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 comes with a new syntax quide, an improved faceted search and the ability to import content from Confluence wiki. Also, the wiki creation wizard has now support for creating wiki templates and for choosing the user scope (local, global or both). This release also includes a lot of bug fixes (33) and a few improvements (19) so you should definitely check it out.
8
9 = New and Noteworthy (since XWiki 5.3 Milestone 1) =
10
11 [[Full list of issues fixed and Dashboard for 5.3>>http://jira.xwiki.org/secure/Dashboard.jspa?selectPageId=11698]].
12
13 == Solr Search Improvements ==
14
15 === Search Facets ===
16
17 The display of some of the search facets has been improved. The Author and Creator facets now show the user full name, alias and avatar.
18
19 {{image reference="search-userFacet.png"/}}
20
21 The wiki facet displays the wiki pretty name instead of the wiki identifier.
22
23 {{image reference="search-wikiFacet.png"/}}
24
25 The language facet displays the full language name and country (when applicable) in the current locale.
26
27 {{image reference="search-languageFacet.png"/}}
28
29 The number of displayed facet values is limited to 5 by default but you can see the rest of the values by clicking on the link following the facet values (each click will show 5 more values).
30
31 The date facets (last modification date and creation date) have been improved to display a list of predefined date intervals, with the possibility to specify a custom date interval.
32
33 {{image reference="search-dateFacet.png"/}}
34
35 When selected, the date facet displays the end points of the date interval. If you specify only the start/end date then the interval will include all dates after/before the specified date.
36
37 {{image reference="search-dateFacet-selected.png"/}}
38
39 === RSS Feed ===
40
41 We added a RSS feed for Solr search results. You can find the link on the default search page after the list of results. The feed provides the most recent results that match the current search query and filters. It contains the same type of information that was included in the Lucene search RSS feed.
42
43 See the [[Solr Search Application documentation>>extensions:Extension.Solr Search Application]] for details.
44
45 == WikiStream improvements ==
46
47 === New WikiStream application ===
48
49 A new generic UI has been introduced to manipulate WikiStream modules easily. See [[extensions:Extension.XWiki Platform - WikiStream - UI]] for more details.
50
51 === Script service improvements ===
52
53 * added a properties converter for ##WikiStreamType## to make easier to manipulate it from Velocity
54 * made APIs asynchronous
55
56 === Confluence XML input module for WikiStream ===
57
58 A new WikiStream input module has been added to parse [[Confluence backup packages>>https://confluence.atlassian.com/display/DOC/Exporting+Confluence+Pages+and+Spaces+to+XML]].
59
60 === New XHTML based Confluence syntax ===
61
62 Since 4.0 Confluence moved to a XHTML based syntax for page content. So in order to import recent version of Confluences a parser for this syntax had to be written first.
63
64 == New Syntax Guide ==
65
66 The Syntax Guide has been completely rewritten to better support growing number of syntaxes and make it easier to add documentation other syntaxes. For now it includes ##xwiki/1.0##, ##xwiki/2.0## and ##xwiki/2.1##.
67
68 {{image reference="helpui221.png"/}}
69
70 {{image reference="helpui222.png"/}}
71
72 == Multi-Wiki ==
73
74 * The "create wiki" wizard now offers the ability to create a new wiki template:(((
75 {{image reference="wizard-new-template.png"/}}
76 )))
77 * It is also possible to select the "user scope" of the new wiki. The user scope determines if local or global users are enabled, or both:(((
78 {{image reference="wizard-user-scope.png"/}}
79 )))
80 * When the user creates a wiki from a template, a new step is displayed in the wizard, while the system is provisioning the wiki:(((
81 {{image reference="wizard-provisioning.png"/}}
82 )))
83 * The "users" section in the administration of a (sub)wiki gives the opportunity to change the user scope setting, and the membership type too:(((
84 {{image reference="admin-wiki-users.png"/}}
85 )))
86 * In the "wikis" section of the administration of the main wiki, the created templates are displayed:(((
87 {{image reference="admin-wiki-template.png"/}}
88 )))
89 * It is also possible to edit wikis directly from the wiki index.
90 * All the documentation is available on the [[application page>>extensions:Extension.Wiki Application]].
91
92 == Miscellaneous ==
93
94 * We're now officially not supporting saving Servlet Session in URL (a.k.a URL Rewriting). This means that if you want to remain logged on in XWiki you need to enable cookies (See why ##jsessionid## are considered harmful [[here>>https://randomcoder.org/articles/jsessionid-considered-harmful]] and [[here>>http://java.dzone.com/articles/java-jsessionid-harmful]]).
95 * The Statistics Application now has an entry point in the Applications Panel (only visible by Admins by default):(((
96 {{image reference="statsentry.png"/}}
97 )))
98 * The Scheduler Application now has an entry point in the Applications Panel (only visible by Admins by default):(((
99 {{image reference="schedulerentry.png"/}}
100 )))
101 * The URL Legacy JAR is now correctly bundled in the XE WAR. This is important since otherwise you'd need to set the URL configuration properties in your ##xwiki.properties## file in addition to setting them in ##xwiki.cfg##. For example ##url.standard.multiwiki.isPathBased## in ##xwiki.properties## **and** ##xwiki.virtual.usepath## in ##xwiki.cfg##).
102 * Deleted users do not appear anymore in the "Top Active Members" list in the wiki dashboard.
103
104 See the [[full list of JIRA issues>>http://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+%225.3-milestone-2%22&tempMax=1000]] fixed in this release.
105
106 = For Developers =
107
108 == Multi-Wiki ==
109
110 * The modules {{code}}xwiki-platform-wiki-manager{{/code}} and {{code}}wiki-platform-workspaces{{/code}} are now replaced by the module {{code}}xwiki-platform-wiki{{/code}}, that now manages how (sub)wikis are created and how users can access to them.
111
112 == Deprecated and Retired projects ==
113
114 * Workspace has been moved to https://github.com/xwiki-contrib/xwiki-platform-workspace
115
116 == Upgrades ==
117
118 The following dependencies have been upgraded:
119
120 * [[Groovy 2.1.9>>http://jira.xwiki.org/browse/XWIKI-9603]]
121 * [[Bouncy Castle Crypto package 1.49>>http://jira.xwiki.org/browse/XWIKI-9631]] (Warning: Not fully binary compatible)
122
123 == Miscellaneous ==
124
125 * New {{code language="none"}}com.xpn.xwiki.doc.XWikiDocument#getDocumentReferenceWithLocale(){{/code}} method to get the real reference of the document to use in {{code language="none"}}com.xpn.xwiki.XWiki#getDocument(DocumentReference, XWikiContext){{/code}} for example
126 * [[New Java API + a few new APIs in the Git module>>extensions:Extension.Git Module]]
127
128 = Translations =
129
130 The following translations have been updated:
131
132 {{language codes="de, fr, it, lv, ru, sv, uk"/}}
133
134 = Tested Browsers & Databases =
135
136 {{include reference="TestReports.ManualTestReportXWiki53M2Summary"/}}
137
138 = Known issues =
139
140 * [[Bugs we know about>>http://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]]
141
142 = Backward Compatibility and Migration Notes =
143
144 == General Notes ==
145
146 == General Notes ==
147
148 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.
149
150 == API Breakages ==
151
152 The following APIs were modified since XWiki 5.2.1:
153
154 * Requesting a dependency without indicating the namespace does not really make sense. This interface is not really supposed to be implemented anyway.
155
156 {{code language="none"}}
157 org.xwiki.extension.ExtensionManager: Method 'public org.xwiki.extension.Extension resolveExtension(org.xwiki.extension.ExtensionDependency, java.lang.String)' has been added to an interface
158 {{/code}}
159
160 * Needed to filter search by namespace. This interface is not really supposed to be implemented anyway.
161
162 {{code language="none"}}
163 org.xwiki.extension.repository.InstalledExtensionRepository: Method 'public org.xwiki.extension.repository.result.IterableResult searchInstalledExtensions(java.lang.String, java.lang.String, int, int)' has been added to an interface
164 {{/code}}
165
166 * Young API. Not supposed to be implemented from outside.
167
168 {{code language="none"}}
169 org.xwiki.filter.xml.parser.XMLParserFactory: Method 'public javax.xml.stream.XMLEventWriter createXMLEventWriter(java.lang.Object, org.xwiki.filter.xml.XMLConfiguration)' has been added to an interface
170 org.xwiki.filter.xml.serializer.XMLSerializerFactory: Method 'public java.lang.Object createSerializer(java.lang.Class[], javax.xml.transform.Result, org.xwiki.filter.xml.XMLConfiguration)' has been added to an interface
171 {{/code}}
172
173 * Young API. Not supposed to be implemented from outside.
174
175 {{code language="none"}}
176 org.xwiki.filter.FilterDescriptorManager: Method 'public java.lang.Object createCompositeFilter(java.lang.ClassLoader, java.lang.Object[])' has been added to an interface
177 org.xwiki.filter.FilterDescriptorManager: Method 'public java.lang.Object createFilterProxy(java.lang.Object, java.lang.ClassLoader, java.lang.Class[])' has been added to an interface
178 {{/code}}
179
180 * Young API that has been refactored to introduce the new Resource module.
181
182 {{code language="none"}}
183 org.xwiki.url.AbstractXWikiURL: Class org.xwiki.url.AbstractXWikiURL removed
184 org.xwiki.url.URLCreationException: Class org.xwiki.url.URLCreationException removed
185 org.xwiki.url.UnsupportedURLException: Class org.xwiki.url.UnsupportedURLException removed
186 org.xwiki.url.XWikiEntityURL: Class org.xwiki.url.XWikiEntityURL removed
187 org.xwiki.url.XWikiURL: Class org.xwiki.url.XWikiURL removed
188 org.xwiki.url.XWikiURLFactory: Class org.xwiki.url.XWikiURLFactory removed
189 org.xwiki.url.XWikiURLManager: Class org.xwiki.url.XWikiURLManager removed
190 org.xwiki.url.XWikiURLSerializer: Class org.xwiki.url.XWikiURLSerializer removed
191 org.xwiki.url.XWikiURLType: Class org.xwiki.url.XWikiURLType removed
192 {{/code}}
193
194 * XWikiURL (now Resource) should only be in the Execution Context and not in the Request.
195
196 {{code language="none"}}
197 org.xwiki.container.servlet.ServletRequest: Method 'public org.xwiki.url.XWikiURL getURL()' has been removed
198 org.xwiki.container.servlet.ServletRequest: Method 'public void setXWikiURL(org.xwiki.url.XWikiURL)' has been removed
199 org.xwiki.container.portlet.PortletRequest: Method 'public org.xwiki.url.XWikiURL getURL()' has been removed
200 org.xwiki.container.portlet.PortletRequest: Method 'public void setXWikiURL(org.xwiki.url.XWikiURL)' has been removed
201 org.xwiki.container.Request: Field XWIKI_URL has been removed, but it was previously a constant
202 {{/code}}
203
204 * Lots of refactoring in WikiStream.
205
206 {{code language="none"}}
207 org.xwiki.wikistream.WikiStream: Class org.xwiki.wikistream.WikiStream removed
208 org.xwiki.wikistream.descriptor.DefaultWikiStreamBeanParameterDescriptor: Method 'public java.lang.reflect.Type getPropertyType()' has been removed
209 org.xwiki.wikistream.descriptor.WikiStreamPropertyDescriptor: Method 'public java.lang.reflect.Type getPropertyType()' has been removed
210 org.xwiki.wikistream.descriptor.WikiStreamPropertyDescriptor: Method 'public java.lang.reflect.Type getType()' has been added to an interface
211 org.xwiki.wikistream.filter.FarmFilter: Class org.xwiki.wikistream.filter.FarmFilter removed
212 org.xwiki.wikistream.filter.WikiAttachmentFilter: Class org.xwiki.wikistream.filter.WikiAttachmentFilter removed
213 org.xwiki.wikistream.filter.WikiClassFilter: Class org.xwiki.wikistream.filter.WikiClassFilter removed
214 org.xwiki.wikistream.filter.WikiClassPropertyFilter: Class org.xwiki.wikistream.filter.WikiClassPropertyFilter removed
215 org.xwiki.wikistream.filter.WikiDocumentFilter: Class org.xwiki.wikistream.filter.WikiDocumentFilter removed
216 org.xwiki.wikistream.filter.WikiFilter: Class org.xwiki.wikistream.filter.WikiFilter removed
217 org.xwiki.wikistream.filter.WikiObjectFilter: Class org.xwiki.wikistream.filter.WikiObjectFilter removed
218 org.xwiki.wikistream.filter.WikiObjectPropertyFilter: Class org.xwiki.wikistream.filter.WikiObjectPropertyFilter removed
219 org.xwiki.wikistream.filter.WikiSpaceFilter: Class org.xwiki.wikistream.filter.WikiSpaceFilter removed
220 org.xwiki.wikistream.input.BeanInputWikiStreamFactory: Removed org.xwiki.wikistream.WikiStream from the set of implemented interfaces
221 org.xwiki.wikistream.input.InputWikiStreamFactory: Removed org.xwiki.wikistream.WikiStream from the set of implemented interfaces
222 org.xwiki.wikistream.output.BeanOutputWikiStreamFactory: Removed org.xwiki.wikistream.WikiStream from the set of implemented interfaces
223 org.xwiki.wikistream.output.BeanOutputWikiStreamFactory: Method 'public org.xwiki.wikistream.output.OutputWikiStream creaOutputWikiStream(java.lang.Object)' has been removed
224 org.xwiki.wikistream.output.BeanOutputWikiStreamFactory: Method 'public org.xwiki.wikistream.output.OutputWikiStream createOutputWikiStream(java.lang.Object)' has been added to an interface
225 org.xwiki.wikistream.output.OutputWikiStreamFactory: Removed org.xwiki.wikistream.WikiStream from the set of implemented interfaces
226 org.xwiki.wikistream.output.OutputWikiStreamFactory: Method 'public org.xwiki.wikistream.output.OutputWikiStream creaOutputWikiStream(java.util.Map)' has been removed
227 org.xwiki.wikistream.output.OutputWikiStreamFactory: Method 'public org.xwiki.wikistream.output.OutputWikiStream createOutputWikiStream(java.util.Map)' has been added to an interface
228 org.xwiki.wikistream.type.WikiStreamType: Removed field XWIKI_XAR
229 org.xwiki.wikistream.instance.input.AbstractInstanceInputEventGenerator: Removed org.xwiki.wikistream.filter.FarmFilter from the set of implemented interfaces
230 org.xwiki.wikistream.instance.input.AbstractInstanceInputEventGenerator: Removed org.xwiki.wikistream.filter.WikiDocumentFilter from the set of implemented interfaces
231 org.xwiki.wikistream.instance.input.AbstractInstanceInputEventGenerator: Removed org.xwiki.wikistream.filter.WikiFilter from the set of implemented interfaces
232 org.xwiki.wikistream.instance.input.AbstractInstanceInputEventGenerator: Removed org.xwiki.wikistream.filter.WikiSpaceFilter from the set of implemented interfaces
233 org.xwiki.wikistream.instance.input.EntityEventGenerator: Method 'public org.xwiki.wikistream.descriptor.WikiStreamDescriptor getDescriptor()' has been added to an interface
234 org.xwiki.wikistream.instance.input.InstanceInputEventGenerator: Removed org.xwiki.wikistream.filter.FarmFilter from the set of implemented interfaces
235 org.xwiki.wikistream.instance.input.InstanceInputEventGenerator: Removed org.xwiki.wikistream.filter.WikiDocumentFilter from the set of implemented interfaces
236 org.xwiki.wikistream.instance.input.InstanceInputEventGenerator: Removed org.xwiki.wikistream.filter.WikiFilter from the set of implemented interfaces
237 org.xwiki.wikistream.instance.input.InstanceInputEventGenerator: Removed org.xwiki.wikistream.filter.WikiSpaceFilter from the set of implemented interfaces
238 org.xwiki.wikistream.instance.input.InstanceInputEventGenerator: Method 'public org.xwiki.wikistream.descriptor.WikiStreamDescriptor getDescriptor()' has been added to an interface
239 org.xwiki.wikistream.instance.input.InstanceInputEventGenerator: Method 'public java.util.Collection getFilterInterfaces()' has been added to an interface
240 org.xwiki.wikistream.instance.input.InstanceInputEventGenerator: Method 'public void setWikiDocumentParameters(java.lang.String, org.xwiki.filter.FilterEventParameters)' has been added to an interface
241 org.xwiki.wikistream.instance.input.InstanceInputEventGenerator: Method 'public void setWikiFarmParameters(org.xwiki.filter.FilterEventParameters)' has been added to an interface
242 org.xwiki.wikistream.instance.input.InstanceInputEventGenerator: Method 'public void setWikiParameters(java.lang.String, org.xwiki.filter.FilterEventParameters)' has been added to an interface
243 org.xwiki.wikistream.instance.input.InstanceInputEventGenerator: Method 'public void setWikiSpaceParameters(java.lang.String, org.xwiki.filter.FilterEventParameters)' has been added to an interface
244 org.xwiki.wikistream.instance.output.OutputInstanceWikiStreamFactory: Removed org.xwiki.wikistream.WikiStream from the set of implemented interfaces
245 org.xwiki.wikistream.instance.script.InstanceWikiStreamScriptService: Method 'public void export(org.xwiki.wikistream.type.WikiStreamType, org.xwiki.wikistream.instance.internal.input.InstanceInputProperties, java.util.Map)' has been removed
246 org.xwiki.wikistream.script.WikiStreamScriptService: Method 'public void convert(org.xwiki.wikistream.type.WikiStreamType, java.util.Map, org.xwiki.wikistream.type.WikiStreamType, java.util.Map)' has been removed
247 org.xwiki.wikistream.script.WikiStreamScriptService: Method 'public org.xwiki.wikistream.input.InputWikiStream createInputWikiStream(org.xwiki.wikistream.type.WikiStreamType, java.util.Map)' has been removed
248 org.xwiki.wikistream.script.WikiStreamScriptService: Method 'public org.xwiki.wikistream.output.OutputWikiStream createOutputWikiStream(org.xwiki.wikistream.type.WikiStreamType, java.util.Map)' has been removed
249 {{/code}}

About

About

Support

Platform

User Guide

Admin Guide

Developer Guide

Projects

XWiki

Extensions

Other

Contribute

Status

Practices

Under the Hood

Get Involved

Get Connected