Wiki source code of Release Notes for XWiki 10.8

Last modified by Thomas Mortagne on 2018/11/30

Show last authors
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 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.
8
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]]
14 * [[Notifications macro is broken if you use "pages", "spaces" or "wikis" parameters>>https://jira.xwiki.org/browse/XWIKI-15638]]
15 * [[Notifications loads forever if you open the notifications menu before the notifications count is displayed>>https://jira.xwiki.org/browse/XWIKI-15644]]
16 * [[PDF export removed accents from content>>http://jira.xwiki.org/browse/XCOMMONS-1503]]
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]]
20
21 You should wait for the next version of XWiki (10.8.1 or 10.9) that will be released soon!
22 {{/error}}
23
24 = New and Noteworthy (since XWiki 10.7) =
25
26 [[Full list of issues fixed and Dashboard for 10.8>>https://jira.xwiki.org/secure/Dashboard.jspa?selectPageId=14322]].
27
28 {{releasenotechanges/}}
29
30 === Moved Modules ===
31
32 * Retired the old [[Captcha Module>>extensions:Extension.Captcha Module]] and replaced by the new [[CAPTCHA Application>>extensions:Extension.CAPTCHA Application]]
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
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]]
61
62 = Translations =
63
64 The following translations have been updated:
65
66 {{language codes="fr, de, lv, pl, zh"/}}
67
68 = Tested Browsers & Databases =
69
70 {{include reference="TestReports.ManualTestReportSummaryXWiki108.WebHome"/}}
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 10.8 ==
88
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.(((
90 {{warning}}
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.
92
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:
94
95 {{code language="sql"}}RENAME TABLE notification_filter_preferences TO notification_filter_prefs;{{/code}}
96
97 Upgrades from prior versions are still supported and automated.
98 {{/warning}}
99 )))
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 )))
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
113
114 In the future we'll offer a [[config option to define the default behavior>>http://jira.xwiki.org/browse/XWIKI-13384]].
115 )))
116
117 == API Breakages ==
118
119 The following APIs were modified since XWiki 10.7:
120
121 {{backwardCompatiblityReport version="10.8"/}}
122
123 = Credits =
124
125 The following people have contributed code and translations to this release (sorted alphabetically):
126
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