Version 11.1 by Simon Urli on 2025/05/19

Show last authors
1 {{velocity}}
2 #if ($doc.getValue('released') != 1)
3 {{warning}}This version has not yet been released.{{/warning}}
4 #end
5 {{/velocity}}
6
7 {{velocity}}
8 #set ($rnObject = $doc.getObject('ReleaseNotes.Code.ReleaseNoteClass'))
9 #set ($product = $rnObject.product)
10 #set ($version = $rnObject.version)
11 #set ($versionPrefix = $stringtool.substringBefore($version, '-'))
12 #set ($versionParts = $stringtool.split($versionPrefix, '.'))
13 #set ($isRC = $version.contains('rc'))
14 #set ($isFinal = !$isRC)
15 #set ($isFirstFinal = $isFinal && ($versionParts.size() == 2 || $versionParts[2] == 0))
16 #set ($isBugFix = $isFinal && $versionParts.size() == 3 && $versionParts[2] > 0)
17 {{/velocity}}
18
19 {{box cssClass="floatinginfobox" title="**Contents**"}}
20 {{toc/}}
21 {{/box}}
22
23 This is the release notes for [[XWiki Commons>>http://commons.xwiki.org]], [[XWiki Rendering>>http://rendering.xwiki.org]] and [[XWiki Platform>>http://platform.xwiki.org]]. They share the same release notes as they are released together and have the same version.
24
25 This release contains security fixes, with the [[highest severity being 9.3>>doc:dev:Community.SecurityPolicy.WebHome||anchor="HSeverity"]].
26
27 {{velocity}}
28 {{jiraBlockersFor version="$version" id="xwikiorg"/}}
29 {{/velocity}}
30
31 = New and Noteworthy (since {{velocity}}$product{{/velocity}} 17.3.0) =
32
33 [[Full list of issues fixed and Dashboard for 17.4.0>>https://jira.xwiki.org/secure/Dashboard.jspa?selectPageId=16099]].
34
35 {{velocity}}
36 #if ($isBugFix)
37 {{jira style="list" url="https://jira.xwiki.org" fields="type, status, key, summary" source="jql"}}
38 resolution in (Fixed, "Solved By") AND component != "Development Issues only" and component != "Development Issues only - Test" AND project in (XCOMMONS, XRENDERING, XWIKI) AND fixVersion in ($version)
39 {{/jira}}
40 #else
41 {{releasenotechanges/}}
42 #end
43 {{/velocity}}
44
45 === Upgrades ===
46
47 The following runtime dependencies have been upgraded (they have a different release cycle than [[XWiki Commons>>http://commons.xwiki.org]], [[XWiki Rendering>>http://rendering.xwiki.org]] and [[XWiki Platform>>http://platform.xwiki.org]]):
48
49 {{velocity}}
50 #if ($isFirstFinal)
51 #set ($affectedVersions = "${version}-rc-1, ${version}")
52 #else
53 #set ($affectedVersions = "${version}")
54 #end
55 {{jira url="https://jira.xwiki.org" source="jql" style="list"}}
56 project in (XWIKI, XCOMMONS, XRENDERING) AND issuetype = Task AND fixVersion in ($affectedVersions) AND component = "Dependency Upgrades"
57 {{/jira}}
58 {{/velocity}}
59
60 = Translations =
61
62 The following translations have been updated:
63
64 {{language codes="de,fr,pl,zh"}}{{/language}}
65
66 {{comment}}
67 TODO: uncomment and update with proper link when the report is ready.
68
69 = Tested Browsers & Databases =
70
71 {{include reference="TestReports.<test report page>"/}}
72 {{/comment}}
73
74 {{comment}}
75 TODO: uncomment and update with proper links when the report is ready.
76
77 = Performances tests compared to <last super stable version> =
78
79 {{display reference="test:Performances.Jetty HSQLDB single wiki xxx to yyy" section="HSummary"/}}
80
81 More details on [[performance comparison on single wiki between x.x and y.y>>test:Performances.Jetty HSQLDB single wiki xxx to yyy]].
82 {{/comment}}
83
84 = Security Issues =
85
86 Security issues are not listed in issue lists or dashboards to avoid disclosing ways to use them, but they will appear automatically in them once they're disclosed. See the [[XWiki Security Policy>>dev:Community.SecurityPolicy.WebHome]] for more details.
87
88 = Known issues =
89
90 * [[Bugs we know about>>https://jira.xwiki.org/issues/?jql=category%20%3D%2010000%20AND%20issuetype%20%3D%20Bug%20AND%20resolution%20%3D%20Unresolved%20ORDER%20BY%20updated%20DESC]]
91
92 = Backward Compatibility and Migration Notes =
93
94 == General Notes ==
95
96 * When upgrading make sure you compare and merge the following XWiki configuration files since some parameters may have been modified, removed or added:
97 ** ##xwiki.cfg##
98 ** ##xwiki.properties##
99 ** ##web.xml##
100 ** ##hibernate.cfg.xml##
101 * Add ##xwiki.store.migration=1## in ##xwiki.cfg## so that XWiki will attempt to automatically migrate your current database to any new schema. Make sure you backup your Database before doing anything.
102
103 == Issues specific to {{velocity}}$product $version{{/velocity}} ==
104
105 === Live Data Vue Components registration ===
106
107 With the upgrade to Vue 3, the former mechanism to load additional components is not supported.
108 If you are using code such as the one presented below, please migrate your component to Vue 3 as well, and see the [[Live Data Component store>>||anchor="HLiveDatacomponentsstore"]] section to migrate.
109
110 {{code language="javascript"}}
111 Vue.component('DisplayerXXX', DisplayerXXXVue2Component);
112 {{/code}}
113
114 === New meta.vm template ===
115
116 When the ##XWiki.XWikiPreferences^XWiki.XWikiPreferences[0].meta## field is emptied if it matched the default value when upgrading to 17.4.0RC1.
117 You can consult this field from the UI by going to the [[//Presentation//>>extensions:Extension.Administration Application||anchor="HHTTPMetaInfo"]] section of the administration, under the //Look & Feel// category. Then check the //HTTP Meta Info// field.
118
119 * When the ##meta## field is empty, the new ##meta.vm## template file is used.
120 * After upgrading, it is advised to check if the ##meta## field is empty. If that's the case and no customization has been performed, you can check the history to verify if minor, irrelevant changes can be found. If that's the case, it is possible to empty the ##meta## field by yourself.
121
122 === XWiki now overwrite the standard application server request URL resolution ===
123
124 We had too many erratic/buggy behaviors with various application servers not properly following proxy headers, so we decider to not trust them anymore: XWiki now overwrite in a Servlet filter the behavior of ##ServletRequest#getScheme()##, ##ServletRequest#getServerName()##, ##ServletRequest#getServerPort()## and ##HttpServletRequest#getRequestURL()## so those should now have the same behavior to matter the application server used and its setup.
125
126 == API Breakages ==
127
128 No API breakage since {{velocity}}$product{{/velocity}} 17.3.0.
129
130 {{comment}}
131 {{velocity}}
132 {{backwardCompatibilityReport134 version="$version"/}}
133 {{/velocity}}
134 {{/comment}}
135
136 = Credits =
137
138 The following people have contributed code and translations to this release (sorted alphabetically):
139
140 * Alex Cotiugă
141 * Josue-T
142 * LucasC
143 * Manuel Leduc
144 * Marius Dumitru Florea
145 * Mend Renovate
146 * Michael Hamann
147 * Simon Urli
148 * Simpel
149 * Thomas Mortagne
150 * Tomek
151 * Vincent Massol
152 * XWiki
153 * Xiaofei Cui
154 * anonymous
155 * dependabot[bot]
156 * jan2xue
157 * tkrieck
158 * xrichard

Get Connected