Last modified by Thomas Mortagne on 2017/03/24

Hide last authors
Ecaterina Moraru (Valica) 1.1 1 {{box cssClass="floatinginfobox" title="**Contents**"}}
2 {{toc/}}
3 {{/box}}
Thomas Mortagne 52.1 5 This is the release notes for [[XWiki Commons>>]], [[XWiki Rendering>>]], [[XWiki Platform>>]] and [[XWiki Enterprise>>]]. They share the same release notes as they are released together and have the same version.
Ecaterina Moraru (Valica) 1.1 6
Marius Dumitru Florea 50.1 7 {{warning}}
Vincent Massol 55.3 8 **The support of XWiki Enterprise Manager is stopped**. XWiki Enterprise now comes with the ability to create subwikis by default, see below.
Marius Dumitru Florea 50.1 9 {{/warning}}
Marius Dumitru Florea 58.2 11 The second milestone of the 5.2 release comes with multiwiki support enabled by default: users are able to create new wikis without the need to install additional extensions. This is possible because the Workspace Application has been integrated in XWiki Enterprise. Besides this, the new release brings a Solr-based live search (to replace the one based on Lucene) and the ability to track active XWiki installs. Developers will be interested by the new WikiStream framework. As with other releases this one has a lot of bug fixes (92) and improvements (33) which make it worth trying.
Ecaterina Moraru (Valica) 1.1 12
Guillaume Delhumeau 6.1 13 = New and Noteworthy (since XWiki 5.2 Milestone 1) =
Ecaterina Moraru (Valica) 1.1 14
Thomas Mortagne 62.1 15 [[Full list of issues fixed and Dashboard for 5.2>>]].
Ecaterina Moraru (Valica) 1.1 16
Vincent Massol 26.1 17 == Wiki Creation ==
Guillaume Delhumeau 9.1 18
Vincent Massol 26.1 19 XWiki Enterprise comes now with the ability for users to create their own wikis (a.k.a subwikis). This supersedes the notion of "workspace" and consist in the integration of the [[Workspace Application>>extensions:Extension.Workspace Application]] in the default XWiki distribution.
Guillaume Delhumeau 7.1 20
Marius Dumitru Florea 50.1 21 {{image reference="add-wiki.png"/}}
Guillaume Delhumeau 56.1 23 This new menu entry appears only if a wiki template is created first, see below.
Vincent Massol 26.1 25 === Wiki Creation Right ===
Guillaume Delhumeau 9.1 26
Vincent Massol 26.1 27 The wiki creation is now possible for users who have the "createwiki" right. This right is only available for the main wiki users, exactly like the Programming Right.
Guillaume Delhumeau 7.1 28
Guillaume Delhumeau 56.1 29 === Wikis Section in the Administration ===
Vincent Massol 26.1 30
Guillaume Delhumeau 56.1 31 A new section is available in the administration of the main wiki. In this section, you can enable the wiki creation feature by creating a wiki template. It also manages who has the right to create new wikis.
Guillaume Delhumeau 29.1 33 {{image reference="admin-wikis.png"/}}
Guillaume Delhumeau 9.1 34
Guillaume Delhumeau 32.1 35 === New wiki creation wizard ===
37 A new wizard for the creation of a new wiki is now available from the "add" menu.
39 {{image reference="createwiki1.png"/}}
41 {{image reference="createwiki2.png"/}}
Guillaume Delhumeau 38.1 43 === XWiki Top Menu ===
Guillaume Delhumeau 33.2 44
Vincent Massol 55.1 45 A new top menu has appeared, near the "Profile" menu. It provides a link to the main wiki and to the Wiki Directory (which used to be the "Workspace Directory" - the list of all created wikis except the main one).
Guillaume Delhumeau 33.2 46
Guillaume Delhumeau 38.1 47 It is only available when more than one wiki is created, to prevent the user who only want a single wiki to have too much elements in the UI.
Guillaume Delhumeau 33.2 48
Guillaume Delhumeau 38.1 49 {{image reference="new-xwiki-menu.png"/}}
Guillaume Delhumeau 33.2 50
Guillaume Delhumeau 56.1 51 {{warning}}
52 The position of the new menu is still under discussion and may change in XWiki 5.2 final.
53 {{/warning}}
Vincent Massol 55.1 54
Marius Dumitru Florea 51.1 55 == Solr-based search suggest ==
57 Starting with this version the [[search suggest>>doc:extensions:Extension.Search Application||anchor="HSearchSuggest"]] feature takes into account the configured search engine. To achieve this we added a new property to ##SearchSuggestSourceClass## that specifies the search engine used by the source. We also created a search suggest service based on Solr and we added search suggest sources that mimic the behaviour of the existing Lucene-based sources. As a result, the search suggest feature is now using Solr by default (as Solr is the default search engine starting with 5.1).
59 We also improved the search suggest administration section
Guillaume Delhumeau 56.1 61 {{image reference="searchSuggestAdminSection.png"/}}
Marius Dumitru Florea 51.1 62
63 and we simplified the source creation form.
Guillaume Delhumeau 56.1 65 {{image reference="searchSuggestSourceForm.png"/}}
Marius Dumitru Florea 51.1 66
Vincent Massol 20.1 67 == Active Installs Tracking ==
69 It' very important for the open source committers to understand how well or how badly they're faring when developing the XWiki open source project. So far we didn't know if the number of people using XWiki was increasing, decreasing or staying stable. This module allows us to know who's using XWiki.
71 It does the following:
Manuel Smeria 21.2 72
Vincent Massol 20.1 73 * A client side JAR is bundled with XWiki and it sends a ping with data once per day
74 * A server side Application is installed on, allowing us to query the data sent and to display a counter of Active Installs of XWiki (i.e. installs for which we've received a ping in the last N days, for example at least one ping in the past month).
76 The data sent is anonymous and consists of the following:
Manuel Smeria 21.2 77
Vincent Massol 20.1 78 * A unique id (UUID) representing the XWiki instance. Note that not even the IP is kept and there's no way to find who's having a give UUID (it's generated using Java's UUID implementation)
79 * The date of the ping
Vincent Massol 22.2 80 * The version of your XWiki distribution
Vincent Massol 20.1 81 * The technical ids and versions of extensions you have installed.
83 This will allow us to present the following data:
Manuel Smeria 21.2 84
Vincent Massol 20.1 85 * Number of total installs of XWiki
86 * Number of Active Installs
87 * Most used extensions across versions of XWiki
88 * How frequently the XWiki user base upgrades to newer versions of XWiki
Vincent Massol 35.1 90 {{image reference="stats.png"/}}
Vincent Massol 20.1 92 {{info}}
93 In the near future we'll offer a UI feature to opt-out (in the Administration pages) but at the moment if you wish to opt-out (please don't, we need your help, knowing who's using us and that it's growing is what keeps us motivated to continue developing XWiki!), then simply remove the ##WEB-INF/lib/xwiki-platform-activeinstalls*## JAR and restart.
94 {{/info}}
Vincent Massol 23.1 96 Reference documentation:
Thomas Mortagne 24.1 97
Vincent Massol 23.1 98 * [[Client side module>>extensions:Extension.Active Installs Client API]].
99 * [[Server side module>>extensions:Extension.Active Installs Server Application]].
Vincent Massol 21.1 100
Ecaterina Moraru (Valica) 1.1 101 == Miscellaneous ==
Marius Dumitru Florea 3.1 103 * The ##line## [[chart>>doc:extensions:Extension.Chart Macro]] type has two parameters, ##hideShapes## and ##hideLines##, to hide the shapes used to display the data points or to hide the interpolation lines that connect the data points.(((
104 {{image reference="lineWithoutShapes.png"/}}
105 )))
Marius Dumitru Florea 15.1 106 * When creating or editing a [[template provider>>doc:extensions:Extension.Administration Application||anchor="HCreatethetemplateprovider"]] the template name field is now mandatory.(((
107 {{image reference="templateNameMandatory.png"/}}
108 )))
Vincent Massol 26.3 109 * New [[Instance Module>>extensions:Extension.Instance Module]] used to compute a unique id for each XWiki instance (used by the [[Active Installs Client API>>extensions:Extension.Active Installs Client API]]
Ecaterina Moraru (Valica) 1.1 110
Thomas Mortagne 62.1 111 See the [[full list of JIRA issues>>
Manuel Smeria 59.2 112 ]] fixed in this release.
Ecaterina Moraru (Valica) 1.1 113
114 = For Developers =
Thomas Mortagne 25.1 116 == New WikiStream framework ==
Thomas Mortagne 24.1 117
118 Wiki Stream goal is to provide generic API to make easier for different representations of a wiki instance to communicate with each other.
120 It's still in a very early stage and the API might change during 5.x but it's already pretty complete and usable and the following streams modules are provided:
122 * XWiki instance input (send WikiStream events from various data of the XWiki instance like the documents in the database etc.)
123 * XAR instance output (write a XAR package from WikiStream events)
Ecaterina Moraru (Valica) 2.1 125 == Forcing IE Compatibility mode ==
Ecaterina Moraru (Valica) 1.1 126
Ecaterina Moraru (Valica) 2.1 127 Now, we force the Compatibility mode for Internet Explorer (IE) browsers to use the latest rendering mode.
Thomas Mortagne 62.1 128 Before, the IE browser displayed all intranet sites in compatibility mode by default. This means that even if the user was using IE9, he saw the content rendered with IE7 standards. Since we don't [[support>>dev:Community.BrowserSupportStrategy]] IE6/7 anymore this lead in displaying broken layout, scrollbars, etc. See [[XWIKI-8907>>]].
Ecaterina Moraru (Valica) 1.1 129
Thomas Delafosse 11.1 130 == Choosing which types of attachments can be displayed inline (Security) ==
Vincent Massol 61.3 132 In order to prevent XSS via FileUpload, a new feature has been added: you can now specify in which types of attachment can be displayed inline.
133 In the "Attachment" section of, you can either precise a whitelist of mimetypes that can be displayed inline, or precise a blacklist of mimetypes that shouldn't be displayed inline (if you use this configuration, it is strongly advised to blacklist at least ##text/html## and ##text/javascript## mimetypes for security reasons).
Vincent Massol 26.4 135 Note that attachments provided by users having Programming Rights won't be affected by these restrictions.
Thomas Delafosse 11.1 136
Vincent Massol 26.5 137 == Miscellaneous ==
139 * Added support for custom facets in Solr search API
Ecaterina Moraru (Valica) 1.1 141 == Upgrades ==
143 The following dependencies have been upgraded:
Thomas Mortagne 62.1 145 * [[HSQLDB 2.3.0>>]]
146 * [[Groovy 2.1.7>>]]
Ecaterina Moraru (Valica) 1.1 147
148 = Translations =
150 The following translations have been updated:
Marius Dumitru Florea 54.1 152 {{language codes="ca, cs, da, de, es, fr, gl, it, ko, lv, nl, pl, pt, pt_BR, ro, ru, sk, sv, uk, vi, zh, zh_TW"/}}
Ecaterina Moraru (Valica) 1.1 153
154 = Tested Browsers & Databases =
Manuel Smeria 21.2 156 {{include reference="TestReports.ManualTestReportXWiki52M2Summary"/}}
Ecaterina Moraru (Valica) 1.1 157
158 = Known issues =
Thomas Mortagne 62.1 160 * [[Bugs we know about>>]]
161 * If you're migrating an XWiki instance using PostgreSQL or Oracle you may get [[this error>>]] (fixed in XWiki 5.2). The workaround is to remove the ##hibernate_sequence## sequence prior to starting XWiki (for the main wiki and all subwikis).
Ecaterina Moraru (Valica) 1.1 162
163 = Backward Compatibility and Migration Notes =
165 == General Notes ==
Vincent Massol 61.2 167 == General Notes ==
Ecaterina Moraru (Valica) 1.1 168
Vincent Massol 61.2 169 When upgrading make sure you compare your ##xwiki.cfg##, and ##web.xml## files with the newest version since some configuration parameters may have been modified or added. Note that you should add so that XWiki will attempt to automatically migrate your current database to the new schema. Make sure you backup your Database before doing anything.
Ecaterina Moraru (Valica) 1.1 170
Vincent Massol 59.1 171 == Issues specific to XWiki 5.2 Milestone 2 ==
173 * XWiki now creates a unique identifier in the database (this is used by the new Active Installs module and will be used in the future by the Extension Manager to identify your instance for example). You need to verify that your ##hibernate.cfg.xml## file has the following mapping definition next to the existing mapping definitions:(((
174 {{code}}
175 ...
176 <mapping resource="instance.hbm.xml"/>
177 ...
178 {{/code}}
179 )))
Vincent Massol 61.1 180 * If you're upgrading from XWiki 4.5.x to this version you'll need to perform a full re-indexation when using the SOLR Search. This because in XWiki 4.5.x the SOLR search was experimental and we've completely changed the indexing
181 format in XWiki 5.1.
Vincent Massol 59.1 182
Ecaterina Moraru (Valica) 1.1 183 == API Breakages ==
Marius Dumitru Florea 57.1 185 The following APIs were modified since XWiki 5.1:
Ecaterina Moraru (Valica) 1.1 186
Marius Dumitru Florea 57.1 187 * Moved to ##xwiki-commons-legacy-properties##
Ecaterina Moraru (Valica) 1.1 189 {{code language="none"}}
Marius Dumitru Florea 57.1 190 Class removed
Ecaterina Moraru (Valica) 1.1 191 {{/code}}
Marius Dumitru Florea 57.1 192
193 * This method should never have existed
195 {{code language="none"}}
196 org.xwiki.rendering.listener.reference.ResourceType: Method 'public void setScheme(java.lang.String)' has been removed
197 {{/code}}
199 * Moved from ##xwiki-rendering-api## to ##xwiki-rendering-xml##
201 {{code language="none"}}
202 org.xwiki.rendering.renderer.printer.XHTMLWikiPrinter: Class org.xwiki.rendering.renderer.printer.XHTMLWikiPrinter removed
203 org.xwiki.rendering.renderer.printer.XMLWikiPrinter: Class org.xwiki.rendering.renderer.printer.XMLWikiPrinter removed
204 {{/code}}
206 * This field is not meant to be be modified, the final was just forgotten.
208 {{code language="none"}}
209 com.xpn.xwiki.XWikiContext: Field TYPE_PROVIDER is now final
210 {{/code}}
212 * Has been moved to ##xwiki-platform-feed-api## since it was the only module using it. We also dropped jTidy in favor of HTMLCleaner.
214 {{code language="none"}}
215 com.xpn.xwiki.util.TidyMessageLogger: Class com.xpn.xwiki.util.TidyMessageLogger removed
216 {{/code}}
218 * Google API plugin has been retired
220 {{code language="none"}}
221 Class removed
222 Class removed
223 {{/code}}
225 * Return the number of imported documents
227 {{code language="none"}}
228 com.xpn.xwiki.tool.backup.Importer: Return type of method 'public void importXAR(, java.lang.String, com.xpn.xwiki.XWikiContext)' has been changed to int
229 {{/code}}
231 * The JPQLParser generates source code (that should be internal but it is not) and the grammar has changed a bit.
233 {{code language="none"}}
234 org.xwiki.query.jpql.analysis.Analysis: Method 'public void caseAFuncnumComparableItem(org.xwiki.query.jpql.node.AFuncnumComparableItem)' has been added to an interface
235 org.xwiki.query.jpql.analysis.Analysis: Method 'public void caseAFuncstrComparableItem(org.xwiki.query.jpql.node.AFuncstrComparableItem)' has been added to an interface
236 org.xwiki.query.jpql.analysis.Analysis: Method 'public void caseAFunctimeComparableItem(org.xwiki.query.jpql.node.AFunctimeComparableItem)' has been added to an interface
237 org.xwiki.query.jpql.analysis.Analysis: Method 'public void caseAPathComparableItem(org.xwiki.query.jpql.node.APathComparableItem)' has been added to an interface
238 org.xwiki.query.jpql.node.AGroupbyItem: Parameter 1 of 'public AGroupbyItem(org.xwiki.query.jpql.node.PPath)' has changed its type to org.xwiki.query.jpql.node.PComparableItem
239 org.xwiki.query.jpql.node.AGroupbyItem: Method 'public org.xwiki.query.jpql.node.PPath getPath()' has been removed
240 org.xwiki.query.jpql.node.AGroupbyItem: Method 'public void setPath(org.xwiki.query.jpql.node.PPath)' has been removed
241 org.xwiki.query.jpql.node.AOrderbyItem: Parameter 1 of 'public AOrderbyItem(org.xwiki.query.jpql.node.PPath, org.xwiki.query.jpql.node.TOrderbySpec)' has changed its type to org.xwiki.query.jpql.node.PComparableItem
242 org.xwiki.query.jpql.node.AOrderbyItem: Method 'public org.xwiki.query.jpql.node.PPath getPath()' has been removed
243 org.xwiki.query.jpql.node.AOrderbyItem: Method 'public void setPath(org.xwiki.query.jpql.node.PPath)' has been removed
244 {{/code}}

Get Connected