Wiki source code of Release Notes for XWiki 17.4.0
Last modified by Ilie Andriuta on 2025/05/29
Hide last authors
| author | version | line-number | content |
|---|---|---|---|
 |
1.1 | 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 | |||
| |
10.1 | 25 | This release introduces the capability for users to toggle the panel columns to improve usability and navigation, and for admins to define the required rights of pages for better security. On top of that, a few macros have been improved for developers and Live Data now runs with Vue 3. This release also contains security fixes, with the [[highest severity being 9.3>>doc:dev:Community.SecurityPolicy.WebHome||anchor="HSeverity"]]. |
| |
1.1 | 26 | |
| 27 | {{velocity}} | ||
| 28 | {{jiraBlockersFor version="$version" id="xwikiorg"/}} | ||
| 29 | {{/velocity}} | ||
| 30 | |||
| |
3.1 | 31 | = New and Noteworthy (since {{velocity}}$product{{/velocity}} 17.3.0) = |
| |
1.1 | 32 | |
| |
3.1 | 33 | [[Full list of issues fixed and Dashboard for 17.4.>>https://jira.xwiki.org/secure/Dashboard.jspa?selectPageId=16099]]. |
| |
1.1 | 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 | |||
| |
6.1 | 62 | The following translations have been updated: |
| |
1.1 | 63 | |
| |
7.1 | 64 | {{language codes="de,fr,pl,zh"/}} |
| |
1.1 | 65 | |
| 66 | = Tested Browsers & Databases = | ||
| 67 | |||
 |
12.1 | 68 | == Automated testing == |
| |
1.1 | 69 | |
| |
12.1 | 70 | XWiki executes a lot of [[automated tests during its build>>dev:Community.Testing.WebHome||anchor="HTestingStrategy"]], testing all [[supported configurations>>dev:Community.SupportStrategy.WebHome]]. In addition, some manual QA is also executed to try to discover additional problems (see below): |
| 71 | |||
| 72 | {{include reference="TestReports.ManualTestReportSummaryXWiki1740.WebHome"/}} | ||
| 73 | |||
| |
1.1 | 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 | |||
| |
4.1 | 105 | === Live Data Vue Components registration === |
| |
1.1 | 106 | |
| |
4.1 | 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 | === Removed Mail Plugin === | ||
| 115 | |||
| 116 | The Mail Plugin was a non-finished feature that was supposed to be used to be able to send mail to XWiki to bring modifications to wiki pages. It's now been removed and you'll need to remove its entry in ##xwiki.cfg## to avoid the following log error in the XWiki logs: | ||
| 117 | |||
| 118 | {{code language="none"}} | ||
| 119 | 2025-05-20 17:16:15,170 [XWiki initialization] ERROR c.x.x.p.XWikiPluginManager - Cannot initialize plugin [com.xpn.xwiki.plugin.mail.MailPlugin]. This plugin will not be available. | ||
| 120 | java.lang.ClassNotFoundException: com.xpn.xwiki.plugin.mail.MailPlugin | ||
| 121 | at java.base/java.net.URLClassLoader.findClass(URLClassLoader.java:440) | ||
| 122 | at java.base/java.lang.ClassLoader.loadClass(ClassLoader.java:587) | ||
| 123 | at java.base/java.lang.ClassLoader.loadClass(ClassLoader.java:520) | ||
| 124 | at org.xwiki.classloader.xwiki.internal.ContextNamespaceURLClassLoader.loadClass(ContextNamespaceURLClassLoader.java:176) | ||
| 125 | at java.base/java.lang.Class.forName0(Native Method) | ||
| 126 | at java.base/java.lang.Class.forName(Class.java:467) | ||
| 127 | at com.xpn.xwiki.plugin.XWikiPluginManager.addPlugin(XWikiPluginManager.java:83) | ||
| 128 | at com.xpn.xwiki.plugin.XWikiPluginManager.addPlugins(XWikiPluginManager.java:118) | ||
| 129 | at com.xpn.xwiki.XWiki.preparePlugins(XWiki.java:1654) | ||
| 130 | at com.xpn.xwiki.XWiki.initXWiki(XWiki.java:1371) | ||
| 131 | at com.xpn.xwiki.XWiki.initXWiki(XWiki.java:1293) | ||
| 132 | at com.xpn.xwiki.XWiki.<init>(XWiki.java:1266) | ||
| 133 | at com.xpn.xwiki.internal.XWikiInitializerJob.runInternal(XWikiInitializerJob.java:103) | ||
| 134 | at org.xwiki.job.AbstractJob.runInContext(AbstractJob.java:246) | ||
| 135 | at org.xwiki.job.AbstractJob.run(AbstractJob.java:223) | ||
| 136 | at java.base/java.lang.Thread.run(Thread.java:833) | ||
| 137 | {{/code}} | ||
| 138 | |||
| 139 | The change to bring to ##xwiki.cfg## is the following: | ||
| 140 | |||
| 141 | {{code language="none"}} | ||
| 142 | [...] | ||
| 143 | #-# List of active plugins. | ||
| 144 | xwiki.plugins=\ | ||
| 145 | com.xpn.xwiki.monitor.api.MonitorPlugin,\ | ||
| 146 | com.xpn.xwiki.plugin.skinx.JsSkinExtensionPlugin,\ | ||
| 147 | com.xpn.xwiki.plugin.skinx.JsSkinFileExtensionPlugin,\ | ||
| 148 | com.xpn.xwiki.plugin.skinx.JsResourceSkinExtensionPlugin,\ | ||
| 149 | com.xpn.xwiki.plugin.skinx.CssSkinExtensionPlugin,\ | ||
| 150 | com.xpn.xwiki.plugin.skinx.CssSkinFileExtensionPlugin,\ | ||
| 151 | com.xpn.xwiki.plugin.skinx.CssResourceSkinExtensionPlugin,\ | ||
| 152 | com.xpn.xwiki.plugin.skinx.LinkExtensionPlugin,\ | ||
| 153 | com.xpn.xwiki.plugin.feed.FeedPlugin,\ | ||
| 154 | com.xpn.xwiki.plugin.mail.MailPlugin,\ <---- Remove this line | ||
| 155 | com.xpn.xwiki.plugin.packaging.PackagePlugin,\ | ||
| 156 | [...] | ||
| 157 | {{/code}} | ||
| 158 | |||
| 159 | === New meta.vm template === | ||
| 160 | |||
| 161 | When the ##XWiki.XWikiPreferences^XWiki.XWikiPreferences[0].meta## field is emptied if it matched the default value when upgrading to 17.4.0RC1. | ||
| 162 | 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. | ||
| 163 | |||
| 164 | * When the ##meta## field is empty, the new ##meta.vm## template file is used. | ||
| 165 | * 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. | ||
| 166 | |||
| 167 | === XWiki now overwrites the standard application server request URL resolution === | ||
| 168 | |||
| 169 | 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. | ||
| 170 | |||
| |
1.1 | 171 | == API Breakages == |
| 172 | |||
| |
5.1 | 173 | The following APIs were modified since {{velocity}}$product{{/velocity}} 17.3.0: |
| |
1.1 | 174 | |
| 175 | {{velocity}} | ||
| 176 | {{backwardCompatibilityReport134 version="$version"/}} | ||
| 177 | {{/velocity}} | ||
| 178 | |||
| 179 | = Credits = | ||
| 180 | |||
| 181 | The following people have contributed code and translations to this release (sorted alphabetically): | ||
| 182 | |||
| |
8.1 | 183 | * Alex Cotiugă |
| 184 | * Josue-T | ||
| 185 | * LucasC | ||
| 186 | * Manuel Leduc | ||
| 187 | * Marius Dumitru Florea | ||
| 188 | * Michael Hamann | ||
| 189 | * Simon Urli | ||
| 190 | * Simpel | ||
| 191 | * Thomas Mortagne | ||
| 192 | * Tomek | ||
| 193 | * Vincent Massol | ||
| 194 | * Xiaofei Cui | ||
| 195 | * jan2xue | ||
| 196 | * tkrieck | ||
| 197 | * xrichard | ||
| 198 |
