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
Marius Dumitru Florea 55.2 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.
Marius Dumitru Florea 1.1 8
9 = New and Noteworthy (since XWiki 5.3 Milestone 1) =
10
Thomas Mortagne 61.1 11 [[Full list of issues fixed and Dashboard for 5.3>>https://jira.xwiki.org/secure/Dashboard.jspa?selectPageId=11698]].
Marius Dumitru Florea 1.1 12
Marius Dumitru Florea 5.1 13 == Solr Search Improvements ==
14
15 === Search Facets ===
16
Marius Dumitru Florea 5.2 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.
Marius Dumitru Florea 5.1 18
Thomas Mortagne 8.1 19 {{image reference="search-userFacet.png"/}}
Marius Dumitru Florea 5.1 20
Marius Dumitru Florea 12.1 21 The wiki facet displays the wiki pretty name instead of the wiki identifier.
22
23 {{image reference="search-wikiFacet.png"/}}
24
Marius Dumitru Florea 21.1 25 The language facet displays the full language name and country (when applicable) in the current locale.
Marius Dumitru Florea 17.1 26
Guillaume Delhumeau 32.1 27 {{image reference="search-languageFacet.png"/}}
Marius Dumitru Florea 17.1 28
Marius Dumitru Florea 21.1 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
Marius Dumitru Florea 25.1 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
Guillaume Delhumeau 32.1 33 {{image reference="search-dateFacet.png"/}}
Marius Dumitru Florea 25.1 34
Marius Dumitru Florea 25.2 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.
Marius Dumitru Florea 25.1 36
Guillaume Delhumeau 32.1 37 {{image reference="search-dateFacet-selected.png"/}}
Marius Dumitru Florea 25.1 38
Marius Dumitru Florea 26.1 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
Marius Dumitru Florea 6.3 43 See the [[Solr Search Application documentation>>extensions:Extension.Solr Search Application]] for details.
Marius Dumitru Florea 6.1 44
Thomas Mortagne 13.1 45 == WikiStream improvements ==
Marius Dumitru Florea 1.1 46
Thomas Mortagne 59.1 47 === Allow exporting Large Wikis by default ===
48
Vincent Massol 59.2 49 The WikiStream module is now used by default in the standard export action, thus allowing exporting wikis with lots of content.
Thomas Mortagne 59.1 50
Vincent Massol 60.2 51 Note that you can still put back the old implementation in case you find a problem by setting {{code language="none"}}xwiki.action.export.xar.usewikistream=0{{/code}} at the end of your ##xwiki.cfg## file.
Vincent Massol 59.2 52
Thomas Mortagne 57.1 53 === New WikiStream application ===
54
55 A new generic UI has been introduced to manipulate WikiStream modules easily. See [[extensions:Extension.XWiki Platform - WikiStream - UI]] for more details.
56
Thomas Mortagne 13.1 57 === Script service improvements ===
Thomas Mortagne 10.1 58
Thomas Mortagne 15.1 59 * added a properties converter for ##WikiStreamType## to make easier to manipulate it from Velocity
Thomas Mortagne 14.1 60 * made APIs asynchronous
Thomas Mortagne 13.1 61
62 === Confluence XML input module for WikiStream ===
63
Thomas Mortagne 10.1 64 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]].
65
Thomas Mortagne 2.1 66 === New XHTML based Confluence syntax ===
Marius Dumitru Florea 1.1 67
Marius Dumitru Florea 49.2 68 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.
Thomas Mortagne 2.1 69
Thomas Mortagne 29.1 70 == New Syntax Guide ==
71
Vincent Massol 58.2 72 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##.
Thomas Mortagne 29.1 73
Marius Dumitru Florea 51.1 74 {{image reference="helpui221.png"/}}
Thomas Mortagne 29.1 75
Marius Dumitru Florea 51.1 76 {{image reference="helpui222.png"/}}
Thomas Mortagne 29.1 77
Guillaume Delhumeau 41.1 78 == Multi-Wiki ==
Guillaume Delhumeau 39.1 79
80 * The "create wiki" wizard now offers the ability to create a new wiki template:(((
81 {{image reference="wizard-new-template.png"/}}
82 )))
83 * 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:(((
84 {{image reference="wizard-user-scope.png"/}}
85 )))
86 * When the user creates a wiki from a template, a new step is displayed in the wizard, while the system is provisioning the wiki:(((
87 {{image reference="wizard-provisioning.png"/}}
88 )))
Guillaume Delhumeau 41.1 89 * The "users" section in the administration of a (sub)wiki gives the opportunity to change the user scope setting, and the membership type too:(((
90 {{image reference="admin-wiki-users.png"/}}
91 )))
Guillaume Delhumeau 43.1 92 * In the "wikis" section of the administration of the main wiki, the created templates are displayed:(((
93 {{image reference="admin-wiki-template.png"/}}
94 )))
Guillaume Delhumeau 44.1 95 * It is also possible to edit wikis directly from the wiki index.
Guillaume Delhumeau 55.1 96 * All the documentation is available on the [[application page>>extensions:Extension.Wiki Application]].
Guillaume Delhumeau 39.1 97
Marius Dumitru Florea 1.1 98 == Miscellaneous ==
99
Vincent Massol 48.1 100 * 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]]).
Vincent Massol 31.2 101 * The Statistics Application now has an entry point in the Applications Panel (only visible by Admins by default):(((
Vincent Massol 30.2 102 {{image reference="statsentry.png"/}}
103 )))
Vincent Massol 38.1 104 * The Scheduler Application now has an entry point in the Applications Panel (only visible by Admins by default):(((
105 {{image reference="schedulerentry.png"/}}
106 )))
Vincent Massol 7.1 107 * 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##).
Guillaume Delhumeau 32.1 108 * Deleted users do not appear anymore in the "Top Active Members" list in the wiki dashboard.
Marius Dumitru Florea 1.1 109
Thomas Mortagne 61.1 110 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+%225.3-milestone-2%22&tempMax=1000]] fixed in this release.
Marius Dumitru Florea 1.1 111
112 = For Developers =
113
Guillaume Delhumeau 45.1 114 == Multi-Wiki ==
Marius Dumitru Florea 1.1 115
Guillaume Delhumeau 52.1 116 * 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.
Marius Dumitru Florea 1.1 117
118 == Deprecated and Retired projects ==
119
Thomas Mortagne 47.1 120 * Workspace has been moved to https://github.com/xwiki-contrib/xwiki-platform-workspace
Marius Dumitru Florea 1.1 121
122 == Upgrades ==
123
124 The following dependencies have been upgraded:
125
Thomas Mortagne 61.1 126 * [[Groovy 2.1.9>>https://jira.xwiki.org/browse/XWIKI-9603]]
127 * [[Bouncy Castle Crypto package 1.49>>https://jira.xwiki.org/browse/XWIKI-9631]] (Warning: Not fully binary compatible)
Marius Dumitru Florea 1.1 128
129 == Miscellaneous ==
130
Vincent Massol 49.1 131 * 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
132 * [[New Java API + a few new APIs in the Git module>>extensions:Extension.Git Module]]
Marius Dumitru Florea 1.1 133
134 = Translations =
135
136 The following translations have been updated:
137
Marius Dumitru Florea 56.1 138 {{language codes="de, fr, it, lv, ru, sv, uk"/}}
Marius Dumitru Florea 1.1 139
140 = Tested Browsers & Databases =
141
Manuel Smeria 15.2 142 {{include reference="TestReports.ManualTestReportXWiki53M2Summary"/}}
Marius Dumitru Florea 1.1 143
144 = Known issues =
145
Thomas Mortagne 61.1 146 * [[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 147
148 = Backward Compatibility and Migration Notes =
149
150 == General Notes ==
151
Vincent Massol 25.3 152 == General Notes ==
Marius Dumitru Florea 1.1 153
Vincent Massol 25.3 154 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.
Marius Dumitru Florea 1.1 155
156 == API Breakages ==
157
Marius Dumitru Florea 50.1 158 The following APIs were modified since XWiki 5.2.1:
Marius Dumitru Florea 1.1 159
160 * Requesting a dependency without indicating the namespace does not really make sense. This interface is not really supposed to be implemented anyway.
161
162 {{code language="none"}}
163 org.xwiki.extension.ExtensionManager: Method 'public org.xwiki.extension.Extension resolveExtension(org.xwiki.extension.ExtensionDependency, java.lang.String)' has been added to an interface
164 {{/code}}
165
166 * Needed to filter search by namespace. This interface is not really supposed to be implemented anyway.
167
168 {{code language="none"}}
169 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
170 {{/code}}
171
Marius Dumitru Florea 58.1 172 * Young API. Not supposed to be implemented from outside.
Marius Dumitru Florea 1.1 173
174 {{code language="none"}}
Marius Dumitru Florea 58.1 175 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
Marius Dumitru Florea 1.1 176 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
177 {{/code}}
178
Marius Dumitru Florea 58.1 179 * Young API. Not supposed to be implemented from outside.
180
181 {{code language="none"}}
182 org.xwiki.filter.FilterDescriptorManager: Method 'public java.lang.Object createCompositeFilter(java.lang.ClassLoader, java.lang.Object[])' has been added to an interface
183 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
184 {{/code}}
185
Marius Dumitru Florea 1.1 186 * Young API that has been refactored to introduce the new Resource module.
187
188 {{code language="none"}}
189 org.xwiki.url.AbstractXWikiURL: Class org.xwiki.url.AbstractXWikiURL removed
190 org.xwiki.url.URLCreationException: Class org.xwiki.url.URLCreationException removed
191 org.xwiki.url.UnsupportedURLException: Class org.xwiki.url.UnsupportedURLException removed
192 org.xwiki.url.XWikiEntityURL: Class org.xwiki.url.XWikiEntityURL removed
193 org.xwiki.url.XWikiURL: Class org.xwiki.url.XWikiURL removed
194 org.xwiki.url.XWikiURLFactory: Class org.xwiki.url.XWikiURLFactory removed
195 org.xwiki.url.XWikiURLManager: Class org.xwiki.url.XWikiURLManager removed
196 org.xwiki.url.XWikiURLSerializer: Class org.xwiki.url.XWikiURLSerializer removed
197 org.xwiki.url.XWikiURLType: Class org.xwiki.url.XWikiURLType removed
198 {{/code}}
199
200 * XWikiURL (now Resource) should only be in the Execution Context and not in the Request.
201
202 {{code language="none"}}
203 org.xwiki.container.servlet.ServletRequest: Method 'public org.xwiki.url.XWikiURL getURL()' has been removed
204 org.xwiki.container.servlet.ServletRequest: Method 'public void setXWikiURL(org.xwiki.url.XWikiURL)' has been removed
205 org.xwiki.container.portlet.PortletRequest: Method 'public org.xwiki.url.XWikiURL getURL()' has been removed
206 org.xwiki.container.portlet.PortletRequest: Method 'public void setXWikiURL(org.xwiki.url.XWikiURL)' has been removed
207 org.xwiki.container.Request: Field XWIKI_URL has been removed, but it was previously a constant
208 {{/code}}
Marius Dumitru Florea 58.1 209
210 * Lots of refactoring in WikiStream.
211
212 {{code language="none"}}
213 org.xwiki.wikistream.WikiStream: Class org.xwiki.wikistream.WikiStream removed
214 org.xwiki.wikistream.descriptor.DefaultWikiStreamBeanParameterDescriptor: Method 'public java.lang.reflect.Type getPropertyType()' has been removed
215 org.xwiki.wikistream.descriptor.WikiStreamPropertyDescriptor: Method 'public java.lang.reflect.Type getPropertyType()' has been removed
216 org.xwiki.wikistream.descriptor.WikiStreamPropertyDescriptor: Method 'public java.lang.reflect.Type getType()' has been added to an interface
217 org.xwiki.wikistream.filter.FarmFilter: Class org.xwiki.wikistream.filter.FarmFilter removed
218 org.xwiki.wikistream.filter.WikiAttachmentFilter: Class org.xwiki.wikistream.filter.WikiAttachmentFilter removed
219 org.xwiki.wikistream.filter.WikiClassFilter: Class org.xwiki.wikistream.filter.WikiClassFilter removed
220 org.xwiki.wikistream.filter.WikiClassPropertyFilter: Class org.xwiki.wikistream.filter.WikiClassPropertyFilter removed
221 org.xwiki.wikistream.filter.WikiDocumentFilter: Class org.xwiki.wikistream.filter.WikiDocumentFilter removed
222 org.xwiki.wikistream.filter.WikiFilter: Class org.xwiki.wikistream.filter.WikiFilter removed
223 org.xwiki.wikistream.filter.WikiObjectFilter: Class org.xwiki.wikistream.filter.WikiObjectFilter removed
224 org.xwiki.wikistream.filter.WikiObjectPropertyFilter: Class org.xwiki.wikistream.filter.WikiObjectPropertyFilter removed
225 org.xwiki.wikistream.filter.WikiSpaceFilter: Class org.xwiki.wikistream.filter.WikiSpaceFilter removed
226 org.xwiki.wikistream.input.BeanInputWikiStreamFactory: Removed org.xwiki.wikistream.WikiStream from the set of implemented interfaces
227 org.xwiki.wikistream.input.InputWikiStreamFactory: Removed org.xwiki.wikistream.WikiStream from the set of implemented interfaces
228 org.xwiki.wikistream.output.BeanOutputWikiStreamFactory: Removed org.xwiki.wikistream.WikiStream from the set of implemented interfaces
229 org.xwiki.wikistream.output.BeanOutputWikiStreamFactory: Method 'public org.xwiki.wikistream.output.OutputWikiStream creaOutputWikiStream(java.lang.Object)' has been removed
230 org.xwiki.wikistream.output.BeanOutputWikiStreamFactory: Method 'public org.xwiki.wikistream.output.OutputWikiStream createOutputWikiStream(java.lang.Object)' has been added to an interface
231 org.xwiki.wikistream.output.OutputWikiStreamFactory: Removed org.xwiki.wikistream.WikiStream from the set of implemented interfaces
232 org.xwiki.wikistream.output.OutputWikiStreamFactory: Method 'public org.xwiki.wikistream.output.OutputWikiStream creaOutputWikiStream(java.util.Map)' has been removed
233 org.xwiki.wikistream.output.OutputWikiStreamFactory: Method 'public org.xwiki.wikistream.output.OutputWikiStream createOutputWikiStream(java.util.Map)' has been added to an interface
234 org.xwiki.wikistream.type.WikiStreamType: Removed field XWIKI_XAR
235 org.xwiki.wikistream.instance.input.AbstractInstanceInputEventGenerator: Removed org.xwiki.wikistream.filter.FarmFilter from the set of implemented interfaces
236 org.xwiki.wikistream.instance.input.AbstractInstanceInputEventGenerator: Removed org.xwiki.wikistream.filter.WikiDocumentFilter from the set of implemented interfaces
237 org.xwiki.wikistream.instance.input.AbstractInstanceInputEventGenerator: Removed org.xwiki.wikistream.filter.WikiFilter from the set of implemented interfaces
238 org.xwiki.wikistream.instance.input.AbstractInstanceInputEventGenerator: Removed org.xwiki.wikistream.filter.WikiSpaceFilter from the set of implemented interfaces
239 org.xwiki.wikistream.instance.input.EntityEventGenerator: Method 'public org.xwiki.wikistream.descriptor.WikiStreamDescriptor getDescriptor()' has been added to an interface
240 org.xwiki.wikistream.instance.input.InstanceInputEventGenerator: Removed org.xwiki.wikistream.filter.FarmFilter from the set of implemented interfaces
241 org.xwiki.wikistream.instance.input.InstanceInputEventGenerator: Removed org.xwiki.wikistream.filter.WikiDocumentFilter from the set of implemented interfaces
242 org.xwiki.wikistream.instance.input.InstanceInputEventGenerator: Removed org.xwiki.wikistream.filter.WikiFilter from the set of implemented interfaces
243 org.xwiki.wikistream.instance.input.InstanceInputEventGenerator: Removed org.xwiki.wikistream.filter.WikiSpaceFilter from the set of implemented interfaces
244 org.xwiki.wikistream.instance.input.InstanceInputEventGenerator: Method 'public org.xwiki.wikistream.descriptor.WikiStreamDescriptor getDescriptor()' has been added to an interface
245 org.xwiki.wikistream.instance.input.InstanceInputEventGenerator: Method 'public java.util.Collection getFilterInterfaces()' has been added to an interface
246 org.xwiki.wikistream.instance.input.InstanceInputEventGenerator: Method 'public void setWikiDocumentParameters(java.lang.String, org.xwiki.filter.FilterEventParameters)' has been added to an interface
247 org.xwiki.wikistream.instance.input.InstanceInputEventGenerator: Method 'public void setWikiFarmParameters(org.xwiki.filter.FilterEventParameters)' has been added to an interface
248 org.xwiki.wikistream.instance.input.InstanceInputEventGenerator: Method 'public void setWikiParameters(java.lang.String, org.xwiki.filter.FilterEventParameters)' has been added to an interface
249 org.xwiki.wikistream.instance.input.InstanceInputEventGenerator: Method 'public void setWikiSpaceParameters(java.lang.String, org.xwiki.filter.FilterEventParameters)' has been added to an interface
250 org.xwiki.wikistream.instance.output.OutputInstanceWikiStreamFactory: Removed org.xwiki.wikistream.WikiStream from the set of implemented interfaces
251 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
252 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
253 org.xwiki.wikistream.script.WikiStreamScriptService: Method 'public org.xwiki.wikistream.input.InputWikiStream createInputWikiStream(org.xwiki.wikistream.type.WikiStreamType, java.util.Map)' has been removed
254 org.xwiki.wikistream.script.WikiStreamScriptService: Method 'public org.xwiki.wikistream.output.OutputWikiStream createOutputWikiStream(org.xwiki.wikistream.type.WikiStreamType, java.util.Map)' has been removed
255 {{/code}}

Get Connected