Version 55.2 by Vincent Massol on 2013/09/12

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 {{warning}}
8 **The support of XWiki Enterprise Manager is stopped**. XWiki now comes with the ability to create subwikis by default, see below.
9 {{/warning}}
10
11 <insert description of release here>
12
13 = New and Noteworthy (since XWiki 5.2 Milestone 1) =
14
15 [[Full list of issues fixed and Dashboard for 5.2>>http://jira.xwiki.org/secure/Dashboard.jspa?selectPageId=11602]].
16
17 == Wiki Creation ==
18
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.
20
21 {{image reference="add-wiki.png"/}}
22
23 === Wiki Creation Right ===
24
25 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.
26
27 A new section is available in the administration of the main wiki to manage who has this right.
28
29 {{image reference="admin-wikis.png"/}}
30
31 === New wiki creation wizard ===
32
33 A new wizard for the creation of a new wiki is now available from the "add" menu.
34
35 {{image reference="createwiki1.png"/}}
36
37 {{image reference="createwiki2.png"/}}
38
39 === XWiki Top Menu ===
40
41 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).
42
43 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.
44
45 {{image reference="new-xwiki-menu.png"/}}
46
47 {{warning}}The position of the new menu is still under discussion and may change in XWiki 5.2 final.{{/warning}}
48
49 == Solr-based search suggest ==
50
51 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).
52
53 We also improved the search suggest administration section
54
55 {{image reference="searchSuggestAdminSection.png" /}}
56
57 and we simplified the source creation form.
58
59 {{image reference="searchSuggestSourceForm.png" /}}
60
61 == Active Installs Tracking ==
62
63 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.
64
65 It does the following:
66
67 * A client side JAR is bundled with XWiki and it sends a ping with data once per day
68 * A server side Application is installed on xwiki.org, 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).
69
70 The data sent is anonymous and consists of the following:
71
72 * 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)
73 * The date of the ping
74 * The version of your XWiki distribution
75 * The technical ids and versions of extensions you have installed.
76
77 This will allow us to present the following data:
78
79 * Number of total installs of XWiki
80 * Number of Active Installs
81 * Most used extensions across versions of XWiki
82 * How frequently the XWiki user base upgrades to newer versions of XWiki
83
84 {{image reference="stats.png"/}}
85
86 {{info}}
87 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.
88 {{/info}}
89
90 Reference documentation:
91
92 * [[Client side module>>extensions:Extension.Active Installs Client API]].
93 * [[Server side module>>extensions:Extension.Active Installs Server Application]].
94
95 == Miscellaneous ==
96
97 * 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.(((
98 {{image reference="lineWithoutShapes.png"/}}
99 )))
100 * When creating or editing a [[template provider>>doc:extensions:Extension.Administration Application||anchor="HCreatethetemplateprovider"]] the template name field is now mandatory.(((
101 {{image reference="templateNameMandatory.png"/}}
102 )))
103 * 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]]
104
105 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+%22<version>%22&tempMax=1000]] fixed in this release.
106
107 = For Developers =
108
109 == New WikiStream framework ==
110
111 Wiki Stream goal is to provide generic API to make easier for different representations of a wiki instance to communicate with each other.
112
113 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:
114
115 * XWiki instance input (send WikiStream events from various data of the XWiki instance like the documents in the database etc.)
116 * XAR instance output (write a XAR package from WikiStream events)
117
118 == Forcing IE Compatibility mode ==
119
120 Now, we force the Compatibility mode for Internet Explorer (IE) browsers to use the latest rendering mode.
121 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>>http://jira.xwiki.org/browse/XWIKI-8907]].
122
123 == Choosing which types of attachments can be displayed inline (Security) ==
124
125 In order to prevent XSS via FileUpload, a new feature has been added : you can now specify in xwiki.properties which types of attachment can be displayed inline.
126 In the "Attachment" section of xwiki.properties, 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).
127 Note that attachments provided by users having Programming Rights won't be affected by these restrictions.
128
129 == Miscellaneous ==
130
131 * Added support for custom facets in Solr search API
132
133 == Upgrades ==
134
135 The following dependencies have been upgraded:
136
137 * [[HSQLDB 2.3.0>>http://jira.xwiki.org/browse/XE-1323]]
138 * [[Groovy 2.1.7>>http://jira.xwiki.org/browse/XCOMMONS-445]]
139
140 = Translations =
141
142 The following translations have been updated:
143
144 {{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"/}}
145
146 = Tested Browsers & Databases =
147
148 {{include reference="TestReports.ManualTestReportXWiki52M2Summary"/}}
149
150 = Known issues =
151
152 * [[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]]
153
154 = Backward Compatibility and Migration Notes =
155
156 == General Notes ==
157
158 You may also want to [[import the default wiki XAR>>Main.Download]] in order to benefit from all the improvements listed above.
159
160 {{warning}}
161 Always make sure you compare your ##xwiki.cfg## and ##xwiki.properties## files with the newest version since some configuration parameters were 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.
162 {{/warning}}
163
164 == Issues specific to XWiki <version> ==
165
166 <issues specific to the project>
167
168 == API Breakages ==
169
170 The following APIs were modified since <project> <version - 1>:
171
172 {{code language="none"}}
173 <clirr output here>
174 {{/code}}

Get Connected