Wiki source code of Release Notes for XWiki 7.3

Version 4.20 by Ecaterina Moraru (Valica) on 2015/11/10

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
4.7	7	This is a stabilisation release focusing on the Nested Pages feature which was introduced in XWiki 7.2. Lots of polishing has been done for the Nested Pages feature integration and its consequences on the UI redesign (modified menus for example). The release includes a couple of bug fixes, a few dependency upgrades and new UI extension points available for extension developers.
1.1	8
4.2	9	= New and Noteworthy (since XWiki 7.2) =
1.1	10
4.4	11	[[Full list of issues fixed and Dashboard for 7.3>>http://jira.xwiki.org/secure/Dashboard.jspa?selectPageId=13500]].
1.1	12
4.8	13	== Flamingo ==
1.1	14
4.11	15	=== Navigation bar ===
4.9	16
4.11	17	* The user's avatar is now displayed between the search icon and the drawer icon:(((
	18	{{image reference="ReleaseNotesXWiki73M1@avatar.png"/}}
	19	)))
1.1	20
4.12	21	* (((Also the search bar on the top of the screen have been improved a bit.
4.11	22
4.8	23	When the user clicks on the search button, the search bar is opened and gets the focus. Then, when the users clicks in other place, the search bar is closed, slowly.
	24
	25	* Closed:(((
	26	{{image reference="ReleaseNotesXWiki73M1@search-closed.png"/}}
	27	)))
	28	* Open:(((
	29	{{image reference="ReleaseNotesXWiki73M1@search.png"/}}
	30	)))
4.12	31	)))
4.8	32
4.16	33	=== Menus ===
4.14	34
	35	The "More Options" menu has been split and a new "Page Administration" menu has been introduced:
	36
	37	{{gallery}}
	38	image:ReleaseNotesXWiki73M2@content_menus.png
	39	image:ReleaseNotesXWiki73M2@page-admin-menus.png
	40	image:ReleaseNotesXWiki73M2@more-options-menu.png
	41	{{/gallery}}
	42
4.13	43	=== Drawer ===
4.9	44
	45	* In the Drawer (top right menu), the pages for which the user doesn't have permissions to access are not displayed anymore.
	46
4.14	47	== Breadcrumb ==
	48
	49	When the hierarchy of a Nested Pages is long, we do not display it entirely any more. Instead, we display a limited version, that the user can expand by clicking on the "ellipsis" character ('...'):
	50
	51	* limited:(((
	52	{{image reference="ReleaseNotesXWiki73M2@breadcrumb-limited.png"/}}
	53	)))
	54	* full:(((
	55	{{image reference="ReleaseNotesXWiki73M2@breadcrumb-full.png"/}}
	56	)))
	57
	58	Note that this behavior have also been added to all hierarchy breadcrumbs, including location of search results, etc...
	59
	60	(((
	61	{{image reference="ReleaseNotesXWiki73M2@breadcrumb-search-results.png"/}}
	62	)))
	63
	64	The breadcrumb has now support for tree navigation. Each breadcrumb element has a drop down tree that shows the siblings and the children, helping you navigate easily around the wiki.
	65
	66	{{image reference="ReleaseNotesXWiki73M2@breadcrumbsTreeNavigation.png"/}}
	67
4.17	68	== Flamingo Theme Editor ==
	69
	70	The [[extensions:Extension.Flamingo Theme Application]] now handles the ##@lessCode## field. It means that you can add any code, written with LESS, to your theme and see the result live!
	71
	72	{{image reference="ReleaseNotesXWiki73M1@LESSCode.png" width="40%"/}}
	73
4.14	74	== Page Index ==
	75
	76	Since we have introduced the concept of Nested Spaces we needed to replace the Space column in the LiveTable with a more generic solution. Thus, the [[extensions:Extension.Index Application]] has now merged the previous Page + Space columns into a single ##Location## column and we've introduced new ##Title## column but which now displays the title of pages, as can be seen on the following screenshot:
	77
	78	{{image reference="ReleaseNotesXWiki73M2@livetable-location.png" width="50%"/}}
	79
	80	The same strategy is implemented for the ##children## and the ##siblings## viewers.
	81
	82	Note that you can filter at several path levels in the Location column. For example:
	83
	84	{{image reference="ReleaseNotesXWiki73M2@location-filter.png" width="50%"/}}
	85
	86	{{info}}
	87	XWiki currently doesn't support filtering on Page titles which is why the new ##Title## column doesn't allow filtering. However since the ##Location## column includes the full path, users can still search on Page names.
	88
	89	At a technical level the displaying of page titles was needed because all non-terminal pages names are called ##WebHome## and displaying that would not be user-friendly.
	90	{{/info}}
	91
	92	== New Panels ==
	93
	94	* A [[Children Panel>>extensions:Extension.Panels Application\|\|anchor="HChildrenPanel"]] has been added to display the list of Children pages of the current Page.(((
	95	{{image reference="ReleaseNotesXWiki73M2@children.png"/}}
	96	)))
	97	* A [[Siblings Panel>>extensions:Extension.Panels Application\|\|anchor="HSiblingsPanel"]] has been added to display the list of Sibling pages of the current Page.(((
	98	{{image reference="ReleaseNotesXWiki73M2@siblings.png"/}}
	99	)))
	100	* The [[SpaceDocs Panel>>extensions:Extension.Panels Application\|\|anchor="HSpaceDocsPanel"]] has been deprecated and the [[Children Panel>>extensions:Extension.Panels Application\|\|anchor="HChildrenPanel"]] or [[Siblings Panel>>extensions:Extension.Panels Application\|\|anchor="HSiblingsPanel"]] should be used instead. A warning message has been added (visible only to Admins) to explain this:(((
	101	{{image reference="ReleaseNotesXWiki73M2@spacedocs-warning.png"/}}
	102	)))
	103
	104	== App Within Minutes ==
	105
	106	Up until this version, the applications created with App Within Minutes were always located in a top level space. For instance, if you wanted to create a "Meeting" application, the application data space was "Meeting". Starting with this version you can also create an application in a nested space. In the first step of the wizard you can select the location where you want the application to be created. In the following image I have create an application with path "Marius / Apps / Meeting".
	107
	108	{{image reference="ReleaseNotesXWiki73M2@appLocationPicker.png" width="600"/}}
	109
4.17	110	== Office Importer ==
	111
	112	The [[extensions:Extension.Office Importer Application]] has been redesigned visually and now supports importing into Nested Spaces:
	113
	114	{{image reference="ReleaseNotesXWiki73M1@OfficeImporter" width="50%"/}}
	115
4.14	116	== Template Providers Administration ==
	117
	118	The template provider UI has been adapted to Nested Pages and it now supports:
	119
	120	* Creating template providers deeper than the first level (as it was restricted before), reusing the location picker widget
	121	* Setting allowed locations (i.e. spaces) using the tree widget
	122
	123	{{gallery}}
	124	image:ReleaseNotesXWiki73M2@TemplateProviderCreationUI-NestedPages.png
	125
	126	image:ReleaseNotesXWiki73M2@TemplateProviderEditUI-NestedPages.png
	127
	128	image:ReleaseNotesXWiki73M2@TemplateProviderViewUI-NestedPages.png
	129	{{/gallery}}
	130
	131	For more details, see the [[XWIKI-12275>>http://jira.xwiki.org/browse/XWIKI-12275]] issue and the [[documentation>>extensions:Extension.Administration Application\|\|anchor="HTemplates"]].
	132
	133	== XClass Application ==
	134
	135	The [[XClass Application>>extensions:Extension.XClass Application]] has been modified to support classes defined in nested documents. The default class sheet has been improved to use the new location picker when creating a new class entry, and the list of existing entries is now displayed using a live table. The 'Data types' page has been improved to use the new location picker when creating a new class, and the list of existing classes (data types) is now displayed using a live table.
	136
	137	{{gallery}}
	138	image:ReleaseNotesXWiki73M2@classSheet.png
	139	image:ReleaseNotesXWiki73M2@dataTypes.png
	140	{{/gallery}}
	141
1.1	142	== Miscellaneous ==
	143
4.8	144	* The Extension Diff view has been improved to display the page (translation) language both in the summary and the detail sections. The page name (heading) from the detail section is now a link to the local version of the page.(((
	145	{{image reference="ReleaseNotesXWiki73M1@extensionDiff.png" width="200"/}}
	146	)))
	147	* Added the Actions column for the [[FAQ Application>>extensions:Extension.FAQ Application]]:(((
	148	{{image reference="ReleaseNotesXWiki73M1@faqActions.png"/}}
	149	)))
	150	* Pages with Slovak and Brazilian Portuguese language are now indexed by Solr and thus they are included in the search results. See the [[Migration Notes>>\|\|anchor="HIssuesspecifictoXWiki7.3-milestone-1"]] below in case you are performing an upgrade and you want support for these languages.
	151	* Clicking on the Logo (top-left of the screen) will now take you to the page that you have configured as wiki homepage by using the "Wiki Administration > Wikis > Descriptor" section. See the related [[documentation section>>extensions:Extension.Wiki Application\|\|anchor="HConfigureWiki"]].
	152	* The template providers edition has been rewritten to be more consistent with other edit forms:(((
	153	{{image reference="ReleaseNotesXWiki73M1@template-provider-edit.png" width="50%"/}}
	154	)))
	155	* Removed the 'Edit' button when editing a template provider document. See [[XWIKI-12675>>http://jira.xwiki.org/browse/XWIKI-12675]]
	156	* The [[Invitation Application>>extensions:Extension.Invitation Application]] now has an entry point in the App Bar (only visible to Admins).
4.15	157	* The [[Active Installs Client module>>extensions:Extension.Active Installs Client API\|\|anchor="HFormatEvolution"]] had a bug leading to the ##sinceDays## field not being set correctly (was almost always set to 0).
	158	* [[New ##xpage## parameter>>platform:DevGuide.Standard URL Format\|\|anchor="HParameter:xpage"]]: ##outputTitle##. If ##true## then also display the title in addition to the content. Defaults to ##false## if not specified.
	159	* The XWiki Syntax help now no longer shows help for syntaxes that are not available in the wiki.
4.8	160
4.5	161	See the [[full list of JIRA issues>>http://jira.xwiki.org/issues/?filter=14214]] fixed in this release.
1.1	162
	163	= For Developers =
	164
4.15	165	== Extension Manager ==
1.1	166
4.8	167	=== Custom repositories ===
	168
	169	Extensions and dependencies can now provide custom repositories. For now only dependencies repositories are directly used when resolving it before trying registered repositories.
	170
	171	In practice it means that Maven custom repositories are now supported properly (at least to resolve artifacts dependencies). On Extension Manager side it means you get the same custom repositories duplicated in the Extension and in each ExtensionDependency.
	172
	173	Support also been added to Extension Repository API. It's also imported in XWiki based Extension Repository implementation but not yet exposed as REST resource.
	174
	175	=== Resolve dependencies in extension repository first ===
	176
	177	The extension repository is checked first when searching for extension dependencies.
	178
4.15	179	== Extensions Repository ==
4.8	180
4.15	181	* New Extensions are now created in their own space by default (as the space home page). It will make it easier to organize documentation for large Extensions.
	182	* Custom Extension repositories are now sent by the Extension Repository REST service
	183
	184	== REST API ==
	185
4.8	186	It's now possible to get a page with everything but attachment content: for this you can enable various part of the document using the following URL parameters:
	187
	188	* ##objects##: enable returning document objects
	189	* ##class##: enable returning document class properties
	190	* ##attachments##: enable returning document attachments
	191
	192	They are all disabled by default.
	193
	194	Page objects support has also been added to the Page PUT API.
	195
	196	=== REST supports ##hidden## ===
	197
2.4	198	You can now set and/or get information from the status ##hidden## of a page with REST service. For example, you may create a hidden page using the following file and the following request.
2.3	199
2.4	200	{{code language="xml"}}
	201	<page xmlns="http://www.xwiki.org">
4.1	202	<title>Test of hidden</title>
	203	<hidden>true</hidden>
	204	<content/>
2.4	205	</page>
	206	{{/code}}
1.1	207
2.4	208	{{code language="none"}}
	209	curl \
	210	--verbose \
	211	--user Admin:admin \
	212	--request PUT \
	213	--header "Content-type: application/xml" \
	214	--data-binary "@page.xml" \
	215	"http://localhost:8080/xwiki/rest/wikis/xwiki/spaces/SomeSpace/pages/SomePage"
	216	{{/code}}
	217
	218	And then check the status of this ##hidden## status with a ##GET## HTTP request
	219
	220	{{code language="none"}}
	221	curl \
	222	--verbose \
	223	--user Admin:admin \
	224	--request GET \
	225	--header "Accept: application/xml" \
	226	"http://localhost:8080/xwiki/rest/wikis/xwiki/spaces/SomeSpace/pages/SomePage"
	227	{{/code}}
	228
	229	You may also use the ##application/x-www-form-urlencoded## to set this ##hidden## field.
4.1	230
	231	{{code language="none"}}
	232	curl \
2.4	233	--verbose \
	234	--user Admin:admin \
	235	--request PUT \
	236	--header "Content-type: application/x-www-form-urlencoded" \
	237	--data "title=Test of hidden&hidden=true&content=" \
4.1	238	"http://localhost:8080/xwiki/rest/wikis/xwiki/spaces/SomeSpace/pages/SomePage"
	239	{{/code}}
2.4	240
4.8	241	See [[The XWiki RESTful API>>platform:Features.XWikiRESTfulAPI]] for more details.
1.1	242
4.15	243	== Flamingo ==
1.1	244
4.15	245	The Drawer menu and the content menus are now implemented with [[UI extensions>>extensions:Extension.UIExtension Module]]. The new Extension Points are:
1.1	246
4.18	247	\|= [[##org.xwiki.plaftorm.drawer##>>platform:ExtensionPoint.DrawerItem]]\|=[[##org.xwiki.plaftorm.drawer.header##>>platform:ExtensionPoint.DrawerHeaderItem]]\|= [[##org.xwiki.plaftorm.editactions##>>platform:ExtensionPoint.Edit Actions]]\|=[[##org.xwiki.plaftorm.adminactions##>>platform:ExtensionPoint.Admin Actions]]\|=[[##org.xwiki.plaftorm.moreoptions##>>platform:ExtensionPoint.More Options]]
4.8	248	\|(((
4.20	249	{{image reference="ReleaseNotesXWiki73M1@drawer-with-languages.png" width="50%"/}}
4.8	250	)))\|(((
4.20	251	{{image reference="ReleaseNotesXWiki73M1@drawer-header.png" width="50%"/}}
4.19	252	)))\|(((
4.18	253	{{image reference="ReleaseNotesXWiki73M2@editactions.png" width="50%"/}}
4.15	254	)))\|(((
4.18	255	{{image reference="ReleaseNotesXWiki73M2@adminactions.png" width="50%"/}}
4.15	256	)))\|(((
4.18	257	{{image reference="ReleaseNotesXWiki73M2@moreoptions.png" width="50%"/}}
4.15	258	)))
1.1	259
4.15	260	The extension point [[platform:ExtensionPoint.DrawerItem]] has now a parameter ##separator## to add a line separator before the drawer item.
	261
1.1	262	== Miscellaneous ==
	263
4.8	264	* New ##getReference()## API public scripting Element (Object, Class, etc.) to get the EntityReference of the element
	265	* New functional tests for the [[extensions:Extension.Office Importer Application]] have been added to ##xwiki-platform##. To enable them, you need to enable the new profile ##office-tests##.
	266	* For testing purpose, an environment variable ##XWIKI_OFFICE_HOME## can bet set to configure where the Office server is installed on the system.
	267	* New [[Time Zone XProperty type>>platform:DevGuide.DataModel]] to represent Time Zones.
	268	* The [[XAR plugin>>dev:Community.XARPlugin]] now verifies that Technical Pages are set as hidden and the Format Mojo sets them as hidden.
	269	* A new [[XAR Integration testing framework>>dev:Community.Testing\|\|anchor="HXARTesting"]] has been introduced. It can be used to write integration tests for wiki pages.
	270	* Issue management information are now imported, displayed and exposed in the REST service in the Extensions Repository
4.15	271	* A ##displayTitle## option has been added to the hierarchy macros. By default, it is set to true. When disabled, the names of the references are displayed in the breadcrumb, instead of the document titles.
	272	* The ##documentTree## macro has been moved to its own module, under the Index application, so that it can be used as a dependency in other modules without pulling the entire Index application.
4.8	273
1.1	274	* XAR plugin's [[Verify Mojo>>dev:Community.XARPlugin\|\|anchor="HVerifyMojo"]] can now verify that defined pages have matching titles.
2.1	275	* log4j 1.2.17 and commons-logging 1.2 are now found as core extension (which prevent them being installed as dependencies)
1.1	276
4.8	277	== Deprecated and Retired projects ==
	278
	279	* The [[XML-RPC Integration>>extensions:Extension.XML-RPC Integration]] has been retired. It had been deprecated several years ago in favor of the [[REST API>>platform:Features.XWikiRESTfulAPI]] and it wasn't actively supported.
	280
	281	== Upgrades ==
	282
	283	The following dependencies have been upgraded:
	284
	285	* [[JSqlParser 0.9.4>>http://jira.xwiki.org/browse/XWIKI-12603]]
	286	* [[Jackson 2.6.2>>http://jira.xwiki.org/browse/XCOMMONS-848]]
	287	* [[httpclient 4.5.1>>http://jira.xwiki.org/browse/XCOMMONS-850]]
	288	* [[Groovy 2.4.5>>http://jira.xwiki.org/browse/XCOMMONS-852]]
	289	* [[Restlet 2.3.5 and JAX-RS 2>>http://jira.xwiki.org/browse/XCOMMONS-341]]
	290	* [[Lucene and Solr 5.3.1>>http://jira.xwiki.org/browse/XWIKI-12131]]
	291	* [[LessJs 2.5.3>>http://jira.xwiki.org/browse/XWIKI-12655]]
	292	* [[Jetty 9.2.13.v20150730>>http://jira.xwiki.org/browse/XWIKI-12677]]. Note that this dependency is used only in the Jetty distribution.
4.15	293	* [[Jackson 2.6.3>>http://jira.xwiki.org/browse/XCOMMONS-861]]
	294	* [[LiveValidation 1.4>>http://jira.xwiki.org/browse/XWIKI-12712]]
4.8	295
1.1	296	= Translations =
	297
	298	The following translations have been updated:
	299
4.8	300	{{language codes="da, sk, fr, hu, pt_BR"/}}
1.1	301
4.6	302	{{comment}}
1.1	303	= Tested Browsers & Databases =
	304
	305	{{warning}}
	306	The QA Tests are executed after the release has been done. Thus, they are being prepared now and will be published soon.
	307	{{/warning}}
4.6	308	{{/comment}}
1.1	309
	310	{{comment}}
	311	TODO: uncomment and update with proper link when the report is ready.
	312	{{include reference="TestReports.ManualTestReportTemplateSummary"/}}
	313	{{/comment}}
	314
4.6	315	{{comment}}
1.1	316	= Performances tests compared to <last super stable version> =
	317
	318	<a summary of the comparison with latest super stable version>
	319
	320	More details on <link to the test report>.
4.6	321	{{/comment}}
1.1	322
	323	= Known issues =
	324
	325	* [[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]]
	326
	327	= Backward Compatibility and Migration Notes =
	328
	329	== General Notes ==
	330
	331	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.
	332
4.6	333	== Issues specific to XWiki 7.3 ==
1.1	334
4.8	335	* If you had modified the custom displayer for Time Zones in either ##XWiki.XWikiUsers## or ##XWiki.XWikiPreferences## then when upgrading to 7.3M1 your change will be removed. This is because we've introduced a Time Zone XProperty type which is replacing the String type used before for storing the Time Zones. If you wish to put back your change you can define a custom displayer on the new Time Zone XProperty in ##XWiki.XWikiUsers## or ##XWiki.XWikiPreferences##.
	336	* In order to add support for Slovak and Brazilian Portuguese languages to the Solr search we had to modify the Solr schema and unfortunately we don't have support for automatic Solr search index migration at this point. If you want to support these languages you have to delete the 'solr' folder from the configured permanent directory of your XWiki instance. The Solr index will be recreated automatically and the entire wiki/farm (including the pages in the Slovak and Brazilian Portuguese language) will be re-indexed after a server restart.
	337
1.1	338	== API Breakages ==
	339
4.6	340	The following APIs were modified since XWiki 7.2:
1.1	341
4.8	342	* Add support for custom repositories in extensions: (((
1.1	343	{{code language="none"}}
4.8	344	org.xwiki.extension.Extension: Method 'public java.util.Collection getRepositories()' has been added to an interface
	345	org.xwiki.extension.ExtensionDependency: Method 'public java.util.Collection getRepositories()' has been added to an interface
1.1	346	{{/code}}
4.8	347	)))
	348	* New URL parameters: (((
	349	{{code language="none"}}
	350	org.xwiki.rest.resources.pages.PageResource: In method 'public org.xwiki.rest.model.jaxb.Page getPage(java.lang.String, java.lang.String, java.lang.String, java.lang.Boolean)' the number of arguments has changed
	351	{{/code}}
	352	)))

Wiki source code of Release Notes for XWiki 7.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