Wiki source code of Release Notes for XWiki 10.8

Version 25.1 by Guillaume Delhumeau on 2018/10/01

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
17 You should wait for the next version of XWiki that will be released soon!
18 {{/error}}
19
20 = New and Noteworthy (since XWiki 10.7) =
21
22 [[Full list of issues fixed and Dashboard for 10.8>>https://jira.xwiki.org/secure/Dashboard.jspa?selectPageId=14322]].
23
24 {{releasenotechanges/}}
25
26 === Moved Modules ===
27
28 * Retired the old [[Captcha Module>>extensions:Extension.Captcha Module]] and replaced by the new [[CAPTCHA Application>>extensions:Extension.CAPTCHA Application]]
29
30 === Upgrades ===
31
32 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]]):
33
34 * [[CSS4J 0.41.3>>https://jira.xwiki.org/browse/XWIKI-15627]]
35 * [[Quartz Scheduler 2.3.0>>https://jira.xwiki.org/browse/XWIKI-15529]]
36 * [[JNR POSIX 3.0.46>>https://jira.xwiki.org/browse/XWIKI-15521]]
37 * [[JGroups 4.0.13>>https://jira.xwiki.org/browse/XWIKI-15519]]
38 * [[Apache PDFBox 2.0.11>>https://jira.xwiki.org/browse/XWIKI-15518]]
39 * [[JNA 4.5.2>>https://jira.xwiki.org/browse/XWIKI-15517]]
40 * [[JAXB implementation 2.3.0.1>>https://jira.xwiki.org/browse/XCOMMONS-1483]]
41 * [[Dom4j 2.1.1>>https://jira.xwiki.org/browse/XCOMMONS-1482]]
42 * [[Apache Xerces 2.12.0>>https://jira.xwiki.org/browse/XCOMMONS-1478]]
43 * [[ASM 6.2.1>>https://jira.xwiki.org/browse/XCOMMONS-1476]]
44 * [[Groovy 2.5.2>>https://jira.xwiki.org/browse/XCOMMONS-1474]]
45 * [[Bouncy Castle 1.60>>https://jira.xwiki.org/browse/XCOMMONS-1473]]
46 * [[httpcore 4.4.10>>https://jira.xwiki.org/browse/XCOMMONS-1471]]
47 * [[httpclient 4.5.6>>https://jira.xwiki.org/browse/XCOMMONS-1470]]
48 * [[httpasyncclient 4.1.4>>https://jira.xwiki.org/browse/XCOMMONS-1469]]
49 * [[commons-lang3 3.8>>https://jira.xwiki.org/browse/XCOMMONS-1467]]
50 * [[commons-dbcp2 2.5.0>>https://jira.xwiki.org/browse/XCOMMONS-1466]]
51 * [[Commons Configuration 2.3>>https://jira.xwiki.org/browse/XCOMMONS-1465]]
52 * [[commons-compress 1.18>>https://jira.xwiki.org/browse/XCOMMONS-1464]]
53 * [[commons-collections 4.2>>https://jira.xwiki.org/browse/XCOMMONS-1463]]
54 * [[cssparser 0.9.26>>https://jira.xwiki.org/browse/XCOMMONS-1462]]
55 * [[Guice 4.2.0>>https://jira.xwiki.org/browse/XCOMMONS-1364]]
56 * [[Maven 3.5.4>>https://jira.xwiki.org/browse/XCOMMONS-1298]]
57
58 = Translations =
59
60 The following translations have been updated:
61
62 {{language codes="fr, de, lv, pl, zh"/}}
63
64 {{comment}}
65 TODO: uncomment and update with proper link when the report is ready.
66
67 = Tested Browsers & Databases =
68
69 {{include reference="TestReports.<test report page>"/}}
70 {{/comment}}
71
72 {{comment}}
73 TODO: uncomment and update with proper links when the report is ready.
74
75 = Performances tests compared to <last super stable version> =
76
77 <a summary of the comparison with latest super stable version>
78
79 More details on <link to the test report>.
80 {{/comment}}
81
82 = Known issues =
83
84 * [[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]]
85
86 = Backward Compatibility and Migration Notes =
87
88 == General Notes ==
89
90 * When upgrading make sure you compare and merge the following XWiki configuration files since some parameters may have been modified, removed or added:
91 ** ##xwiki.cfg##
92 ** ##xwiki.properties##
93 ** ##web.xml##
94 ** ##hibernate.cfg.xml##
95 * 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.
96
97 == Issues specific to XWiki 10.8 ==
98
99 * 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.(((
100 {{warning}}
101 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.
102
103 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:
104
105 {{code language="sql"}}RENAME TABLE notification_filter_preferences TO notification_filter_prefs;{{/code}}
106
107 Upgrades from prior versions are still supported and automated.
108 {{/warning}}
109 )))
110 * **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:(((
111 {{code language="xml"}}
112 <mapping resource=“notification-filter-preferences.hbm.xml”/>
113 {{/code}}
114 )))
115 * 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):
116 ** Addition of ##metadata-complete="true"## and ##<absolute-ordering />## in XWiki's ##web.xml##
117 ** 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.
118 * Auto redirects are now off by default when moving/renaming pages. Rationale:(((
119 * 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".
120 * 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.
121 * Even for public wikis not all pages need automatic redirects. Technical pages don't need them for example.
122 * We don't have management UIs for redirects FTM and reducing the number of redirects make the wiki easier
123
124 In the future we'll offer a [[config option to define the default behavior>>http://jira.xwiki.org/browse/XWIKI-13384]].
125 )))
126
127 == API Breakages ==
128
129 The following APIs were modified since XWiki 10.7:
130
131 {{backwardCompatiblityReport version="10.8"/}}
132
133 = Credits =
134
135 The following people have contributed code and translations to this release (sorted alphabetically):
136
137 Adel Atallah
138 Alex Cotiugă
139 Constantin Listar
140 Dominik Roszkowski
141 Ecaterina Moraru (Valica)
142 Eduard Moraru
143 Guillaume Delhumeau
144 Ilie Andriuta
145 Marius Dumitru Florea
146 Oana-Lavinia Florean
147 Roman Ivanov
148 Simon Urli
149 slauriere
150 Thomas Mortagne
151 Valdis Vitolins
152 Vincent Massol
153 xrichard
154 吴国凯

Get Connected