Wiki source code of Release Notes for XWiki 6.3

Last modified by Thomas Mortagne on 2023/10/13

version	line-number	content
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
18.1	7	This release provides a great stabilization of the Flamingo Skin, and includes new themes and some improvements to manage them.
19.1	8
15.1	9	It also contains a new mail API and module to replace the old mailsender plugin, a new dynamic tree widget that is progressively replacing all existing trees in XWiki (Document Index, Navigation Panels, etc...), some improvements on the Extension Manager as well as on the User Directory and the Applications Panel.
1.1	10
16.1	11	Efforts have been made on the performances side, with good results on view mode (except on the first loaded-page). We reach the same performances as 5.4.6, which was not the case during the 6.x cycle until now. This is a first milestone to get even better!
15.1	12
	13	Finally, and like every releases, a lot of bugs have been fixed.
	14
3.7	15	= New and Noteworthy (since XWiki 6.2) =
1.1	16
28.1	17	[[Full list of issues fixed and Dashboard for 6.3>>https://jira.xwiki.org/secure/Dashboard.jspa?selectPageId=12693]].
1.1	18
2.2	19	== Extension Manager and Repository improvements ==
1.1	20
2.2	21	* ##<scm>## element from Maven ##pom.xml## is now supported and has been added to the standard in the API
	22	* ##<issueManagement>## element from Maven ##pom.xml## is now supported and has been added to the standard in the API
	23	* When importing an extension unknown but valid versions are not removed anymore
	24	* The extension source URL and issue manager URL are now displayed in the extension description when available.
3.3	25	{{image reference="ReleaseNotesXWiki63M2@scmissuemanagement.png"/}}
1.1	26
2.2	27	== User Directory customized globally ==
	28
	29	The administrator of the wiki can customize the default columns to be displayed by the user directory.
	30
3.4	31	{{image reference="ReleaseNotesXWiki63M1@userDirectoryGloballyConfigurableInAdministration.png"/}}
2.2	32
	33	For more information, see the [[documentation>>extensions:Extension.User Directory Application]]
	34
	35	== Flamingo ==
	36
	37	{{info}}
28.1	38	The Flamingo skin was introduced as experimental in XWiki 6.0 & 6.1 and has been deemed usable in XWiki 6.2. However we're still tuning details. It happens that we did not all agree on the location of the "Add" button (some wanted it inside the content, next to the "Edit" buttons and others wanted it back at the top - You can [[follow the discussion here>>http://markmail.org/message/jqbcj4p4ryc56sms]] if you're interested ;)). Thus we've decided for the moment to put it back at the top where it was in the Colibri skin in order to not force our users to learn a new location for the moment. This is still a discussion in progress and if you have inputs and preferences please do not hesitate to let us know on the [[XWiki Users Mailing List>>dev:Community.MailingLists]] or on the [[related Issue>>https://jira.xwiki.org/browse/XWIKI-11167]]. Thanks!
2.2	39	{{/info}}
	40
	41	* The 'Add' button has been moved back to the top bar and the search bar to the right:(((
	42	{{image reference="ReleaseNotesXWiki622@flamingo-add.png" width="60%"/}}
	43	)))
	44	* When you click on the 'add' button, the order of the choices have been inverted, to propose to create a page first, then a space, and finally a wiki:(((
	45	{{image reference="ReleaseNotesXWiki622@flamingo-add-options.png"/}}
	46	)))
	47	* The Wiki/Space/Page buttons in the top bar have been changed and are no longer split into two parts. You do not need to click the arrow specifically any more to open the contextual menu:(((
	48	{{image reference="ReleaseNotesXWiki622@flamingo-menubar.png"/}}
	49	)))
	50	* To navigate to the current Wiki/Space/Page in the top bar, there is now a new "Go to..." item:(((
	51	\|=Wiki\|=Space\|=Page
	52	\|{{image reference="ReleaseNotesXWiki622@flamingo-goto-wiki.png"/}}\|{{image reference="ReleaseNotesXWiki622@flamingo-goto-space.png"/}}\|{{image reference="ReleaseNotesXWiki622@flamingo-goto-page.png"/}}
	53	)))
	54	* The languages selection is now located in the top bar. It is displayed only when the multilingual mode is enabled:(((
	55	{{image reference="ReleaseNotesXWiki622@languages.png" width="60%"/}}
	56	When there is no translation available:
	57	{{image reference="ReleaseNotesXWiki622@languages-no-alternative.png"/}}
	58	When there is some translations available:
	59	{{image reference="ReleaseNotesXWiki622@languages-with-alternatives.png"/}}
	60	)))
	61	* The [[Livetable>>extensions:Extension.Livetable Macro]] is now responsive to the screen size, so you can use them with smartphones:(((
	62	{{image reference="ReleaseNotesXWiki622@Livetable-Responsive.png"/}}
	63	)))
	64	* The Flamingo Theme Application now uses a new Color Picker.(((
	65	{{image reference="ReleaseNotesXWiki621@NewColorPicker.png"/}}
	66	)))
	67	* To sum up, this is the new look:(((
	68	{{image reference="ReleaseNotesXWiki622@flamingo.png"/}}
	69	)))
3.5	70	* The "Add" button has now a default action to create a new page. You can still create other kind of contents (Wiki, Space) by using the arrow, just like we do with the different "edit" actions.(((
	71	{{image reference="ReleaseNotesXWiki63M1@flamingo-add.png"/}}
	72	)))
	73
3.1	74	=== Flamingo Themes Application ===
	75
	76	Now, when you click on "Manage color theme" in the Administration, you reach the [[new application to manage the Flamingo Themes>>extensions:Extension.Flamingo Theme Application]]:
	77
	78	{{image reference="ReleaseNotes.ReleaseNotesXWiki624@FlamingoThemeWebHome.png" width="50%"/}}
	79
	80	You can use it to change the current theme, modify any theme or create new ones.
	81
	82	We have also added 3 new themes: Marina, Garden and Kitty.
	83
	84	{{gallery}}
3.9	85	image:ReleaseNotesXWiki63RC1@Marina.png
	86	image:ReleaseNotesXWiki63RC1@Garden.png
	87	image:ReleaseNotesXWiki63RC1@Kitty.png
3.1	88	{{/gallery}}
	89
	90	=== Bootswatch Themes for Flamingo ===
	91
	92	XWiki comes with [[16 new themes for Flamingo>>extensions:Extension.Bootswatch Themes for Flamingo]], that have been adapted from [[Bootswatch>>http://bootswatch.com/]].
	93
	94	{{gallery}}
3.9	95	image:ReleaseNotesXWiki63RC1@Cerulean.png
	96	image:ReleaseNotesXWiki63RC1@Cosmo.png
	97	image:ReleaseNotesXWiki63RC1@Cyborg.png
	98	image:ReleaseNotesXWiki63RC1@Darkly.png
	99	image:ReleaseNotesXWiki63RC1@Flatly.png
	100	image:ReleaseNotesXWiki63RC1@Journal.png
	101	image:ReleaseNotesXWiki63RC1@Lumen.png
	102	image:ReleaseNotesXWiki63RC1@Paper.png
	103	image:ReleaseNotesXWiki63RC1@Readable.png
	104	image:ReleaseNotesXWiki63RC1@Sandstone.png
	105	image:ReleaseNotesXWiki63RC1@Simplex.png
	106	image:ReleaseNotesXWiki63RC1@Slate.png
	107	image:ReleaseNotesXWiki63RC1@Spacelab.png
	108	image:ReleaseNotesXWiki63RC1@Superhero.png
	109	image:ReleaseNotesXWiki63RC1@United.png
	110	image:ReleaseNotesXWiki63RC1@Yeti.png
3.1	111	{{/gallery}}
	112
2.2	113	== Panels Application ==
	114
	115	It is now possible to select which applications are displayed in the App Bar, and which are not:
	116
3.9	117	{{image reference="ReleaseNotesXWiki63M2@customizable-app-bar.png"/}}
2.2	118
3.1	119	== Document Tree Macro ==
	120
	121	We introduce [[a new wiki macro>>extensions:Extension.Document Tree Macro]] to display the hierarchy of documents:
	122
	123	{{code language="none"}}
	124	{{documentTree /}}
	125	{{/code}}
	126
3.9	127	{{image reference="ReleaseNotesXWiki63RC1@docHierarchyTree.png"/}}
3.1	128
	129	=== Document Index Tree ===
	130
	131	The new [[Document Tree Macro>>extensions:Extension.Document Tree Macro]] is now used in the Wiki document index.
	132
3.9	133	{{image reference="ReleaseNotesXWiki63RC1@index-alldocs-tree.png"/}}
3.1	134
	135	=== Navigation Panel ===
	136
24.1	137	We also changed the [[Navigation Panel>>extensions:Extension.Panels Application\|\|anchor="HNavigationPanel"]] to use the new [[Document Tree Macro>>extensions:Extension.Document Tree Macro]].
3.1	138
	139	{{info}}
	140	Very importantly the old Navigation Panel was a performance hog on large wikis and it's not longer the case (since nodes are now opened dynamically and not all documents are loaded in memory)!
	141	{{/info}}
	142
3.9	143	{{image reference="ReleaseNotesXWiki63RC1@navigationPanel.png"/}}
3.1	144
1.1	145	== Miscellaneous ==
	146
2.2	147	* The default color themes (DefaultColorTheme and FlamingoDefaultTheme) have been renamed Azure and Charcoal.
	148	* In the select field of the 'color theme' property, in the administration, the color themes are now ordered by name.
11.1	149	* In the administration, clicking the "Customize" button for customizing a Skin or a Color Theme now opens the page in edit mode.
2.2	150	* Improved L&F when a template fails to render:(((
3.9	151	{{image reference="ReleaseNotesXWiki63M1@templateerror.png" width="650px"/}}
2.2	152	)))
	153	* We have created dedicated groups for Colibri and Flamingo Themes inside the Administration. Every themes can be used with both skins but they looks better when they are used with the corresponding theme.(((
3.9	154	{{image reference="ReleaseNotesXWiki63M1@ColorThemeDisplayer.png"/}}
2.2	155	)))
	156	* The start/stop shell scripts provided with the Standalone Distribution have been improved to display usage information when an invalid parameter is passed or when the ##-h## or ##~-~-help## parameters are passed. Also note that the start script doesn't stop anymore a running XWiki instance if the ##-k## or ##~-~-kill## parameter is passed (this parameter has been removed).
29.1	157	* It's now possible to configure the maximum number of search results to be returned from a search operation using ##xwiki.authentication.ldap.maxresults## property in ##xwiki.cfg## file. See [[LDAP documentation>>Documentation.AdminGuide.Authentication\|\|anchor="HGenericLDAPconfiguration"]].
28.1	158	* The "Empty is today" option on Date fields of classes created with Application Within Minutes is now working as expected. See [[XWIKI-10296>>https://jira.xwiki.org/browse/XWIKI-10296]]
2.2	159	* Office macro can now take a URL as input. See [[extensions:Extension.Office Macro]] for more details
	160	* The standalone distribution now uses Jetty 9.2.3.v20140905 (was using version 8.1.15.v20140411 in XWiki 6.3-milestone-1). This should be transparent for the user since XWiki provides its own start/stop scripts around Jetty.
	161	* The Delete Space feature now lists the documents inside the space you are going to delete. This should help people differentiate between the UI of Delete Page and the UI of Delete Space so that fewer mistakes occur when not paying much attention:(((
3.9	162	{{image reference="ReleaseNotesXWiki63M2@deleteSpaceListDocuments.png"/}}
2.2	163	)))
29.1	164	* Updated [[XAR export URL format>>Documentation.UserGuide.Features.Exports\|\|anchor="HXARExport"]] to allow exporting a full space, a full wiki, or any list of pages matching a pattern. For example:(((
3.1	165	{{code language="none"}}
	166	http://localhost:8080/xwiki/bin/export/Main/WebHome?format=xar&name=test&pages=Main.%25
	167	http://localhost:8080/xwiki/bin/export/Main/WebHome?format=xar&name=test&pages=%25.%25
	168	http://localhost:8080/xwiki/bin/export/Main/WebHome?format=xar&name=test&pages=%25.%25Home
	169	{{/code}}
	170	)))
	171	* Added an edit button to easily change the default Welcome message that is displayed on the homepage. Users have reportedly been struggling with this task for a while now and, until we come up with a new format for the homepage, this is the solution we have proposed to make things easier.(((
3.9	172	{{image reference="ReleaseNotesXWiki63RC1@editWelcomeMessage.png"/}}
3.1	173	)))
	174	* The configuration of the [[Applications Panel>>extensions:Extension.Panels Application\|\|anchor="HApplicationPanel"]] now works with touch-screen devices too.
29.1	175	* The Standalone Distribution [[now has a new startup parameter to enable monitoring/managing the Jetty instance>>Documentation.AdminGuide.Monitoring\|\|anchor="HJMXConsole"]]. You can use it with ##start_xwiki.sh -j## (or ##start_xwiki.sh ~-~-jmx##).
3.1	176	* Updated the notification message when the panel layout is saved to use the standard notification widget.
1.1	177
	178	= For Developers =
	179
4.1	180	== Velocity improvements ==
1.1	181
4.1	182	=== Velocity macros to display users and groups ===
	183
2.2	184	We extracted the code that displays in view mode a property of type 'List of Users' and 'List of Groups' from the corresponding custom displayers (found in ##displayer_users.vm## and ##displayer_groups.vm##) into two Velocity macros that can be used to display arbitrary users and groups, even when you don't have an object. Here's how you can use them:
1.1	185
2.2	186	{{code language="none"}}
	187	{{velocity}}
	188	{{html wiki="true"}}
	189	= Users =
	190	== Just one ==
	191	#displayUser('XWiki.Admin')
1.1	192
2.2	193	== List of users ==
	194	#displayUser(['Admin', 'XWiki.mflorea'])
1.1	195
2.2	196	== A reference of a user ==
	197	#displayUser($xcontext.userReference)
1.1	198
2.2	199	== A list of references of users ==
	200	#displayUser([$xcontext.userReference, $otherUserReference])
1.1	201
2.2	202	= Groups =
	203	== Just one ==
	204	#displayGroup('XWiki.XWikiAdminGroup')
1.1	205
2.2	206	== List of groups ==
	207	#displayGroup(['XWikiAdminGroup','XWiki.HRGroup'])
	208
	209	== A reference of a group ==
	210	#set($adminGroupRef = $services.model.resolveDocument('XWiki.XWikiAdminGroup'))
	211	#set($allGroupRef = $services.model.resolveDocument('XWiki.XWikiAllGroup'))
	212	#displayGroup($adminGroupRef)
	213
	214	== A list of references of groups ==
	215	#displayGroup([$adminGroupRef, $allGroupRef])
	216
	217	{{/html}}
	218	{{/velocity}}
	219	{{/code}}
	220
4.1	221	=== New Velocity Tools ===
2.2	222
	223	* New URL Tool ##$urltool##: A [[new tool>>extensions:Extension.Velocity Module\|\|anchor="HVelocityTools"]] has been added with one method to parse query string from the URL ##$urltool.parseQuery(String)##. The value returned by this is method is a ##Map<String, List<String>>## which maps parameter names to (possibly multiple) values, and can be passed e.g. directly into ##$escapetool.url(Map<String, ?>)## to convert it back to a string. This is useful e.g. in cases where one want to pass a complete query string around between requests, as it happend for the PDF export; the ##$urltool## allows for a sane deserialization of the value passed around.
	224	* New Exception Tool ##$exceptiontool##: A [[new tool>>extensions:Extension.Velocity Module\|\|anchor="HVelocityTools"]] to manipulate Java Exceptions (get root cause, convert into String, etc).
	225	* ##$stringtool## moved from ##org.apache.commons.lang3.StringUtils## to ##org.xwiki.text.StringUtils## which extends the first one and add new stuff
	226
4.1	227	=== Ability to catch Exceptions from Velocity ===
2.2	228
	229	A new Velocity Directive has been added to catch Exceptions from Velocity. In addition a new ###displayUnhandledException()## velocity macro has also been added to nicely display an exception to the user.
	230
	231	For example:
	232
	233	{{code language="velocity"}}
	234	#try()
	235	#set($outputSyntax = $xwiki.getAvailableRendererSyntax($request.outputSyntax, $request.outputSyntaxVersion))
	236	#if ($outputSyntax)
	237	## If the passed syntax is not an HTML-compatible syntax we need to HTML-escape it so that it can be
	238	## displayed fine in HTML (since at the point this vm file is called we're already inside an HTML page with
	239	## panels on the side, header, etc).
	240	#set($syntaxType = $outputSyntax.type.toIdString())
	241	#if (($syntaxType == "xhtml") \|\| ($syntaxType == "html"))
	242	#set ($renderedContent = $tdoc.getRenderedContent($outputSyntax))
	243	#else
	244	## Make sure to print correctly the result when it's not HTML
	245	#set ($renderedContent = "<pre>$escapetool.html($tdoc.getRenderedContent($outputSyntax))</pre>")
	246	#end
	247	#else
	248	#set ($renderedContent = $tdoc.getRenderedContent())
	249	#end
	250	#end
	251	...
	252	<div id="xwikicontent">
	253	#if ("$!exception" != '')
	254	#displayUnhandledException($exception)
	255	#else
	256	$renderedContent
	257	#end
	258	</div>
	259	...
	260	{{/code}}
	261
	262	This generates the following in case of error rendering the page:
	263
3.10	264	{{image reference="ReleaseNotesXWiki63M1@renderingerror.png"/}}
2.2	265
4.1	266	=== New #displayException macro ===
2.2	267
	268	Displays an error message with a title that can be clicked and expands to display an exception.
	269
	270	Example from a wiki page:
	271
	272	{{code language="none"}}
	273	{{velocity}}
	274	#set ($message = $services.mailsender.createMessage())
	275	$message.send()
	276
	277	{{html}}
	278	#displayException("hello world", $services.mailsender.lastError)
	279	{{/html}}
	280	{{/velocity}}
	281	{{/code}}
	282
	283	== Component Disposal ==
	284
	285	The order used by the ComponentManager to dispose its components is computed based on declared dependencies. However there might be cases when you wish a Component's ##dispose()## method to be called before or after all other components. In this case you can use the ##DisposePriority## annotation. The default priority is 1000. A higher value will mean disposing before all other components not having this annotation. For example:
	286
	287	{{code language="java"}}
	288	@Component
	289	@Singleton
	290	@DisposePriority(10000)
	291	public class DefaultHibernateSessionFactory implements HibernateSessionFactory, Disposable
	292	{
	293	...
	294	@Override
	295	public void dispose() throws ComponentLifecycleException
	296	{
	297	... called after other components in order to shut down the database late...
	298	}
	299	...
	300	}
	301	{{/code}}
	302
	303	See the [[Component Reference documentation>>extensions:Extension.Component Module]] for other details.
	304
	305	== New LiveTable Filtering Option ==
	306
	307	You can now specify how the filter value should be matched against the stored value. One use case when this is useful is when you have a live table for an XClass that has a Database List property and you want to use a text input filter instead of the default drop down list filter. Currently the user has to enter the full value in the text input in order to filter. Would be good if partial matching would work. This is possible starting with this version:
	308
	309	{{code language="none"}}
	310	#set ($columnsProperties = {
	311	'doc.name': {'type': 'text', 'size': 10, 'link': 'view'},
	312	...
	313	'myDatabaseList': {'type': 'text', 'size': 10, 'match': 'partial'},
	314	...
	315	})
	316	{{/code}}
	317
	318	Checkout the [[LiveTable Macro documentation>>extensions:Extension.Livetable Macro\|\|anchor="HParameter24columnsProperties"]] for more details about the match option.
	319
	320	== Solr JSON Service ==
	321
	322	You can now make search requests from JavaScript using the Solr JSON service. The results include all the information that is indexed by Solr so you can display them as you wish. See the [[Solr Search Application>>extensions:Extension.Solr Search Application\|\|anchor="HJSONService"]] documentation for more details.
	323
	324	== Document Meta Informations ==
	325
29.1	326	* We have introduced a new JavaScript API to get informations about the current document. See: [[Documentation.DevGuide.JavaScriptAPI\|\|anchor="HGetsomeinformationsaboutthecurrentdocument"]].
2.2	327
3.1	328	== Tree Widget ==
	329
	330	We introduce a [[new JavaScript widget>>extensions:Extension.Tree Widget]] that can be used to create tree views for the structured data stored in the wiki. It is based on [[jsTree>>http://www.jstree.com/]] and thus has support for both static and dynamic (interactive) trees.
	331
	332	== Tree Macro ==
	333
	334	We introduce [[a new wiki macro>>extensions:Extension.Tree Macro]] that allows you to easily define a tree in a wiki page. It uses the tree widget.
	335
	336	{{code language="none"}}
	337	{{tree}}
	338	* Parent
	339	** Child
	340	{{/tree}}
	341
	342	{{tree reference="Space.MyDynamicTree" /}}
	343	{{/code}}
	344
	345	== Improved WebJars Integration ==
	346
	347	We added 2 new features to improve the WebJars Integration:
	348
	349	* You can now omit the WebJar version:(((
	350	{{code language="none"}}
	351	$services.webjars.url('angularjs', 'angular.js')
	352	{{/code}}
	353	)))
	354	* You can use Velocity code in WebJar resources. This means you can use for instance Color Theme variables inside your CSS files that are packaged inside a WebJar:(((
	355	{{code language="none"}}
	356	$services.webjars.url('org.xwiki.contrib:my-webjar', 'style.css', {'evaluate': true})
	357	{{/code}}
	358	)))
	359
	360	See the [[WebJar Integration documentation>>extensions:Extension.WebJars Integration]] for more information.
	361
26.1	362	== Wiki skin templates executed with rights of their author ==
25.1	363
26.1	364	Skin template overrides located in wiki page properties or attachment are executed with the right of their author.
25.1	365
1.1	366	== Miscellaneous ==
	367
2.2	368	* The wiki provisioning job has now the current user set in the context.
	369	* 10 new icons have been mapped into [[Font Awesome Icon Theme>>extensions:Extension.Font Awesome Icon Theme]].
	370	* It's now possible to overwrite the id of a Java bean property using an annotation. See [[extensions:Extension.Properties Module\|\|anchor="HPopulateaJavaBean"]] for more.
	371	* [[It's possible to get DEBUG information only for shutdown operations>>dev:Community.Debugging\|\|anchor="HLoggingshutdownoperations"]] by editing ##logback.xml## and setting:(((
	372	{{code language="xml"}}
	373	<logger name="org.xwiki.shutdown" level="debug"/>
	374	{{/code}}
	375	)))
	376	* When importing an extension unknown but valid versions are not removed anymore
	377	* New ##outputOnlyHtml## option for the ##livetable## macro to output only the HTML, without the syntax specific wrappers. See the [[documentation>>extensions:Extension.Livetable Macro\|\|anchor="HAllacceptedvalues"]].
29.1	378	* Suggest widget now has an extra ##propagateEventKeyCodes## option where key codes can be listed so their events will be propagated. See the [[documentation>>Documentation.DevGuide.AutoSuggestWidget\|\|anchor="HJavascriptparametersfortheXWiki.widgets.Suggestconstructor"]].
	379	* Extended modalPopup.js to support specifying keyboard shortcut options for the defined actions. See the [[documentation>>Documentation.DevGuide.ModalPopup\|\|anchor="HConstructorfieldsfortheModalPopupJavascriptclass"]].
3.1	380	* You can now [[render an icon from any icon theme present on the wiki>>extensions:Extension.Icon Theme Application\|\|anchor="HUsagewithscripts"]], referenced by its name:(((
	381	{{code language="velocity"}}
	382	$services.icon.render('globe', 'Silk')
	383	$services.icon.render('globe', 'Font Awesome')
	384	{{/code}}
	385	)))
1.1	386
2.2	387	== Upgrades ==
	388
	389	The following dependencies have been upgraded:
	390
28.1	391	* [[JGroups 3.5.1>>https://jira.xwiki.org/browse/XWIKI-10987]]
	392	* [[Tika 1.6>>https://jira.xwiki.org/browse/XWIKI-10956]]
	393	* [[reflections 0.9.9>>https://jira.xwiki.org/browse/XCOMMONS-654]]
	394	* [[Groovy 2.3.7>>https://jira.xwiki.org/browse/XCOMMONS-655]]
	395	* [[jQuery 1.11.1>>https://jira.xwiki.org/browse/XWIKI-11094]]
	396	* [[Doxia 1.6>>https://jira.xwiki.org/browse/XRENDERING-364]]
	397	* [[Joda-Time 2.5>>https://jira.xwiki.org/browse/XRENDERING-365]]
	398	* [[commons-compress 1.9>>https://jira.xwiki.org/browse/XCOMMONS-665]]
	399	* [[httpcore 4.3.3>>https://jira.xwiki.org/browse/XCOMMONS-679]]
2.2	400
1.1	401	= Translations =
	402
	403	The following translations have been updated:
	404
2.2	405	{{language codes="de, fr, lv"/}}
1.1	406
	407	= Tested Browsers & Databases =
	408
23.1	409	{{include reference="TestReports.ManualTestReportSummaryXWiki63"/}}
1.1	410
3.11	411	= Performances tests compared to 5.4.6 =
1.1	412
22.1	413	Except for the first-loaded page (which incurs the cost of one-time LESS compilation), we have reached the same performances as 5.4.6 in view mode, which was not the case during the 6.x cycle until now. This is a first milestone to get even better!
1.1	414
4.2	415	{{display reference="test:Performances.Jetty HSQLDB single wiki 546 to 63" section="HSummary"/}}
1.1	416
4.2	417	More details on [[performance comparison on single wiki between 6.3 and 5.4.6>>test:Performances.Jetty HSQLDB single wiki 546 to 63]].
	418
1.1	419	= Known issues =
	420
28.1	421	* [[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]]
1.1	422
	423	= Backward Compatibility and Migration Notes =
	424
	425	== General Notes ==
	426
	427	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.
	428
2.2	429	== Programming Rights disabled for TextArea Properties ==
1.1	430
2.2	431	If you have a class with a TextArea property and in your sheet you use ##$doc.display()## to display this property then you must know that starting with this version the content of the TextArea is rendered without programming rights, even if the last author or content author of the document that has the object with the TextArea property has programming rights. In other words, if you use wiki syntax in the TextArea content and you use script macros inside, the code that requires programming rights won't be executed even if you have the necessary rights. The reason for this change is because we can't know for sure who is the last author of the TextArea's content. We may remove this limitation in the future if we add a way to know the author. A solution we are currently investigating is the usage of signed scripts in TextArea's content. Until then, if you really want to execute the content of your TextArea properties using programming rights then you can use ##$doc.getRenderedContent()## in your sheet, passing the content of the TextArea property.
1.1	432
3.1	433	== Change on velocity macro handling in skin templates ==
	434
	435	Wiki page does not have access anymore to Velocity macros defined in the skin templates (except for macro.vm special template).
	436
27.1	437	== Change on rights handling of wiki skins ==
	438
	439	Templates located in wiki skin properties or attachment are now executed with the right of their author. It means the current document rights does not have any impact anymore on the wiki skin. Note that part of the skin used to be denied programming right (everything executed after the document content) anyway.
	440
1.1	441	== API Breakages ==
	442
3.6	443	The following APIs were modified since XWiki 6.2:
1.1	444
3.1	445	* Add scm informations to extensions descriptors. Should be safe enough since most repository handlers extend AbstractExtension instead of directly implement Extension
	446
1.1	447	{{code language="none"}}
2.2	448	org.xwiki.extension.Extension: Method 'public org.xwiki.extension.ExtensionIssueManagement getIssueManagement()' has been added to an interface
3.1	449	{{/code}}
2.2	450
3.1	451	* Add issue management informations to extensions descriptors. Should be safe enough since most repository handlers extend AbstractExtension instead of directly implement Extension
	452
2.2	453	{{code language="none"}}
	454	org.xwiki.extension.Extension: Method 'public org.xwiki.extension.ExtensionScm getScm()' has been added to an interface
3.1	455	{{/code}}
2.2	456
3.1	457	* Never really been supposed to be exposed as an API.
	458
2.2	459	{{code language="none"}}
	460	com.xpn.xwiki.objects.BaseElement: Accessibility of field localEntityReferenceSerializer has been weakened from protected to private
	461	com.xpn.xwiki.doc.XWikiDocument: Method 'public java.lang.String ajc$privMethod$com_xpn_xwiki_doc_XWikiDocumentCompatibilityAspect$com_xpn_xwiki_doc_XWikiDocument$serializeReference(org.xwiki.model.reference.DocumentReference, org.xwiki.model.reference.EntityReferenceSerializer, org.xwiki.model.reference.DocumentReference)' has been removed
3.1	462	{{/code}}
2.2	463
28.1	464	* Changed the LESSCache interface and the LESS Script Service because the cache was poorly designed (see: [[XWIKI-10776>>https://jira.xwiki.org/browse/XWIKI-10776]])
3.1	465
2.2	466	{{code language="none"}}
	467	org.xwiki.lesscss.LessCompilerScriptService: Method 'public boolean clearCache(java.lang.String)' has been removed
	468	org.xwiki.lesscss.LESSCache: Method 'public void clear(java.lang.String)' has been removed
	469	org.xwiki.lesscss.LESSCache: Method 'public void clearFromColorTheme(java.lang.String)' has been added to an interface
	470	org.xwiki.lesscss.LESSCache: Method 'public void clearFromFileSystemSkin(java.lang.String)' has been added to an interface
	471	org.xwiki.lesscss.LESSCache: In method 'public java.lang.Object get(java.lang.String, java.lang.String, java.lang.String, java.lang.String)' the number of arguments has changed
	472	org.xwiki.lesscss.LESSCache: In method 'public void set(java.lang.String, java.lang.String, java.lang.String, java.lang.String, java.lang.Object)' the number of arguments has changed
3.14	473	{{/code}}
3.1	474
	475	* Added new methods to the unstable Icon Module
	476
	477	{{code language="none"}}
	478	org.xwiki.icon.IconManager: Method 'public java.lang.String render(java.lang.String, java.lang.String)' has been added to an interface
	479	org.xwiki.icon.IconManager: Method 'public java.lang.String render(java.lang.String, java.lang.String, boolean)' has been added to an interface
	480	org.xwiki.icon.IconManager: Method 'public java.lang.String renderHTML(java.lang.String, java.lang.String)' has been added to an interface
	481	org.xwiki.icon.IconManager: Method 'public java.lang.String renderHTML(java.lang.String, java.lang.String, boolean)' has been added to an interface
	482	org.xwiki.icon.IconSetCache: Method 'public void clear(java.lang.String, java.lang.String)' has been added to an interface
	483	org.xwiki.icon.IconSetCache: Method 'public org.xwiki.icon.IconSet get(java.lang.String, java.lang.String)' has been added to an interface
	484	org.xwiki.icon.IconSetCache: Method 'public void put(java.lang.String, java.lang.String, org.xwiki.icon.IconSet)' has been added to an interface
	485	org.xwiki.icon.IconSetManager: Method 'public org.xwiki.icon.IconSet getIconSet(java.lang.String)' has been added to an interface
	486	{{/code}}

Wiki source code of Release Notes for XWiki 6.3

Quick Links

Let us know

About

About

Support

Platform

User Guide

Admin Guide

Developer Guide

Projects

XWiki

Extensions

Other

Contribute

Status

Practices

Under the Hood

Get Involved

Get Connected