Wiki source code of Release Notes for XWiki 12.6
Last modified by Thomas Mortagne on 2020/10/05
Hide last authors
| author | version | line-number | content |
|---|---|---|---|
 |
1.1 | 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 | |||
 |
15.1 | 7 | This release brings WYSIWYG editor integration with comments and annotations, allowing for easy insertion of mentions into comments and annotations. Talking about mentions, the mention summary is now included in the notification message. As for the notifications, they are now pre-filtered when the event occurs and stored (also) on a separate Solr core, which improves considerably the time spent to retrieve and display them. For developers we have a new "content footer" UI extension point that might be of interest. Besides that this release includes, as usual, a fair amount of bug fixes and other small improvements. |
| |
1.1 | 8 | |
| |
17.1 | 9 | {{error}} |
| 10 | Some important bugs have been discovered since XWiki 12.6 has been released: | ||
 |
18.1 | 11 | |
| |
17.1 | 12 | * [[Mention-related stackraces in the XWiki logs>>https://jira.xwiki.org/browse/XWIKI-17619]]. Specifially:((( |
| |
21.1 | 13 | XWiki 12.6.1+ and 12.7+ will include a fix for this issue. In the meantime, restarting the server fixes the issue and allows the mentions to work properly. |
| |
17.1 | 14 | ))) |
| |
21.1 | 15 | * [[Keyboard shortcuts are not working for advanced mode/hidden pages >>https://jira.xwiki.org/browse/XWIKI-17614]]. |
| 16 | The shortcuts are still working when the Default editor to use is set to //Text// in the user's preferences. The advanced mode and displaying of hidden page can also be configured from the user's preferences. | ||
| |
17.1 | 17 | |
| |
17.2 | 18 | If one or several of these bugs impact you, then you should use the next version once it has been released. |
| |
17.1 | 19 | {{/error}} |
| 20 | |||
| |
7.1 | 21 | = New and Noteworthy (since XWiki 12.5.1) = |
| |
1.1 | 22 | |
| |
9.1 | 23 | [[Full list of issues fixed and Dashboard for 12.6>>https://jira.xwiki.org/secure/Dashboard.jspa?selectPageId=14606]]. |
| |
1.1 | 24 | |
| 25 | {{releasenotechanges/}} | ||
| 26 | |||
| 27 | === Moved Modules === | ||
| 28 | |||
 |
4.1 | 29 | The old activity stream and the watchlist modules have been moved to the attic: |
| |
1.1 | 30 | |
| |
4.1 | 31 | * https://github.com/xwiki-attic/xwiki-platform-activitystream |
| 32 | * https://github.com/xwiki-attic/xwiki-platform-watchlist | ||
| 33 | |||
| |
1.1 | 34 | === Upgrades === |
| 35 | |||
| 36 | 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]]): | ||
| 37 | |||
| |
2.1 | 38 | * [[CSS4J 2.0.4>>https://jira.xwiki.org/browse/XWIKI-17542]] |
| 39 | * [[Rome 1.14.1>>https://jira.xwiki.org/browse/XWIKI-17485]] | ||
| 40 | * [[MySQL connector 8.0.21>>https://jira.xwiki.org/browse/XWIKI-17565]] | ||
| 41 | * [[Jackson 2.11.1>>https://jira.xwiki.org/browse/XCOMMONS-1976]] | ||
| 42 | * [[JSqlParser 3.2>>https://jira.xwiki.org/browse/XWIKI-17490]] | ||
| 43 | * [[JNR POSIX 3.0.58>>https://jira.xwiki.org/browse/XWIKI-17564]] | ||
| 44 | * [[JNR FFI 2.1.16>>https://jira.xwiki.org/browse/XWIKI-17566]] | ||
| 45 | * [[JNA 5.6.0>>https://jira.xwiki.org/browse/XWIKI-17567]] | ||
| 46 | * [[Hibernate 5.4.18>>https://jira.xwiki.org/browse/XWIKI-17489]] | ||
| 47 | * [[HSQLDB 2.5.1>>https://jira.xwiki.org/browse/XWIKI-17491]] | ||
| 48 | * [[Checker Qual 3.5.0>>https://jira.xwiki.org/browse/XCOMMONS-1971]] | ||
| 49 | * [[Caffeine 2.8.5>>https://jira.xwiki.org/browse/XCOMMONS-1977]] | ||
| 50 | * [[Byte Buddy 1.10.13>>https://jira.xwiki.org/browse/XCOMMONS-1973]] | ||
| 51 | * [[Bouncy Castle 1.66>>https://jira.xwiki.org/browse/XCOMMONS-1982]] | ||
| 52 | * [[Apache PDFBox 2.0.20>>https://jira.xwiki.org/browse/XWIKI-17487]] | ||
| 53 | * [[PostgresSQL connector 42.2.14>>https://jira.xwiki.org/browse/XWIKI-17486]] | ||
| |
11.1 | 54 | * [[CKEditor Integration 1.48>>https://jira.xwiki.org/browse/XWIKI-17475]] |
| 55 | * [[CKEditor 4.14.1>>https://jira.xwiki.org/browse/CKEDITOR-357]] | ||
| |
1.1 | 56 | |
| 57 | = Translations = | ||
| 58 | |||
| |
5.1 | 59 | The following translations have been updated: |
| |
1.1 | 60 | |
| |
5.1 | 61 | {{language codes="es,zh"/}} |
| |
1.1 | 62 | |
| 63 | = Tested Browsers & Databases = | ||
| 64 | |||
 |
22.1 | 65 | {{include reference="TestReports.ManualTestReportSummaryXWiki126.WebHome"/}} |
| |
1.1 | 66 | |
| 67 | {{comment}} | ||
| 68 | TODO: uncomment and update with proper links when the report is ready. | ||
| 69 | |||
| 70 | = Performances tests compared to <last super stable version> = | ||
| 71 | |||
| 72 | {{display reference="test:Performances.Jetty HSQLDB single wiki xxx to yyy" section="HSummary"/}} | ||
| 73 | |||
| 74 | More details on [[performance comparison on single wiki between x.x and y.y>>test:Performances.Jetty HSQLDB single wiki xxx to yyy]]. | ||
| 75 | {{/comment}} | ||
| 76 | |||
| 77 | = Known issues = | ||
| 78 | |||
| 79 | * [[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]] | ||
| 80 | |||
| 81 | = Backward Compatibility and Migration Notes = | ||
| 82 | |||
| 83 | == General Notes == | ||
| 84 | |||
| 85 | * When upgrading make sure you compare and merge the following XWiki configuration files since some parameters may have been modified, removed or added: | ||
| 86 | ** ##xwiki.cfg## | ||
| 87 | ** ##xwiki.properties## | ||
| 88 | ** ##web.xml## | ||
| 89 | ** ##hibernate.cfg.xml## | ||
| 90 | * 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. | ||
| 91 | |||
| |
3.1 | 92 | == Issues specific to XWiki 12.6 == |
| |
1.1 | 93 | |
| |
3.1 | 94 | === New event store and pre filtering by default === |
| |
1.1 | 95 | |
| |
3.1 | 96 | Even if it was implemented along the course of 12.x it's still the first time that this is enabled for most users so don't hesitate to report any notification related issue to [[https://jira.xwiki.org/projects/XWIKI]]. |
| 97 | |||
| 98 | If you hit a blocker bug you can go back to: | ||
| |
18.1 | 99 | |
| |
3.1 | 100 | * post filtering of event using the property ##notifications.eventPrefilteringEnabled## in ##xwiki.properties## |
| 101 | * use only the database store by disabling the new one using the property ##eventstream.store.enabled## in ##xwiki.properties## | ||
| 102 | |||
| |
20.1 | 103 | Right now old events are not automatically migrated so when you upgrade they will appear to have vanished. A tool to import them will be provided in 12.6.1. |
| |
3.1 | 104 | |
| |
23.1 | 105 | === DocumentReference and SpaceReference converters behavior change === |
| 106 | |||
| 107 | ##DocumentReference## and ##SpaceReference## now always serialize absolute references instead of references relative to the current context (including absolute reference when executed from a different wiki). Since the converters are meant to produce values that can be unserialized they can't loose any information. | ||
| 108 | |||
| 109 | The main use case where those converters are used is when a Velocity script calls a method taking a ##String## as parameter and pass a ##DocumentReference## or a ##SpaceReference##. It should not have much impact in practice since an API which takes a document reference in parameter is supposed to support all forms of reference (especially since this converter was producing various forms of references). | ||
| 110 | |||
| |
1.1 | 111 | == API Breakages == |
| 112 | |||
| |
7.1 | 113 | The following APIs were modified since XWiki 12.5.1: |
| |
1.1 | 114 | |
| |
10.1 | 115 | {{backwardCompatiblityReportXml version="12.6"/}} |
| |
1.1 | 116 | |
| 117 | = Credits = | ||
| 118 | |||
| 119 | The following people have contributed code and translations to this release (sorted alphabetically): | ||
| 120 | |||
| |
6.1 | 121 | * Clément Aubin |
| 122 | * DenisF | ||
| 123 | * Eduard Moraru | ||
| 124 | * Francisco García Moreno | ||
| 125 | * Guillaume Delhumeau | ||
| 126 | * Manuel Leduc | ||
| 127 | * Marius Dumitru Florea | ||
| 128 | * mfkvfn | ||
| 129 | * Simon Urli | ||
| 130 | * Thomas Mortagne | ||
| 131 | * Vincent Massol | ||
| 132 | * xrichard |
