Show last authors
1 {{box cssClass="floatinginfobox" title="**Contents**"}}
2 {{toc/}}
3 {{/box}}
5 This is the release notes for XWiki Platform, XWiki Enterprise and XWiki Enterprise Manager. They share the same release notes as they are released together and have the same version.
7 <insert description of release here>
9 = New and Noteworthy (since XWiki 4.3 Milestone 1) =
11 == Experimental Solr based search engine ==
13 A new and experimental search engine based on [[Apache Solr>>]] is now available.
15 The new search UI offers advanced search features and results highlighting. Future versions will also include [[Faceted Search>>]].
17 {{image reference="solrSearchFilters.png"/}}
19 The new engine has it's own index, separate from the Lucene one, which is stored by default in the ##<permanent directory>/solr## folder. In the same folder you can also access Solr's configuration files together with the index's schema.xml which you can tweek to achieve better results. To change this folder's location, you can either pass the ##-Dsolr.solr.home## system property when you start the application container (tomcat/jetty/etc.) or you can set the ##search.solr.home## property in ##WEB-INF/xwiki.preferences##.
21 For now, indexing is done only __manually__ by using the Search Administration UI. Because of this, in order to get any search results, you have to go to ##Administration > Applications > Search## and index/reindex the wiki. Any changes in the content of the wiki will not be searchable until you manually reindex. This limitation will be removed in future versions, once the feature matures.
23 {{image reference="solrSearchAdmin.png"/}}
25 This new search engine is not enable by default, since Lucene is still the default one, but, if you wish to try it out, it can be enable by going to ##Administration > Applications > Search > Search engine to use## and selecting ##Solr (Experimental)##.
27 == Default date picker ==
29 The date picker from [[AppWithinMinutes>>extensions:Extension.App Within Minutes Application]] is now the default picker for all [[XClass>>platform:DevGuide.DataModel]] properties of type Date. This means that you'll get a date picker when editing an object with a Date property even if you didn't use AppWithinMinutes to create the XClass.
31 {{image reference="DatePicker.png"/}}
33 If for some reason you don't want to use the new date picker then you can edit the XClass and uncheck "Use Date Picker" for the Date property.
35 == User and Group picker ==
37 We added a user and group picker that is used by default for all [[XClass>>platform:DevGuide.DataModel]] properties of type "List of Users" and "List of Groups". When multiple selection is enabled, each selected user is added to the list above the picker. You can remove individual users from the list of selected users or you can clear the entire list.
39 {{image reference="userPicker-editMultiple.png"/}}
41 In single selection mode whenever you select an user it overwrites the previously selected user.
43 {{image reference="userPicker-editSingle-objectEditor.png"/}}
45 The list of selected users is displayed in view mode in a similar way. For each user there is a link to their profile page.
47 {{image reference="userPicker-viewMultiple.png"/}}
49 The group picker behaves in the same way. The group alias is the name of the group document, the group name is the title of the group document while the group avatar is the first image attached to the group document.
51 {{image reference="groupPicker-editMultiple.png"/}}
53 The user and group picker can be configured to display a scope toggle that can be used to switch between local and global user/group suggestions.
55 {{image reference="userPicker-scope.png"/}}
57 You can check this if you edit a group from a subwiki (in a multiwiki environment).
59 {{image reference="groupSheet-edit.png"/}}
61 == Miscellaneous ==
63 * Search Admin UI improvements ({{jira style="enum" url=""}}XWIKI-8408{{/jira}}):(((
64 {{image reference="searchAdminUINew.png"/}}
65 )))
66 * Automatically register translations for the FAQ and IRCBot applications
68 See the [[full list of JIRA issues>>]] fixed in this release.
70 = For Developers =
72 == New Localization Module ==
74 A new localization module has been introduced to replace the old XWikiMessageTool.
76 See [[extensions:Extension.Localization Module]] for more details.
78 == REST API Improvements ==
80 Some improvements have been done to the REST API with respect to wiki management.
82 * XARs can be imported in Wikis by POSTing it to the /wikis/{wikiName}
83 * New wikis can be created using the /wikimanager resource. (This resource is only available with XWiki Enterprise Manager)
85 For more information see [[XWiki RESTful API>>platform:Features.XWikiRESTfulAPI]]
87 In addition there was an XWiki REST API refactoring done with the introduction of a new ##xwiki-platform-rest-api## module containing all resource declarations. This is important for client and modules willing to use the REST API so that they can have all the information about resources using Java annotation. See [[XWiki RESTful API>>platform:Features.XWikiRESTfulAPI]].
89 == Execution context property declarations ==
91 Execution context properties can now be associated with various metadata attributes. See [[the documentation on the execution context>>doc:platform:DevGuide.SavingData||anchor="HExecutionContext"]] for more information.
93 == New Scope property for wiki components and UI extensions ==
95 A scope can now be defined for [[wiki components>>extensions:Extension.WikiComponent Module]] and [[UI extensions>>extensions:Extension.UIExtension Module]], it allows to restrict for which wiki(s) or which user they will be available:
97 * Current Wiki, the component/UI extension will be available in the current wiki
98 * Global, the component/UI extension will be available in all the wikis (wiki farms)
99 * Current User, the component/UI extension will only be available for its author
101 == Deprecated and Retired projects ==
103 <description of deprecated and retired projects>
105 == Upgrades ==
107 The following dependencies have been upgraded:
109 * [[guava 13.0.1>>]]
110 * [[Lucene 3.6.1>>]]
111 * [[XStream 1.4.3>>]]
112 * [[commons-io 2.4>>]]
113 * [[httpclient 4.2.2>>]]
114 * [[commons-configuration 1.9>>]]
115 * [[jcl-over-slf4j and log4j-over-slf4j 1.7.2>>]]
116 * Groovy [[1.8.7>>]] [[1.8.8>>]]
117 * [[JGroups 3.2.0.Final>>]]
118 * [[Xerces-J 2.10.0>>]]
119 * [[JavaMail 1.4.5>>]]
121 == Miscellaneous ==
123 * Fixed a bug about incorrect results in multi-wiki lucene search in the REST API.
124 * Add a ##java.util.Locale## converter which allow:
125 ** using Locale in rendering macro parameter(s)
126 ** support Java method with Locale parameter(s) in Velocity. See [[Method Arguments Uberspector>>extensions:Extension.Velocity Module||anchor="HMethodArgumentsUberspector"]] for more details.
127 * Various String language based API of ##com.xpn.xwiki.XWiki## and ##com.xpn.xwiki.doc.XWikiDocument## classes are now deprecated for their newly introduced ##java.util.Locale## equivalents.
129 = Translations =
131 The following translations have been updated:
133 {{language codes="da, de, fr"/}}
135 = Known issues =
137 * [[Bugs we know about>>]]
139 = Backward Compatibility and Migration Notes =
141 == General Notes ==
143 You may also want to [[import the default wiki XAR>>Main.Download]] in order to benefit from all the improvements listed above.
145 {{warning}}
146 Always make sure you compare your ##xwiki.cfg## and files with the newest version since some configuration parameters were 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.
147 {{/warning}}
149 == Issues specific to XWiki 4.3 Milestone 2 ==
151 * The methods setUrlPatternMatcher and getUrlPatternMatcher have been removed from the core class com.xpn.xwiki.XWiki. The underlying URLPatternMatcher could not really be used as a singleton instance and was causing irregular failures in the basic authentication method. Thus these methods cannot be meaningfully relied upon and have therefore been removed.
152 * When setting the value using setValue (or setList) on a list field in an XWiki object, the list will now be copied. To be able to update the list, you must call getValue (or getList) and update the returned list. This is due to {{jira style="enum" url=""}}XWIKI-8398{{/jira}}.
154 == API Breakages ==
156 The following APIs were modified since 4.2:
158 * [Young API] Introduce API to associate dependency status to the namespace.(((
159 {{code language="none"}}
160 org.xwiki.extension.InstalledExtension: Method 'public boolean isDependency(java.lang.String)' has been added to an interface
161 {{/code}}
162 )))
164 * [Young API] Introduce ExtensionRepositoryDescriptor as a replacement of ExtensionRepositoryId(((
165 {{code language="none"}}
166 org.xwiki.extension.ExtensionManagerConfiguration: Method 'public java.util.Collection getExtensionRepositoryDescriptors()' has been added to an interface
167 org.xwiki.extension.repository.ExtensionRepository: Method 'public org.xwiki.extension.repository.ExtensionRepositoryDescriptor getDescriptor()' has been added to an interface
168 org.xwiki.extension.repository.ExtensionRepositoryFactory: Method 'public org.xwiki.extension.repository.ExtensionRepository createRepository(org.xwiki.extension.repository.ExtensionRepositoryDescriptor)' has been added to an interface
169 org.xwiki.extension.repository.ExtensionRepositoryManager: Method 'public org.xwiki.extension.repository.ExtensionRepository addRepository(org.xwiki.extension.repository.ExtensionRepositoryDescriptor)' has been added to an interface
170 org.xwiki.extension.repository.ExtensionRepositorySource: Method 'public java.util.Collection getExtensionRepositoryDescriptors()' has been added to an interface
171 {{/code}}
172 )))
174 * The ##userdirectory## and ##usertools## plugins have been retired(((
175 {{code language="none"}}
176 com.xpn.xwiki.plugin.userdirectory.Group: Class com.xpn.xwiki.plugin.userdirectory.Group removed
177 com.xpn.xwiki.plugin.userdirectory.UserDirectoryPlugin: Class com.xpn.xwiki.plugin.userdirectory.UserDirectoryPlugin removed
178 com.xpn.xwiki.plugin.userdirectory.UserDirectoryPluginAPI: Class com.xpn.xwiki.plugin.userdirectory.UserDirectoryPluginAPI removed
179 com.xpn.xwiki.plugin.usertools.XWikiUserManagementTools: Class com.xpn.xwiki.plugin.usertools.XWikiUserManagementTools removed
180 com.xpn.xwiki.plugin.usertools.XWikiUserManagementToolsAPI: Class com.xpn.xwiki.plugin.usertools.XWikiUserManagementToolsAPI removed
181 com.xpn.xwiki.plugin.usertools.XWikiUserManagementToolsImpl: Class com.xpn.xwiki.plugin.usertools.XWikiUserManagementToolsImpl removed
182 {{/code}}
183 )))
185 * This should be fixed: a new 'sendMessageFromTemplate' method was added before the 4.2 release and then removed only from master (4.3-SNAPSHOT). We need to decide what we do with this method.(((
186 {{code language="none"}}
187 com.xpn.xwiki.plugin.mailsender.MailSender: Method 'public int sendMessageFromTemplate(java.lang.String, java.lang.String, java.lang.String, java.lang.String, java.lang.String, java.lang.String, java.util.Map)' has been removed
188 {{/code}}
189 )))
191 * Many REST API module classes that were not meant to be public have been moved to internal package.(((
192 {{code language="none"}}
193 Removed field version
194 Class removed
195 Field ALLOWED_VALUES_ATTRIBUTE_NAME has been removed, but it was previously a constant
196 Field RELEASABLE_COMPONENT_REFERENCES has been removed, but it was previously a constant
197 Field XWIKI_COMPONENT_MANAGER has been removed, but it was previously a constant
198 Class removed
199 Class removed
200 Class removed
201 Class removed
202 Class removed
203 Class removed
204 Class removed
205 Class removed
206 Class removed
207 Class removed
208 Class removed
209 Class removed
210 Class removed
211 Class removed
212 Class removed
213 Class removed
214 Class removed
215 Class removed
216 Class removed
217 Class removed
218 Class removed
219 Class removed
220$AttachmentInfo: Class$AttachmentInfo removed
221 Class removed
222$SearchScope: Class$SearchScope removed
223 Class removed
224 Class removed
225 Class removed
226 Class removed
227 Class removed
228 Class removed
229 Class removed
230 Class removed
231 Class removed
232 Class removed
233 Class removed
234 Class removed
235 Class removed
236 Class removed
237 Class removed
238 Class removed
239 Class removed
240 Class removed
241 Class removed
242 Class removed
243 Class removed
244 Class removed
245 Class removed
246 Class removed
247 Class removed
248 Class removed
249 Class removed
250 Class removed
251 Class removed
252 Class removed
253 Class removed
254 Class removed
255 Class removed
256 Class removed
257 Class removed
258 Class removed
259 Class removed
260 Class removed
261 Class removed
262 Class removed
263 Class removed
264 Class removed
265 Class removed
266 Class removed
267 Class removed
268 Class removed
269 Class removed
270 Class removed
271 Class removed
272 Class removed
273 {{/code}}
274 )))
276 * Added methods for creating workspaces and retrieving workspace templates.(((
277 {{code language="none"}}
278 org.xwiki.workspace.WorkspaceManager: Method 'public com.xpn.xwiki.plugin.wikimanager.doc.XWikiServer createWorkspace(java.lang.String, com.xpn.xwiki.plugin.wikimanager.doc.XWikiServer, java.lang.String)' has been added to an interface
279 org.xwiki.workspace.WorkspaceManager: Method 'public java.util.List getWorkspaceTemplates()' has been added to an interface
280 {{/code}}
281 )))

Get Connected