Wiki source code of Release Notes for XWiki 6.0 Milestone 1

Version 86.1 by Thomas Mortagne on 2014/03/24

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
	7	<insert description of release here>
	8
	9	= New and Noteworthy (since XWiki 5.4) =
	10
82.1	11	[[Full list of issues fixed and Dashboard for 6.0>>http://jira.xwiki.org/secure/Dashboard.jspa?selectPageId=12193]].
1.1	12
32.1	13	== Moved to Java 7 as minimum version ==
1.1	14
63.1	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 anymore on Java 6.
1.1	16
19.1	17	== Wiki Application ==
	18
21.1	19	* In the Wiki Index, all the wikis that the user can not access [[are not displayed anymore>>extensions:Extension.Wiki Application\|\|anchor="HNewmenusandWikiIndex"]].
62.1	20	* Now, by default, guest users can see a subwiki depending if they can see the main one. But of course, it is still possible to manually give view right to guest users in the subwiki's administration.
19.1	21
35.1	22	== New Chart Renderers ==
	23
	24	The ##stackedbar## and ##stackedbar3D## plot renderers were added in the [[Chart Macro>>extensions:Extension.Chart Macro]]:
	25
	26	{{image reference="stackedbar.png"/}}
	27
	28	{{image reference="stackedbar3D.png"/}}
	29
55.1	30	== Panels Application Improvements ==
	31
	32	* The [[Panels Application>>extensions:Extension.Panels Application]] is now available from the Applications Panel:(((
	33	{{image reference="panels-application.png"/}}
	34	)))
	35	* The Panels Application's home page now uses a LiveTable to display the list of available Panels:(((
58.1	36	{{image reference="panels-home.png"/}}
55.1	37	)))
	38
66.1	39	== Standard XAR import scalability ==
	40
83.1	41	The standard XAR import (in administration) is now based on [[WikiStream>>extensions:Extension.WikiStream Module]] by default. This means that you should (at last) be able to import a XAR of any size (as long as you can attach it to the import page since that's how import UI is working right now).
66.1	42
	43	You can put back old system if any issue using ##xwiki.action.import.xar.usewikistream## property in ##xwiki.cfg## file.
	44
73.1	45	== Experimental Flamingo Skin ==
70.1	46
73.1	47	A new skin is now bundled in XWiki: Flamingo. The skin use the well-known [[Bootstrap framework>>http://getbootstrap.com/]] framework which gives us a modern look-and-feel and makes the UI responsive and thus working on mobile devices.
70.1	48
76.1	49	{{warning}}
	50	The skin is currently an alpha version and should not be used in production. In addition, only the view mode is currently implemented.
	51	{{/warning}}
70.1	52
73.1	53	{{image reference="flamingo.png" width="65%"/}}
70.1	54
73.1	55	To active the skin (for testing purpose only at the moment), edit ##XWiki.DefaultSkin## and put "##flamingo##" in the "base skin" field or add ##?skin=flamingo## to your URLs.
	56
1.1	57	== Miscellaneous ==
	58
13.1	59	* The document references are displayed as //wiki >> Space >> Page// path in the extension install log.(((
	60	{{image reference="docRefInExtensionLog.png"/}}
	61	)))
18.1	62	* The "membership type" options are more clear(((
47.1	63	{{image reference="membershipType.png"/}}
18.1	64	)))
45.1	65	* The date search facets have a new option 'Older than 30 days':(((
	66	{{image reference="dateFacet.png"/}}
	67	)))
42.1	68	* Added built in support for Apple's open directory groups in LDAP authenticator
	69	* Generate extension event in Wikistream XAR input module when the XAR contains extension informations
43.1	70	* Add new Locale based API to manipulate current Locale:(((
	71	~{~{code language="velocity}}
	72	$xcontext.locale
	73	$xcontext.interfaceLocale
	74	~{~{/code}}
	75	)))
61.2	76	* The [[Container Macro>>extensions:Extension.Container Macro]] is now responsive. So if there is not enough place to display several columns side by side, they are displayed instead one after the other in a vertical alignment.(((
60.1	77	[[{{image reference="responsive.png" width="35%"/}}>>attach:responsive.png]]
	78	)))
63.1	79	* The Windows Installer (EXE) now also work on Windows 8 and Windows 8.1.
68.1	80	* By default the Total Installs and Active Installs figures displayed by the [[Active Installs Application>>extensions:Extension.Active Installs Server Application]] now counts non-SNAPSHOT XWiki Enterprise instances (it used to count everything: SNAPSHOTs installs and even non-XE instances).
81.1	81	* Authenticators can be installed as extensions. Note that they still require to modify xwiki.cfg to indicate the selected authenticator.
85.1	82	* A new macro ~{~{watchlist/}} can be used to embed the watchlist of the current user on any page. This is especially useful for a dashboard:(((
	83	{{image reference="watchlist.png"/}}
	84	)))
18.1	85
63.2	86	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+%226.0-milestone-1%22&tempMax=1000]] fixed in this release.
1.1	87
	88	= For Developers =
	89
51.1	90	== Solr ==
47.1	91
51.1	92	=== Advanced Search Suggest Sources ===
	93
48.2	94	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.
48.1	95
	96	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
	97
	98	{{code language="none"}}
	99	type:DOCUMENT AND (title:(__INPUT__) OR name:(__INPUT__))
	100	{{/code}}
	101
	102	could be written as
	103
	104	{{code language="none"}}
	105	fq=type:DOCUMENT
	106	qf=title^2 name
	107	{{/code}}
	108
	109	Note that:
	110
	111	* 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
	112	* you would be able to specify the boost for each field you want to search in
	113	* the query statement used is '~_~_INPUT~_~_' by default, if not specified.
	114
	115	In order to preserve backward compatibility with existing Solr Search Suggest Sources, we use the following convention:
	116
	117	> 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.
	118
	119	For example:
	120
	121	{{code language="none"}}
	122	foo __INPUT__* bar
	123	fq=type:DOCUMENT
	124	qf=title^2 name
	125	{{/code}}
	126
	127	means the query statement is 'foo ~_~_INPUT~_~_* bar'. Which is equivalent to:
	128
	129	{{code language="none"}}
	130	q=foo __INPUT__* bar
	131	fq=type:DOCUMENT
	132	qf=title^2 name
	133	{{/code}}
	134
48.3	135	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.
48.1	136
51.1	137	=== Search UI Configuration ===
49.1	138
52.1	139	Application developers can now easily create a dedicated search page for their application, tailored for the application data. You can take a look at the [[FAQ application>>extensions:Extension.FAQ Application]] for example:
49.1	140
50.1	141	{{code language="none"}}
	142	{{include reference="XWiki.SearchCode"/}}
	143
52.1	144	{{velocity output="false"}}
50.1	145	#if ($searchEngine == 'solr')
52.1	146	## Customize the Solr Search UI for the FAQ application.
	147	#set ($solrConfig = {
	148	'queryFields': 'title^3 property.FAQCode.FAQClass.answer',
	149	'facetFields': ['creator', 'creationdate', 'author', 'date', 'mimetype', 'attauthor', 'attdate', 'attsize'],
	150	'filterQuery': [
	151	'type:DOCUMENT',
	152	"wiki:$xcontext.database",
	153	"space_exact:$doc.space",
	154	'class:FAQCode.FAQClass'
	155	]
	156	})
50.1	157	#end
	158	{{/velocity}}
	159
	160	{{velocity}}
	161	{{include reference="$searchPage"/}}
	162	{{/velocity}}
	163	{{/code}}
	164
51.1	165	=== Faceting on Object Properties ===
	166
	167	In XWiki 5.3 we added support for [[faceting on object properties>>ReleaseNotesXWiki53\|\|anchor="HFacetingandSortingonObjectProperties"]] but the facets were not displayed nicely. We improved the facet display in this release so that the property type is taken into account: e.g. a facet on a date property will be displayed using the date facet (same as for the document creation date or the last modification date). Moreover, you can now configure the facet displayer to use and even create your own facet displayer. See the [[Solr Search Application>>extensions:Extension.Solr Search Application\|\|anchor="HFacetingonObjectProperties"]] for details.
	168
27.1	169	== Action API ==
1.1	170
27.1	171	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).
1.1	172
27.1	173	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.
1.1	174
28.1	175	== WebJars Integration ==
	176
	177	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.
	178
54.1	179	== LiveTable Query Filters ==
	180
	181	It's now possible to specify which [[Query filters to apply when retrieving LiveTable data>>extensions:Extension.Livetable Macro]].
	182
	183	For example if you want to show always hidden docs, then you would use:
	184
	185	{{code language="none"}}
	186	...
	187	'queryFilters': 'currentLanguage',
	188	...
	189	{{/code}}
	190
	191	And if you wish to show all docs for all languages and hidden docs you would use:
	192
	193	{{code language="none"}}
	194	...
	195	'queryFilters': '',
	196	...
	197	{{/code}}
	198
72.1	199	== Bootstrap ==
	200
	201	[[Bootstrap v3.1.1>>http://getbootstrap.com/]] is now bundled in XWiki. To use it, you can write:
	202
	203	{{code language="velocity"}}
	204	$xwiki.ssfx.use("uicomponents/bootstrap3/bootstrap.css") ## for stylesheets.
	205	$xwiki.jsfx.use("uicomponents/bootstrap3/bootstrap.js") ## for javascripts.
	206	{{/code}}
	207
	208	Note that due to some incompatibilities between bootstrap and [[prototype>>http://prototypejs.org/]] (which was the default javascript framework in XWiki for ages), you should read this [[excellent article>>http://softec.lu/site/DevelopersCorner/BootstrapPrototypeConflict]].
	209
26.2	210	== Miscellaneous ==
	211
	212	* 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.
	213	* The XAR plugin's ##verify## mojo now also handles the ##defaultLanguage## check accordingly.
	214	* The XAR plugin's ##verify## mojo now checks for missing license headers (if the ##formatLicense## configuration property is set to ##true##).
34.1	215	* The XAR plugin's ##format## and ##verify## mojos now support including/excluding files.
30.1	216	* 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.
31.1	217	* ##$services.wiki.getAll()## makes a better use of its internal cache, so the performances are better.
64.1	218	* New API to test if logs of specific level exist in LogQueue.
65.1	219	* Added support for several sets of properties for the same reference in ##org.xwiki.model.reference.EntityReferenceSet##.
26.2	220
27.1	221	== Deprecated and Retired projects ==
	222
40.1	223	* ##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]].
27.1	224
1.1	225	== Upgrades ==
	226
	227	The following dependencies have been upgraded:
	228
	229	* [[Logback 1.1.0>>http://jira.xwiki.org/browse/XCOMMONS-523]]
2.1	230	* [[commons-codec 1.9>>http://jira.xwiki.org/browse/XCOMMONS-524]]
4.1	231	* [[JRuby 1.7.10>>http://jira.xwiki.org/browse/XWIKI-8680]]
6.1	232	* [[cssparser 0.9.13>>http://jira.xwiki.org/browse/XCOMMONS-526]]
7.1	233	* [[doxia 1.5>>http://jira.xwiki.org/browse/XRENDERING-330]]
9.1	234	* [[Groovy 2.2.1>>http://jira.xwiki.org/browse/XCOMMONS-527]]
	235	* [[HttpClient 4.3.2>>http://jira.xwiki.org/browse/XCOMMONS-528]]
11.1	236	* [[JGroups 3.4.2>>http://jira.xwiki.org/browse/XWIKI-9969]]
12.1	237	* [[XStream 1.4.6>>http://jira.xwiki.org/browse/XCOMMONS-529]]
22.1	238	* [[SLF4J 1.7.6>>http://jira.xwiki.org/browse/XCOMMONS-530]]
23.1	239	* [[Commons FileUpload 1.3.1>>http://jira.xwiki.org/browse/XCOMMONS-532]]
39.1	240	* [[Aether 0.9.0.M4>>http://jira.xwiki.org/browse/XCOMMONS-444]]
41.1	241	* [[GWT 2.6>>http://jira.xwiki.org/browse/XWIKI-10073]]
	242	* [[SmartGWT 4.0>>http://jira.xwiki.org/browse/XCOMMONS-536]]
74.1	243	* [[Jest 0.1.0>>http://jira.xwiki.org/browse/XWIKI-10158]]
76.1	244	* [[Maven 3.2.1>>http://jira.xwiki.org/browse/XCOMMONS-546]]
80.2	245	* [[commons-beanutils 1.9.1>>http://jira.xwiki.org/browse/XCOMMONS-547]]
78.1	246	* [[commons-compress 1.8>>http://jira.xwiki.org/browse/XCOMMONS-525]]
79.1	247	* [[commons-lang3 3.3.1>>http://jira.xwiki.org/browse/XCOMMONS-548]]
80.1	248	* [[Guava 16.0.1>>http://jira.xwiki.org/browse/XCOMMONS-481]]
86.1	249	* [[Apache Lucene and Solr 4.7.0>>http://jira.xwiki.org/browse/XWIKI-8911]]
1.1	250
	251	= Translations =
	252
	253	The following translations have been updated:
	254
	255	{{language codes="none, none"/}}
	256
	257	= Tested Browsers & Databases =
	258
	259	{{include reference="TestReports.ManualTestReportTemplateSummary"/}}
	260
	261	= Known issues =
	262
	263	* [[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]]
	264
	265	= Backward Compatibility and Migration Notes =
	266
	267	== General Notes ==
	268
	269	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.
	270
33.1	271	== Moved to Java 7 as minimum version ==
1.1	272
33.1	273	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.
1.1	274
53.1	275	== Crypto Modules moved to Commons ==
	276
	277	The crypto modules (except the script service) have been moved to xwiki-commons. Developers should be careful to update their dependencies.
	278
75.1	279	== Active Installs ==
	280
	281	The Active Installs feature now requires an ElasticSearch server version 1.0.0 or greater.
	282
1.1	283	== API Breakages ==
	284
	285	The following APIs were modified since <project> <version - 1>:
	286
	287	{{code language="none"}}
	288	<clirr output here>
	289	{{/code}}

Wiki source code of Release Notes for XWiki 6.0 Milestone 1

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