Wiki source code of Release Notes for XWiki 13.0
Last modified by Ilie Andriuta on 2021/01/28
Show last authors
| author | version | line-number | content |
|---|---|---|---|
| 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]] and [[XWiki Platform>>http://platform.xwiki.org]]. They share the same release notes as they are released together and have the same version. | ||
| 6 | |||
| 7 | This release introduces the new Live Data macro and starts using it in the Administration Logging section. Additionally, administration sections now get proper rights handling by inheriting from each of their authors. Under the hood, struts had finally been replaced by XWiki components, the "viewrev" action has been deprecated and changes have been made to the rights that a script has when executing. | ||
| 8 | |||
| 9 | = New and Noteworthy (since XWiki 12.10.3) = | ||
| 10 | |||
| 11 | [[Full list of issues fixed and Dashboard for 13.0>>https://jira.xwiki.org/secure/Dashboard.jspa?selectPageId=14646]]. | ||
| 12 | |||
| 13 | {{releasenotechanges/}} | ||
| 14 | |||
| 15 | === Upgrades === | ||
| 16 | |||
| 17 | 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]]): | ||
| 18 | |||
| 19 | * [[CSS4J 3.2.0>>https://jira.xwiki.org/browse/XWIKI-18176]] | ||
| 20 | * [[CKEditor Integration 1.52>>https://jira.xwiki.org/browse/XWIKI-18220]] | ||
| 21 | * [[Netty to 4.1.58>>https://jira.xwiki.org/browse/XWIKI-18155]] | ||
| 22 | * [[Antlr 4.9.1>>https://jira.xwiki.org/browse/XCOMMONS-2084]] | ||
| 23 | * [[Apache PDFBox 2.0.22>>https://jira.xwiki.org/browse/XWIKI-18175]] | ||
| 24 | * [[Apache Xerces 2.12.1>>https://jira.xwiki.org/browse/XCOMMONS-2114]] | ||
| 25 | * [[Bean Validation 2.0.2>>https://jira.xwiki.org/browse/XCOMMONS-1363]] | ||
| 26 | * [[Bouncy Castle 1.68>>https://jira.xwiki.org/browse/XCOMMONS-2110]] | ||
| 27 | * [[Byte Buddy 1.10.19>>https://jira.xwiki.org/browse/XCOMMONS-2105]] | ||
| 28 | * [[Caffeine 2.8.8>>https://jira.xwiki.org/browse/XCOMMONS-2096]] | ||
| 29 | * [[Checker Qual 3.9.1>>https://jira.xwiki.org/browse/XCOMMONS-2093]] | ||
| 30 | * [[Closure Compiler v20210106>>https://jira.xwiki.org/browse/XCOMMONS-2103]] | ||
| 31 | * [[Error Prone annotations 2.5.1>>https://jira.xwiki.org/browse/XCOMMONS-2115]] | ||
| 32 | * [[Groovy 2.5.14>>https://jira.xwiki.org/browse/XCOMMONS-2097]] | ||
| 33 | * [[Guava 30.1>>https://jira.xwiki.org/browse/XCOMMONS-2104]] | ||
| 34 | * [[HTTP Core 4.4.14>>https://jira.xwiki.org/browse/XCOMMONS-2088]] | ||
| 35 | * [[Hibernate 5.4.27>>https://jira.xwiki.org/browse/XWIKI-18120]] | ||
| 36 | * [[Hibernate Validator 6.2.0>>https://jira.xwiki.org/browse/XCOMMONS-1968]] | ||
| 37 | * [[Infinispan 11.0.8>>https://jira.xwiki.org/browse/XCOMMONS-2091]] | ||
| 38 | * [[JFFI 1.3.1>>https://jira.xwiki.org/browse/XWIKI-18134]] | ||
| 39 | * [[JNR Constants 0.10.1>>https://jira.xwiki.org/browse/XWIKI-18157]] | ||
| 40 | * [[JNR FFI 2.2.1>>https://jira.xwiki.org/browse/XWIKI-18135]] | ||
| 41 | * [[JNR POSIX 3.1.4>>https://jira.xwiki.org/browse/XWIKI-18136]] | ||
| 42 | * [[JSqlParser 4.0>>https://jira.xwiki.org/browse/XWIKI-18193]] | ||
| 43 | * [[Jackson 2.12.1>>https://jira.xwiki.org/browse/XCOMMONS-2087]] | ||
| 44 | * [[Joda-Time 2.10.9>>https://jira.xwiki.org/browse/XWIKI-18192]] | ||
| 45 | * [[MariaDB connector 2.7.1>>https://jira.xwiki.org/browse/XWIKI-18119]] | ||
| 46 | * [[Protobuf Java 3.14.0>>https://jira.xwiki.org/browse/XCOMMONS-2112]] | ||
| 47 | * [[Protostream 4.3.5>>https://jira.xwiki.org/browse/XCOMMONS-2111]] | ||
| 48 | * [[Tika 1.25>>https://jira.xwiki.org/browse/XWIKI-18158]] | ||
| 49 | * [[JAXB 2.3.3>>https://jira.xwiki.org/browse/XCOMMONS-2098]] | ||
| 50 | * [[XStream 1.4.15>>https://jira.xwiki.org/browse/XCOMMONS-2102]] | ||
| 51 | |||
| 52 | = Translations = | ||
| 53 | |||
| 54 | The following translations have been updated: | ||
| 55 | |||
| 56 | {{language codes="de, es, fr, ja, no, zh"/}} | ||
| 57 | |||
| 58 | = Tested Browsers & Databases = | ||
| 59 | |||
| 60 | {{include reference="TestReports.ManualTestReportSummaryXWiki130.WebHome"/}} | ||
| 61 | |||
| 62 | {{comment}} | ||
| 63 | TODO: uncomment and update with proper links when the report is ready. | ||
| 64 | |||
| 65 | = Performances tests compared to <last super stable version> = | ||
| 66 | |||
| 67 | {{display reference="test:Performances.Jetty HSQLDB single wiki xxx to yyy" section="HSummary"/}} | ||
| 68 | |||
| 69 | More details on [[performance comparison on single wiki between x.x and y.y>>test:Performances.Jetty HSQLDB single wiki xxx to yyy]]. | ||
| 70 | {{/comment}} | ||
| 71 | |||
| 72 | = Known issues = | ||
| 73 | |||
| 74 | * [[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]] | ||
| 75 | |||
| 76 | = Backward Compatibility and Migration Notes = | ||
| 77 | |||
| 78 | == General Notes == | ||
| 79 | |||
| 80 | * When upgrading make sure you compare and merge the following XWiki configuration files since some parameters may have been modified, removed or added: | ||
| 81 | ** ##xwiki.cfg## | ||
| 82 | ** ##xwiki.properties## | ||
| 83 | ** ##web.xml## | ||
| 84 | ** ##hibernate.cfg.xml## | ||
| 85 | * 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. | ||
| 86 | |||
| 87 | == Issues specific to XWiki 13.0 == | ||
| 88 | |||
| 89 | === No more Struts === | ||
| 90 | |||
| 91 | XWiki used to use the highly outdated Struts 1.3.10 as entry point to the (deprecated) actions system. In pratice Struts was not used for much (basically just mapping an action name with an action class) already and the very last bit has finally been removed but it's a breaking change for any custom action: | ||
| 92 | |||
| 93 | * actions are now XWiki components implementing the role ##com.xpn.xwiki.internal.web.LegacyAction## | ||
| 94 | * no more struts-config.xml, the component now indicate its own name to match in the URL and the only way to disable an action is to remove/uninstall it | ||
| 95 | |||
| 96 | That being said the old XWiki actions system has been deprecated for a long time now and the recommended way to make a custom action up to date is to convert it to an [[Entity Resource Reference handler>>extensions:Extension.Resource API||anchor="HAddinganewEntityResourceTypeHandler"]]. | ||
| 97 | |||
| 98 | === FileUploadPlugin#getFileItems order changed === | ||
| 99 | |||
| 100 | Another side effect of the removing of Struts 1.3 is that the order of the elements returned by ##FileUploadPlugin#getFileItems(XWikiContext)## which used to always be ordered (even if not documented as such) now depends on the multipart/form Servlet implementation (for example Tomcat used Apache FileUpload to parse the request which respect the order but Jetty does not). In any case it's recommended to use directly the HTTPServlet#getParts which is a standard instead of the old FileUploadPlugin. | ||
| 101 | |||
| 102 | === The viewrev action is deprecated === | ||
| 103 | |||
| 104 | The [[viewrev action>>Documentation.DevGuide.Architecture.URL Architecture.Standard URL Format||anchor="HAction:viewrev"]] is now deprecated and the [[view action>>Documentation.DevGuide.Architecture.URL Architecture.Standard URL Format||anchor="HAction:view"]] should be used instead with the same parameters. | ||
| 105 | |||
| 106 | === Author right is now important when saving === | ||
| 107 | |||
| 108 | An experimental new behavior of the document save script API is now the default: both the current user and author rights are checked when saving a document. Among other things it implies the follow two important changes for scripts authors who don't have programming right: | ||
| 109 | |||
| 110 | * the registered author of a document saved by the script will be the author instead of the current user | ||
| 111 | * if the script author does not have edit right on some document the API ##Document#save## call will fail for that document | ||
| 112 | |||
| 113 | While not recommended it's possible to go back to previous behavior by using ##security.script.save.checkAuthor=false## in ##xwiki.properties## configuration file. | ||
| 114 | |||
| 115 | == API Breakages == | ||
| 116 | |||
| 117 | The following APIs were modified since XWiki 12.10.3: | ||
| 118 | |||
| 119 | {{backwardCompatiblityReportXml version="13.0"/}} | ||
| 120 | |||
| 121 | = Credits = | ||
| 122 | |||
| 123 | The following people have contributed code and translations to this release (sorted alphabetically): | ||
| 124 | |||
| 125 | Christian Fröhlich | ||
| 126 | Clemens Robbenhaar | ||
| 127 | Clément Aubin | ||
| 128 | Clément Desableau | ||
| 129 | Eduard Moraru | ||
| 130 | Francisco García Moreno | ||
| 131 | iLocIT! | ||
| 132 | Jarle Sandmo | ||
| 133 | jingkaimori | ||
| 134 | Lars Pelzer | ||
| 135 | Mahendran Mookkiah | ||
| 136 | Marius Dumitru Florea | ||
| 137 | Roman Ivanov | ||
| 138 | Simon Urli | ||
| 139 | Thomas Mortagne | ||
| 140 | Vincent Massol | ||
| 141 | xrichard |
