Last modified by Thomas Mortagne on 2023/10/13

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).
8
9 = New and Noteworthy (since XWiki 7.2) =
10
11 [[Full list of issues fixed and Dashboard for 7.3>>https://jira.xwiki.org/secure/Dashboard.jspa?selectPageId=13500]].
12
13 == Office Importer ==
14
15 The [[extensions:Extension.Office Importer Application]] has been redesigned visually and now supports importing into Nested Spaces:
16
17 {{image reference="OfficeImporter" width="50%"/}}
18
19 == Flamingo ==
20
21 The search bar on the top of the screen have been improved a bit.
22
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="search-closed.png"/}}
27 )))
28 * Open:(((
29 {{image reference="search.png"/}}
30 )))
31
32 == Flamingo Theme Editor ==
33
34 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!
35
36 {{image reference="LESSCode.png" width="40%"/}}
37
38 == Miscellaneous ==
39
40 * 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.(((
41 {{image reference="extensionDiff.png" width="200"/}}
42 )))
43 * Added the Actions column for the [[FAQ Application>>extensions:Extension.FAQ Application]]:(((
44 {{image reference="faqActions.png"/}}
45 )))
46 * In the Drawer (top right menu), the pages for which the user doesn't have permissions to access are not displayed anymore.
47 * The user's avatar is now displayed between the search icon and the drawer icon:(((
48 {{image reference="avatar.png"/}}
49 )))
50 * 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.
51 * 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"]].
52 * The template providers edition has been rewritten to be more consistent with other edit forms:(((
53 {{image reference="template-provider-edit.png" width="50%"/}}
54 )))
55 * Removed the 'Edit' button when editing a template provider document. See [[XWIKI-12675>>https://jira.xwiki.org/browse/XWIKI-12675]]
56 * The [[Invitation Application>>extensions:Extension.Invitation Application]] now has an entry point in the App Bar (only visible to Admins).
57
58 See the [[full list of JIRA issues>>https://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+%227.3-milestone-1%22&tempMax=1000]] fixed in this release.
59
60 = For Developers =
61
62 == Extension Manager improvements ==
63
64 === Custom repositories ===
65
66 Extensions and dependencies can now provide custom repositories. For now only dependencies repositories are directly used when resolving it before trying registered repositories.
67
68 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.
69
70 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.
71
72 === Resolve dependencies in extension repository first ===
73
74 The extension repository is checked first when searching for extension dependencies.
75
76 == REST API improvements ==
77
78 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:
79
80 * ##objects##: enable returning document objects
81 * ##class##: enable returning document class properties
82 * ##attachments##: enable returning document attachments
83
84 They are all disabled by default.
85
86 Page objects support has also been added to the Page PUT API.
87
88 See [[The XWiki RESTful API>>Documentation.UserGuide.Features.XWikiRESTfulAPI]] for more details.
89
90 == Flamingo Improvements ==
91
92 The Drawer menu is now implemented with [[UI extensions>>extensions:Extension.UIExtension Module]]. The new Extension Points are:
93
94 |= [[##org.xwiki.plaftorm.drawer##>>Documentation.DevGuide.ExtensionPoint.DrawerItem]]|=[[##org.xwiki.plaftorm.drawer.header##>>Documentation.DevGuide.ExtensionPoint.DrawerHeaderItem]]
95 |(((
96 {{image reference="drawer-with-languages.png" width="20%"/}}
97 )))|(((
98 {{image reference="drawer-header.png" width="20%"/}}
99 )))
100
101 == Miscellaneous ==
102
103 * New ##getReference()## API public scripting Element (Object, Class, etc.) to get the EntityReference of the element
104 * 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##.
105 * For testing purpose, an environment variable ##XWIKI_OFFICE_HOME## can bet set to configure where the Office server is installed on the system.
106 * New [[Time Zone XProperty type>>Documentation.DevGuide.DataModel]] to represent Time Zones.
107 * The [[XAR plugin>>dev:Community.XARPlugin]] now verifies that Technical Pages are set as hidden and the Format Mojo sets them as hidden.
108 * 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.
109 * Issue management information are now imported, displayed and exposed in the REST service in the Extensions Repository
110
111 == Deprecated and Retired projects ==
112
113 * 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>>Documentation.UserGuide.Features.XWikiRESTfulAPI]] and it wasn't actively supported.
114
115 == Upgrades ==
116
117 The following dependencies have been upgraded:
118
119 * [[JSqlParser 0.9.4>>https://jira.xwiki.org/browse/XWIKI-12603]]
120 * [[Jackson 2.6.2>>https://jira.xwiki.org/browse/XCOMMONS-848]]
121 * [[httpclient 4.5.1>>https://jira.xwiki.org/browse/XCOMMONS-850]]
122 * [[Groovy 2.4.5>>https://jira.xwiki.org/browse/XCOMMONS-852]]
123 * [[Restlet 2.3.5 and JAX-RS 2>>https://jira.xwiki.org/browse/XCOMMONS-341]]
124 * [[Lucene and Solr 5.3.1>>https://jira.xwiki.org/browse/XWIKI-12131]]
125 * [[LessJs 2.5.3>>https://jira.xwiki.org/browse/XWIKI-12655]]
126 * [[Jetty 9.2.13.v20150730>>https://jira.xwiki.org/browse/XWIKI-12677]]. Note that this dependency is used only in the Jetty distribution.
127
128 = Translations =
129
130 The following translations have been updated:
131
132 {{language codes="da, sk, fr, hu, pt_BR"/}}
133
134
135 = Tested Browsers & Databases =
136
137 {{include reference="TestReports.ManualTestReportSummaryXWiki73M1"/}}
138
139
140 {{comment}}
141 = Performances tests compared to <last super stable version> =
142
143 <a summary of the comparison with latest super stable version>
144
145 More details on <link to the test report>.
146 {{/comment}}
147
148 = Known issues =
149
150 * [[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]]
151
152 = Backward Compatibility and Migration Notes =
153
154 == General Notes ==
155
156 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.
157
158 == Issues specific to XWiki 7.3-milestone-1 ==
159
160 * 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##.
161 * 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.
162
163 == API Breakages ==
164
165 The following APIs were modified since 7.2:
166
167 * Add support for custom repositories in extensions: (((
168 {{code language="none"}}
169 org.xwiki.extension.Extension: Method 'public java.util.Collection getRepositories()' has been added to an interface
170 org.xwiki.extension.ExtensionDependency: Method 'public java.util.Collection getRepositories()' has been added to an interface
171 {{/code}}
172 )))
173 * New URL parameters: (((
174 {{code language="none"}}
175 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
176 {{/code}}
177 )))

Get Connected