Wiki source code of Release Notes for XWiki 10.8

Last modified by Thomas Mortagne on 2018/11/30

Hide last authors
Simon Urli 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
Adel Atallah 4.1 7 In this version we have added a new tab in the user profile that displays the groups a user is part of. We've added auto-suggest for pages in several places and improved the startup speed on Tomcat. We've also replaced our CAPTCHA implementation with a new one and it's now very easy to change and preview, from Administration, the CAPTCHA type that it will be used in your wiki. The Menu application is now directly accessible through the Administration.
Simon Urli 1.1 8
Marius Dumitru Florea 22.1 9 {{error}}
10 Some important bugs have been discovered since XWiki 10.8 has been released:
11
12 * [[The "WYSIWYG Editor" administration section is listed under the "Other" category rather than "Editing">>https://jira.xwiki.org/browse/XWIKI-15631]]
13 * [[HTML code displayed on the Users administration section of a subwiki>>https://jira.xwiki.org/browse/XWIKI-15650]]
Guillaume Delhumeau 24.1 14 * [[Notifications macro is broken if you use "pages", "spaces" or "wikis" parameters>>https://jira.xwiki.org/browse/XWIKI-15638]]
Guillaume Delhumeau 25.1 15 * [[Notifications loads forever if you open the notifications menu before the notifications count is displayed>>https://jira.xwiki.org/browse/XWIKI-15644]]
Vincent Massol 26.1 16 * [[PDF export removed accents from content>>http://jira.xwiki.org/browse/XCOMMONS-1503]]
Vincent Massol 27.1 17 * [[The attachment version, date and comment of XWikiDocument loaded from history is wrong>>https://jira.xwiki.org/browse/XWIKI-15669]]
18 * [[Global Left/Right menus are not displayed in subwikis>>https://jira.xwiki.org/browse/XWIKI-15601]]
19 * [[The attachment size of XWikiDocument loaded from history is 0>>https://jira.xwiki.org/browse/XWIKI-15064]]
Marius Dumitru Florea 22.1 20
Vincent Massol 27.2 21 You should wait for the next version of XWiki (10.8.1 or 10.9) that will be released soon!
Marius Dumitru Florea 22.1 22 {{/error}}
23
Adel Atallah 4.1 24 = New and Noteworthy (since XWiki 10.7) =
Simon Urli 1.1 25
Adel Atallah 5.1 26 [[Full list of issues fixed and Dashboard for 10.8>>https://jira.xwiki.org/secure/Dashboard.jspa?selectPageId=14322]].
Simon Urli 1.1 27
28 {{releasenotechanges/}}
29
30 === Moved Modules ===
31
Adel Atallah 4.1 32 * Retired the old [[Captcha Module>>extensions:Extension.Captcha Module]] and replaced by the new [[CAPTCHA Application>>extensions:Extension.CAPTCHA Application]]
Simon Urli 1.1 33
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
Vincent Massol 3.1 38 * [[CSS4J 0.41.3>>https://jira.xwiki.org/browse/XWIKI-15627]]
39 * [[Quartz Scheduler 2.3.0>>https://jira.xwiki.org/browse/XWIKI-15529]]
40 * [[JNR POSIX 3.0.46>>https://jira.xwiki.org/browse/XWIKI-15521]]
41 * [[JGroups 4.0.13>>https://jira.xwiki.org/browse/XWIKI-15519]]
42 * [[Apache PDFBox 2.0.11>>https://jira.xwiki.org/browse/XWIKI-15518]]
43 * [[JNA 4.5.2>>https://jira.xwiki.org/browse/XWIKI-15517]]
44 * [[JAXB implementation 2.3.0.1>>https://jira.xwiki.org/browse/XCOMMONS-1483]]
45 * [[Dom4j 2.1.1>>https://jira.xwiki.org/browse/XCOMMONS-1482]]
46 * [[Apache Xerces 2.12.0>>https://jira.xwiki.org/browse/XCOMMONS-1478]]
47 * [[ASM 6.2.1>>https://jira.xwiki.org/browse/XCOMMONS-1476]]
48 * [[Groovy 2.5.2>>https://jira.xwiki.org/browse/XCOMMONS-1474]]
49 * [[Bouncy Castle 1.60>>https://jira.xwiki.org/browse/XCOMMONS-1473]]
50 * [[httpcore 4.4.10>>https://jira.xwiki.org/browse/XCOMMONS-1471]]
51 * [[httpclient 4.5.6>>https://jira.xwiki.org/browse/XCOMMONS-1470]]
52 * [[httpasyncclient 4.1.4>>https://jira.xwiki.org/browse/XCOMMONS-1469]]
53 * [[commons-lang3 3.8>>https://jira.xwiki.org/browse/XCOMMONS-1467]]
54 * [[commons-dbcp2 2.5.0>>https://jira.xwiki.org/browse/XCOMMONS-1466]]
55 * [[Commons Configuration 2.3>>https://jira.xwiki.org/browse/XCOMMONS-1465]]
56 * [[commons-compress 1.18>>https://jira.xwiki.org/browse/XCOMMONS-1464]]
57 * [[commons-collections 4.2>>https://jira.xwiki.org/browse/XCOMMONS-1463]]
58 * [[cssparser 0.9.26>>https://jira.xwiki.org/browse/XCOMMONS-1462]]
59 * [[Guice 4.2.0>>https://jira.xwiki.org/browse/XCOMMONS-1364]]
60 * [[Maven 3.5.4>>https://jira.xwiki.org/browse/XCOMMONS-1298]]
Simon Urli 1.1 61
62 = Translations =
63
64 The following translations have been updated:
65
Adel Atallah 12.1 66 {{language codes="fr, de, lv, pl, zh"/}}
Simon Urli 1.1 67
68 = Tested Browsers & Databases =
69
Ilie Andriuta 28.1 70 {{include reference="TestReports.ManualTestReportSummaryXWiki108.WebHome"/}}
Simon Urli 1.1 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
Vincent Massol 23.2 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.
Simon Urli 1.1 86
Vincent Massol 10.1 87 == Issues specific to XWiki 10.8 ==
Guillaume Delhumeau 9.1 88
Vincent Massol 10.1 89 * A migration to the new store is necessary for existing filter preferences. It is done automatically when you first start XWiki after upgrading, but it may take time.(((
Guillaume Delhumeau 9.1 90 {{warning}}
Vincent Massol 10.1 91 If you had installed XWiki 10.8RC1, then we changed the new notifications filter table name, which was ##notification_filter_preferences## (in 10.8RC1) to ##notification_filter_prefs##. The previous name was too long for Oracle and was causing a [[bug>>https://jira.xwiki.org/browse/XWIKI-15623]]. Since it was not a final version, we have decided not to handle the migration.
Guillaume Delhumeau 9.1 92
Vincent Massol 10.1 93 However, if you really need to upgrade from XWiki 10.8RC1, you need to manually update the database **of each wiki**, and rename the table "##notification_filter_preferences##" to "##notification_filter_prefs##". With MySQL, the command would be:
Guillaume Delhumeau 9.1 94
95 {{code language="sql"}}RENAME TABLE notification_filter_preferences TO notification_filter_prefs;{{/code}}
96
Vincent Massol 10.1 97 Upgrades from prior versions are still supported and automated.
Guillaume Delhumeau 9.1 98 {{/warning}}
Vincent Massol 10.1 99 )))
Guillaume Delhumeau 23.1 100 * **If you are doing un upgrade, don't forget to update the following configuration file: ##hibernate.cfg.xml##**. In particular, the following line must be present:(((
101 {{code language="xml"}}
102 <mapping resource=“notification-filter-preferences.hbm.xml”/>
103 {{/code}}
104 )))
Vincent Massol 2.1 105 * XWiki has been configured to increase startup speed by avoiding JAR scanning, especially on Tomcat. The following was done, which you can modify if you need JAR scanning for some reason (not used by XWiki Standard by default):
106 ** Addition of ##metadata-complete="true"## and ##<absolute-ordering />## in XWiki's ##web.xml##
107 ** Addition of a ##META-INF/context.xml## Tomcat-specific deployment file in XWiki's WAR to prevent Tomcat from doing JAR scanning completely and to avoid scanning for JSP and WebSocket.
108 * Auto redirects are now off by default when moving/renaming pages. Rationale:(((
109 * Several users have reported a usability issue about automatic redirects. The way they express it is the following: "I have duplicates pages in my wiki. I don't understand why this is happening. I'm choosing to rename pages and not to copy them but I still get duplicates in the Navigation panel".
110 * Automatic redirects are especially useful for public wikis where users can have bookmark on pages and you don't want to break them. It can also be useful for internal wikis but it's less an issue.
111 * Even for public wikis not all pages need automatic redirects. Technical pages don't need them for example.
112 * We don't have management UIs for redirects FTM and reducing the number of redirects make the wiki easier
Simon Urli 1.1 113
Vincent Massol 2.1 114 In the future we'll offer a [[config option to define the default behavior>>http://jira.xwiki.org/browse/XWIKI-13384]].
115 )))
116
Simon Urli 1.1 117 == API Breakages ==
118
Adel Atallah 6.1 119 The following APIs were modified since XWiki 10.7:
Simon Urli 1.1 120
Adel Atallah 6.1 121 {{backwardCompatiblityReport version="10.8"/}}
Simon Urli 1.1 122
123 = Credits =
124
125 The following people have contributed code and translations to this release (sorted alphabetically):
126
Adel Atallah 12.2 127 Adel Atallah
128 Alex Cotiugă
129 Constantin Listar
130 Dominik Roszkowski
131 Ecaterina Moraru (Valica)
132 Eduard Moraru
133 Guillaume Delhumeau
134 Ilie Andriuta
135 Marius Dumitru Florea
136 Oana-Lavinia Florean
137 Roman Ivanov
138 Simon Urli
139 slauriere
140 Thomas Mortagne
141 Valdis Vitolins
142 Vincent Massol
143 xrichard
144 吴国凯

Get Connected