Version 51.3 by Vincent Massol on 2016/08/24

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]], [[XWiki Platform>>http://platform.xwiki.org]] and [[XWiki Enterprise>>http://enterprise.xwiki.org]]. They share the same release notes as they are released together and have the same version.
6
7 This release brings mostly usability improvements:
8 * You now have the ability to export children pages along with the current one in XAR and HTML formats.
9 * Ratings and active install numbers are now displayed in the Livetable on the home page of the Extension Repository Application.
10 * You can easily use a color theme from the main wiki in other subwikis.
11 * New hints are displayed in the user profile preferences.
12 * Some page suggestions are displayed when you try to reach a page or an attachment that do not exist.
13
14 In addition, more than 35 bugs have been fixed!
15
16 = New and Noteworthy (since XWiki 8.2) =
17
18 [[Full list of issues fixed and Dashboard for 8.3>>http://jira.xwiki.org/secure/Dashboard.jspa?selectPageId=13629]].
19
20 == New Children Macro ==
21
22 A new [[##~~{~~{children/}}## macro>>extensions:Extension.Children Macro.WebHome]] has been added to display a tree view of all children of the current page.
23
24 Example:
25
26 {{image reference="childrenmacro.png"/}}
27
28 == Export a page with children ==
29
30 It's now possible, for HTML and XAR formats, to export selected children along with the current page:
31
32 {{image reference="export.png"/}}
33
34 == Repository improvements ==
35
36 Rating is now displayed in the home page livetable.
37 The number of active installs is displayed for each extension in the home page livetable and in the extension page.
38
39 {{image reference="rating_home.png"/}}{{image reference="exo4.png"/}}
40
41 == Color themes ==
42
43 It's now possible, on a subwiki, to use a color theme coming from the main wiki (global themes).
44
45 {{image reference="FlamingoThemePicker.png"/}}
46
47 {{image reference="FlamingoThemesHome.png"/}}
48
49 == Blog Application ==
50
51 The Blog Category Panel now has an entry for All blog posts with a RSS feed for all.
52
53 {{image reference="BlogPanel.png"/}}
54
55 == Suggestions when a page or an attachment is not found ==
56
57 We have added suggestions for the "document not found" and "attachment not found" error screens. The suggestions address minor typos and misspelling (including lower case vs upper case), but also bad location requests:
58
59 * Documents:
60 {{image reference="docnotfound-suggestsions-mixed.png"/}}
61 * Attachments:
62 {{image reference="attachmentnotfound-suggestsions-mixed.png"/}}
63
64 == Miscellaneous ==
65
66 * User Profiles: We have added hints for User Profile Preferences:(((
67 {{image reference="userProfileHints.png"/}}
68 )))
69 * The [[AutoSave feature>>platform:Features.PageEditing||anchor="HAutosave"]] is now available in the WYSIWYG edit mode.
70 * It's now possible to customize a Maven repository in ##xwiki.properties## with any Aether property. See [[extensions:Extension.XWiki Commons - Extension - Repository - Maven]].
71 * It's now possible to change the socket and connection timeouts of a XWiki Repository in xwiki.properties. See [[extensions:Extension.XWiki Commons - Extension - Repository - XWiki]].
72 * Active installs client now send the memory used by the instance
73 * Debian packages now override standard configuration files handling for ##xwiki.cfg##, ##xwiki.properties## and ##web.xml## to provide 3 ways merge with standard dpkg and apt command line tools
74
75 See the [[full list of JIRA issues>>http://jira.xwiki.org/sr/jira.issueviews:searchrequest-printable/temp/SearchRequest.html?jqlQuery=project+in+%28XCOMMONS%2C+XRENDERING%2C+XWIKI%2C+XE%29+and+status+%3D+Closed+and+resolution+%3D+Fixed+and+fixVersion+%3D+%228.3-milestone-1%22&tempMax=1000]] fixed in this release.
76
77 = For Developers =
78
79 == Velocity and Script context improvements ==
80
81 ##VelocityContext## and ##ScriptContext## are here since a long time and were not fully a sync leading to many hack having to deal with both (and often forgetting one of the other).
82
83 They are now fully in synch (and if you find a use case where it's not true create a BUG on http://jira.xwiki.org) and VelocityContext is now close to internal detail. From now on if you want to set some binding for whatever script is going to be executed next you should to it trough ##ScriptContext## and completely forget that ##VelocityContext## ever existed in most cases.
84
85 New APIs to help with that:
86
87 * ##VelocityManager#evaluate(Writer out, String templateName, Reader source)## which execute the passed velocity content with the passed template name and write the result in the passed Writer. This method deal with ##VelocityContext## internally
88 * ##ScriptContextManager#getCurrentScriptContext()## should be used when you want to SET something in the current script context so that it end up in a script that might be executed later
89 * ##ScriptContextManager#getScriptContext()## is not new but should be used only if you want to get the ##ScriptContext## exactly as a script would get it (to see if it contains something you want to access), this should be a rare use case.
90
91 Another consequence of this is that you can (finally) do things like:
92
93 {{code}}
94 {{velocity}}
95 ## Setting some script binding in Velocity
96 #set($myvar = "toto")
97 {{/velocity}}
98
99 {{groovy}}
100 // Lets use the script binding that has been set in previous script
101 print myvar
102 {{/groovy}}
103 {{/code}}
104
105 The opposite was already possible but there was some limitations, for example it was impossible to overwrite in groovy a binding that was already in the ##VelocityContext##.
106
107 == Filter framework improvements ==
108
109 Thanks to Java 8 now supporting getting method parameter names through reflection, it's not required anymore to use ##@Name## annotation in the definition of a filter. See [[extensions:Extension.Filter Module||anchor="#HAnnotations"]] for more details.
110
111 It's also possible to override the name of the event (which is by default extracted from the method name) using the ##@Name## annotation.
112
113 Filter manager make sure to calculate the event descriptor based on the top most overridden method (usually coming from an interface). Various things were not always properly inherited (like event name or reflection based parameters names).
114
115 == Cache module moved to XWiki Commons ==
116
117 This mostly means that you can now use it in commons and rendering modules. Nothing change in the classes or packages names, just need to update group id and artifact id in your build tool.
118
119 == Deprecated and Retired projects ==
120
121 * Application Manager moved to https://github.com/xwiki-contrib/xwiki-platform-application-manager, it can still be installed as extension if required
122
123 == Upgrades ==
124
125 The following dependencies have been upgraded:
126
127 * [[Jackson 2.8.1>>http://jira.xwiki.org/browse/XCOMMONS-1015]]
128 * [[cssparser 0.9.20>>http://jira.xwiki.org/browse/XCOMMONS-1024]]
129 * [[Infinispan 8.2.4>>http://jira.xwiki.org/browse/XCOMMONS-1046]]
130 * [[JSON-Java 20160810>>http://jira.xwiki.org/browse/XCOMMONS-1045]]
131 * [[Bouncy Castle 1.55>>http://jira.xwiki.org/browse/XCOMMONS-1049]]
132
133 == Miscellaneous ==
134
135 * 2 new generic extension points for the Document/Attachment Not Found views:
136 ** [[platform:ExtensionPoint.Document Does Not Exist]]
137 ** [[platform:ExtensionPoint.Attachment Does Not Exist]]
138 * 2 new specific extension points for providing recommendations in the Document/Attachment Not Found views:
139 ** [[platform:ExtensionPoint.Suggestions for Document Does Not Exist]]
140 ** [[platform:ExtensionPoint.Suggestions for Attachment Does Not Exist]]
141 * injected extension repositories can now be associated with a priority
142
143 = Translations =
144
145 The following translations have been updated:
146
147 {{language codes="none, none"/}}
148
149 = Tested Browsers & Databases =
150
151 {{warning}}
152 The QA Tests are executed after the release has been done. Thus, they are being prepared now and will be published soon.
153 {{/warning}}
154
155 {{comment}}
156 TODO: uncomment and update with proper link when the report is ready.
157 {{include reference="TestReports.ManualTestReportTemplateSummary"/}}
158 {{/comment}}
159
160 = Performances tests compared to <last super stable version> =
161
162 <a summary of the comparison with latest super stable version>
163
164 More details on <link to the test report>.
165
166 = Known issues =
167
168 * [[Bugs we know about>>http://jira.xwiki.org/secure/IssueNavigator.jspa?reset=true&jqlQuery=category+%3D+%22Top+Level+Projects%22+AND+issuetype+%3D+Bug+AND+resolution+%3D+Unresolved+ORDER+BY+updated+DESC]]
169
170 = Backward Compatibility and Migration Notes =
171
172 == General Notes ==
173
174 When upgrading make sure you compare your ##xwiki.cfg##, ##xwiki.properties## and ##web.xml## files with the newest version since some configuration parameters may have been modified or added. Note that you should add ##xwiki.store.migration=1## so that XWiki will attempt to automatically migrate your current database to the new schema. Make sure you backup your Database before doing anything.
175
176 == Issues specific to XWiki 8.3 Milestone 1 ==
177
178 === LDAP Module moved to Contrib ===
179
180 The module containing among other things the standard LDAP authenticator has been moved to http://github.com/xwiki-contrib/ldap and is not embedded anymore in XE. Starting with 8.3M1 you need to install it if you want to use it. See http://extensions.xwiki.org/xwiki/bin/view/Extension/LDAP/#H8.3.x for more details on what between the XWiki Platform module and the new Contrib Extension.
181
182 === Cache module moved to XWiki Commons ===
183
184 The only thing that changed is the id of the modules. If you have any dependency on those you just need to change ##org.xwiki.platform:xwiki-platform-*## to ##org.xwiki.commons:xwiki-commons-*##
185
186 == API Breakages ==
187
188 No API has been broken since XWiki 8.2.1!
189
190 = Credits =
191
192 The following people have contributed code to this release (sorted alphabetically):
193
194 * Alexandru Cotiuga
195 * Denis Gervalle
196 * Ecaterina Moraru (Valica)
197 * Eduard Moraru
198 * Guillaume Delhumeau
199 * Lukas Krejci
200 * Manuel Smeria
201 * Marius Dumitru Florea
202 * Sergiu Dumitriu
203 * Thomas Mortagne
204 * Vincent Massol

Get Connected