Version 64.1 by Marius Dumitru Florea on 2015/10/29

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 This is the first of the 2 stabilization releases that happen at the end of each yearly Cycles. Lots of polishing has been done, especially for the recently introduced Nested Pages feature and its consequences on the UI redesign (modified menus for example). Some extensions started exploit nested spaces to bring some improvements.
8
9 = New and Noteworthy (since XWiki 7.3 Milestone 1) =
10
11 [[Full list of issues fixed and Dashboard for 7.3>>http://jira.xwiki.org/secure/Dashboard.jspa?selectPageId=13500]].
12
13 == Flamingo ==
14
15 The "More Options" menu has been split and a new "Page Administration" menu has been introduced:
16
17 {{gallery}}
18 image:content_menus.png
19 image:page-admin-menus.png
20 image:more-options-menu.png
21 {{/gallery}}
22
23 == Breadcrumb ==
24
25 When the hierarchy of a Nested Pages is long, we do not display it entirely anymore. Instead, we display a limited version, that the user can expand by clicking on the "ellipsis" character ('...'):
26
27 * limited:(((
28 {{image reference="breadcrumb-limited.png"/}}
29 )))
30 * full:(((
31 {{image reference="breadcrumb-full.png"/}}
32 )))
33
34 Note that this behavior have also been added to all hierarchy breadcrumbs, including location of search results, etc...
35
36 (((
37 {{image reference="breadcrumb-search-results.png"/}}
38 )))
39
40 == Page Index ==
41
42 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 column (which is still called Page) but which now displays the title of pages, as can be seen on the following screenshot:
43
44 {{image reference="livetable-location.png" width="50%"/}}
45
46 The same strategy is implemented for the ##children## and the ##siblings## viewers.
47
48 Note that you can filter at several path levels in the Location column. For example:
49
50 {{image reference="location-filter.png" width="50%"/}}
51
52 {{info}}
53 XWiki currently doesn't support filtering on Page titles which is why the new Page column doesn't allow filtering. However since the Location column includes the full path, users can still search on Page names.
54
55 At a technical level the displaying of page titles was needed because all non-terminal Page names are called ##WebHome## and displaying that would not be user-friendly.
56 {{/info}}
57
58 == New Panels ==
59
60 * A [[Children Panel>>extensions:Extension.Panels Application||anchor="HChildrenPanel"]] has been added to display the list of Children pages of the current Page.(((
61 {{image reference="children.png"/}}
62 )))
63 * A [[Siblings Panel>>extensions:Extension.Panels Application||anchor="HSiblingsPanel"]] has been added to display the list of Sibling pages of the current Page.(((
64 {{image reference="siblings.png"/}}
65 )))
66 * 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:(((
67 {{image reference="spacedocs-warning.png"/}}
68 )))
69
70 == App Within Minutes ==
71
72 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".
73
74 {{image reference="appLocationPicker.png" width="600"/}}
75
76 == Template Providers Administration ==
77
78 The template provider UI has been adapted to Nested Pages and it now supports:
79
80 * Creating template providers deeper than the first level (as it was restricted before), reusing the location picker widget
81 * Setting allowed locations (i.e. spaces) using the tree widget
82
83 {{gallery}}
84 image:TemplateProviderCreationUI-NestedPages.png
85
86 image:TemplateProviderEditUI-NestedPages.png
87
88 image:TemplateProviderViewUI-NestedPages.png
89 {{/gallery}}
90
91 For more details, see the [[XWIKI-12275>>http://jira.xwiki.org/browse/XWIKI-12275]] issue and the [[documentation>>extensions:Extension.Administration Application||anchor="HTemplates"]].
92
93 == XClass Application ==
94
95 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.
96
97 {{gallery}}
98 image:classSheet.png
99 image:dataTypes.png
100 {{/gallery}}
101
102 == Miscellaneous ==
103
104 * 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).
105 * [[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.
106 * The XWiki Syntax help now no longer shows help for syntaxes that are not available in the wiki.
107
108 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%29+and+status+%3D+Closed+and+resolution+%3D+Fixed+and+fixVersion+%3D+%22<version>%22&tempMax=1000]] fixed in this release.
109
110 = For Developers =
111
112 == Flamingo ==
113
114 The content menus are now implemented with [[UI extensions>>extensions:Extension.UIExtension Module]]. The new Extension Points are:
115
116 |= [[##org.xwiki.plaftorm.editactions##>>platform:ExtensionPoint.Edit Actions]]|=[[##org.xwiki.plaftorm.adminactions##>>platform:ExtensionPoint.Admin Actions]]|=[[##org.xwiki.plaftorm.moreoptions##>>platform:ExtensionPoint.More Options]]
117 |(((
118 {{image reference="editactions.png" width="50%"/}}
119 )))|(((
120 {{image reference="adminactions.png" width="50%"/}}
121 )))|(((
122 {{image reference="moreoptions.png" width="50%"/}}
123 )))
124
125 The extension point [[platform:ExtensionPoint.DrawerItem]] has now a parameter ##separator## to add a line separator before the drawer item.
126
127 == Extensions repository improvements ==
128
129 * New extensions are now create in their own space by default (as the space home page). It will make easier to organize documentation of big extensions.
130 * Custom extension repositories are now sent by the Extension Repository REST service
131
132 == Upgrades ==
133
134 The following dependencies have been upgraded:
135
136 * [[Jackson 2.6.3>>http://jira.xwiki.org/browse/XCOMMONS-861]]
137 * [[LiveValidation 1.4>>http://jira.xwiki.org/browse/XWIKI-12712]]
138
139 == Miscellaneous ==
140
141 * 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.
142 * 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.
143
144 = Tested Browsers & Databases =
145
146 {{warning}}
147 The QA Tests are executed after the release has been done. Thus, they are being prepared now and will be published soon.
148 {{/warning}}
149
150 {{comment}}
151 TODO: uncomment and update with proper link when the report is ready.
152 {{include reference="TestReports.ManualTestReportTemplateSummary"/}}
153 {{/comment}}
154
155 = Known issues =
156
157 * [[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]]
158
159 = Backward Compatibility and Migration Notes =
160
161 == General Notes ==
162
163 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.
164
165 == API Breakages ==
166
167 The following APIs were modified since 7.2:
168
169 * Add support for custom repositories in extensions:(((
170 {{code language="none"}}
171 org.xwiki.extension.Extension: Method 'public java.util.Collection getRepositories()' has been added to an interface
172 org.xwiki.extension.ExtensionDependency: Method 'public java.util.Collection getRepositories()' has been added to an interface
173 {{/code}}
174 )))
175 * New URL parameters:(((
176 {{code language="none"}}
177 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
178 {{/code}}
179 )))

Get Connected