Version 39.1 by Vincent Massol on 2015/10/19

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 <insert description of release here>
8
9 = New and Noteworthy (since XWiki <version - 1>) =
10
11 [[Full list of issues fixed and Dashboard for <version>>>http://jira.xwiki.org/secure/Dashboard.jspa?selectPageId=<fill id here>]].
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 == Miscellaneous ==
71
72 * 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).
73
74 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.
75
76 = For Developers =
77
78 == Flamingo ==
79
80 The content menus are now implemented with [[UI extensions>>extensions:Extension.UIExtension Module]]. The new Extension Points are:
81
82 |= [[##org.xwiki.plaftorm.editactions##>>platform:ExtensionPoint.Edit Actions]]|=[[##org.xwiki.plaftorm.adminactions##>>platform:ExtensionPoint.Admin Actions]]|=[[##org.xwiki.plaftorm.moreoptions##>>platform:ExtensionPoint.More Options]]
83 |(((
84 {{image reference="editactions.png" width="50%"/}}
85 )))|(((
86 {{image reference="adminactions.png" width="50%"/}}
87 )))|(((
88 {{image reference="moreoptions.png" width="50%"/}}
89 )))
90
91 The extension point [[platform:ExtensionPoint.DrawerItem]] has now a parameter ##separator## to add a line separator before the drawer item.
92
93 == Extensions repository improvements ==
94
95 New extension are now create in their own space by default (as the space how page). It will make easier to organize documentation of big extensions.
96
97 == Deprecated and Retired projects ==
98
99 <description of deprecated and retired projects>
100
101 == Upgrades ==
102
103 The following dependencies have been upgraded:
104
105 * [[Jackson 2.6.3>>http://jira.xwiki.org/browse/XCOMMONS-861]]
106 * [[LiveValidation 1.4>>http://jira.xwiki.org/browse/XWIKI-12712]]
107
108 == Miscellaneous ==
109
110 * 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.
111 * custom extension repositories are now sent by the Extension Repository REST service
112
113 = Translations =
114
115 The following translations have been updated:
116
117 {{language codes="none, none"/}}
118
119 = Tested Browsers & Databases =
120
121 {{warning}}
122 The QA Tests are executed after the release has been done. Thus, they are being prepared now and will be published soon.
123 {{/warning}}
124
125 {{comment}}
126 TODO: uncomment and update with proper link when the report is ready.
127 {{include reference="TestReports.ManualTestReportTemplateSummary"/}}
128 {{/comment}}
129
130 = Performances tests compared to <last super stable version> =
131
132 <a summary of the comparison with latest super stable version>
133
134 More details on <link to the test report>.
135
136 = Known issues =
137
138 * [[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]]
139
140 = Backward Compatibility and Migration Notes =
141
142 == General Notes ==
143
144 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.
145
146 == Issues specific to XWiki <version> ==
147
148 <issues specific to the project>
149
150 == API Breakages ==
151
152 The following APIs were modified since <project> <version - 1>:
153
154 {{code language="none"}}
155 <clirr output here>
156 {{/code}}

Get Connected