Skip to Content

Version 50.2 by Marius Dumitru Florea on 2014/02/25
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 <insert description of release here>
8
9 = New and Noteworthy (since XWiki 5.4) =
10
11 [[Full list of issues fixed and Dashboard for <version>>>http://jira.xwiki.org/secure/Dashboard.jspa?selectPageId=<fill id here>]].
12
13 == Moved to Java 7 as minimum version ==
14
15 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 on Java 6.
16
17 == Wiki Application ==
18
19 * In the Wiki Index, all the wikis that the user can not access [[are not displayed anymore>>extensions:Extension.Wiki Application||anchor="HNewmenusandWikiIndex"]].
20
21 == New Chart Renderers ==
22
23 The ##stackedbar## and ##stackedbar3D## plot renderers were added in the [[Chart Macro>>extensions:Extension.Chart Macro]]:
24
25 {{image reference="stackedbar.png"/}}
26
27 {{image reference="stackedbar3D.png"/}}
28
29 == Miscellaneous ==
30
31 * The document references are displayed as //wiki >> Space >> Page// path in the extension install log.(((
32 {{image reference="docRefInExtensionLog.png"/}}
33 )))
34 * The "membership type" options are more clear(((
35 {{image reference="membershipType.png"/}}
36 )))
37 * The date search facets have a new option 'Older than 30 days':(((
38 {{image reference="dateFacet.png"/}}
39 )))
40 * Added built in support for Apple's open directory groups in LDAP authenticator
41 * Generate extension event in Wikistream XAR input module when the XAR contains extension informations
42 * Add new Locale based API to manipulate current Locale:(((
43 ~{~{code language="velocity}}
44 $xcontext.locale
45 $xcontext.interfaceLocale
46 ~{~{/code}}
47 )))
48
49 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.
50
51 = For Developers =
52
53 == Advanced Solr Search Suggest Sources ==
54
55 The [[Search Suggest>>extensions:Extension.Search Application||anchor="HSearchSuggest"]] feature retrieves live search results from various configurable sources. These sources specify the search engine to use and the search query. The search doesn't perform well, at least on Solr, if we use only the search query because each query is different (when the input text is different) so the cache is not used efficiently. Best is to rely on the filter cache but for this we need to be able to specify the filter query.
56
57 Starting with this release you are able to specify more advanced search parameters in the search query and they will be passed directly to the search engine. This currently works with Solr. As an example, the following statement from the 'query' property of a Search Suggest Source
58
59 {{code language="none"}}
60 type:DOCUMENT AND (title:(__INPUT__*) OR name:(__INPUT__*))
61 {{/code}}
62
63 could be written as
64
65 {{code language="none"}}
66 fq=type:DOCUMENT
67 qf=title^2 name
68 {{/code}}
69
70 Note that:
71
72 * you would use the filter query which is the same for all search requests to this Search Suggest Source so it will be cached by Solr
73 * you would be able to specify the boost for each field you want to search in
74 * the query statement used is '~_~_INPUT~_~_' by default, if not specified.
75
76 In order to preserve backward compatibility with existing Solr Search Suggest Sources, we use the following convention:
77
78 > A line that doesn't start with 'xxx=' specifies the query statement; in other words, existing Solr Search Suggest Sources are specifying only the query statement.
79
80 For example:
81
82 {{code language="none"}}
83 foo __INPUT__* bar
84 fq=type:DOCUMENT
85 qf=title^2 name
86 {{/code}}
87
88 means the query statement is 'foo ~_~_INPUT~_~_* bar'. Which is equivalent to:
89
90 {{code language="none"}}
91 q=foo __INPUT__* bar
92 fq=type:DOCUMENT
93 qf=title^2 name
94 {{/code}}
95
96 See the [[Solr common query parameters>>http://wiki.apache.org/solr/CommonQueryParameters]] and the [[Extended DisMax query parser parameters>>http://wiki.apache.org/solr/ExtendedDisMax#Parameters]] documentation for details on what parameters you can pass to the search engine.
97
98 == Solr Search UI Configuration ==
99
100 We extracted the configuration parameters from the Solr Search UI code in a separate wiki page, ##Main.SolrSearchConfig##. This simplifies the process of customizing the search UI and more importantly allows application developers to easily create a dedicated search page for their application data. As an example, we updated the FAQ application to use the new configuration parameters:
101
102 {{code language="none"}}
103 {{include reference="XWiki.SearchCode"/}}
104
105 {{velocity}}
106 ##
107 ## Customize the Solr Search UI.
108 ##
109 #if ($searchEngine == 'solr')
110 ## Create the configuration object.
111 {{include reference="Main.SolrSearchConfig"/}}
112 #end
113 {{/velocity}}
114 {{velocity output="false"}}
115 #if ($solrConfig)
116 ## Overwrite some configuration parameters.
117 ## We don't use the Result Type facet because the result type is specified in the filter query below so we set the
118 ## query and sort fields for all result types.
119 #set ($discard = $solrConfig.queryFields.put($NULL, 'title^3 property.FAQCode.FAQClass.answer'))
120 #set ($discard = $solrConfig.sortFields.put($NULL, $solrConfig.sortFields.DOCUMENT))
121 #set ($solrConfig.filterQuery = [
122 'type:DOCUMENT',
123 "wiki:$xcontext.database",
124 "space_exact:$doc.space",
125 'class:FAQCode.FAQClass'
126 ])
127 #set ($solrConfig.facetFields = ['creator', 'creationdate', 'author', 'date', 'mimetype', 'attauthor', 'attdate', 'attsize'])
128 ## No preselected facets.
129 #set ($solrConfig.facetQuery = {})
130 #end
131 {{/velocity}}
132
133 {{velocity}}
134 {{include reference="$searchPage"/}}
135 {{/velocity}}
136 {{/code}}
137
138 == Action API ==
139
140 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).
141
142 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.
143
144 == WebJars Integration ==
145
146 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 an be installable by the Extension Manager Application.
147
148 == Miscellaneous ==
149
150 * 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.
151 * The XAR plugin's ##verify## mojo now also handles the ##defaultLanguage## check accordingly.
152 * The XAR plugin's ##verify## mojo now checks for missing license headers (if the ##formatLicense## configuration property is set to ##true##).
153 * The XAR plugin's ##format## and ##verify## mojos now support including/excluding files.
154 * We changed a bit the behaviour of Solr search with respect to the current language. We stopped using the (dynamically computed) 'locales' filter by default. We now rely only on the 'locale' facet, which has the current language preselected. See [[XWIKI-9977>>http://jira.xwiki.org/browse/XWIKI-9977]] for the full story.
155 * ##$services.wiki.getAll()## makes a better use of its internal cache, so the performances are better.
156
157 == Deprecated and Retired projects ==
158
159 * ##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]].
160
161 == Upgrades ==
162
163 The following dependencies have been upgraded:
164
165 * [[Logback 1.1.0>>http://jira.xwiki.org/browse/XCOMMONS-523]]
166 * [[commons-codec 1.9>>http://jira.xwiki.org/browse/XCOMMONS-524]]
167 * [[JRuby 1.7.10>>http://jira.xwiki.org/browse/XWIKI-8680]]
168 * [[cssparser 0.9.13>>http://jira.xwiki.org/browse/XCOMMONS-526]]
169 * [[doxia 1.5>>http://jira.xwiki.org/browse/XRENDERING-330]]
170 * [[Groovy 2.2.1>>http://jira.xwiki.org/browse/XCOMMONS-527]]
171 * [[HttpClient 4.3.2>>http://jira.xwiki.org/browse/XCOMMONS-528]]
172 * [[JGroups 3.4.2>>http://jira.xwiki.org/browse/XWIKI-9969]]
173 * [[XStream 1.4.6>>http://jira.xwiki.org/browse/XCOMMONS-529]]
174 * [[SLF4J 1.7.6>>http://jira.xwiki.org/browse/XCOMMONS-530]]
175 * [[Commons FileUpload 1.3.1>>http://jira.xwiki.org/browse/XCOMMONS-532]]
176 * [[Aether 0.9.0.M4>>http://jira.xwiki.org/browse/XCOMMONS-444]]
177 * [[GWT 2.6>>http://jira.xwiki.org/browse/XWIKI-10073]]
178 * [[SmartGWT 4.0>>http://jira.xwiki.org/browse/XCOMMONS-536]]
179
180 = Translations =
181
182 The following translations have been updated:
183
184 {{language codes="none, none"/}}
185
186 = Tested Browsers & Databases =
187
188 {{include reference="TestReports.ManualTestReportTemplateSummary"/}}
189
190 = Known issues =
191
192 * [[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]]
193
194 = Backward Compatibility and Migration Notes =
195
196 == General Notes ==
197
198 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.
199
200 == Moved to Java 7 as minimum version ==
201
202 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 on Java 6.
203
204 == API Breakages ==
205
206 The following APIs were modified since <project> <version - 1>:
207
208 {{code language="none"}}
209 <clirr output here>
210 {{/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