Hide last authors
Guillaume Delhumeau 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]], [[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
Guillaume Delhumeau 44.1 7 This release brings mostly usability improvements. You now have the ability to export children pages along with the current one in XAR and HTML formats. The rating of the extensions and their active install number are displayed in the home page. You can easily use a color theme from the main wiki in other subwikis. New hints are displayed in the user profile preferences. Some suggestions are displayed when you try to reach a page or an attachment that does not exist.
Guillaume Delhumeau 1.1 8
Guillaume Delhumeau 42.1 9 For the developers, some improvements have been done, especially in the script contexts.
Guillaume Delhumeau 32.1 10
Guillaume Delhumeau 43.1 11 Finally, more than 35 bugs have been fixed!
Guillaume Delhumeau 32.1 12
Vincent Massol 41.3 13 {{error}}
14 The following regressions were found after this version has been released and will most likely be fixed in the next release:
15
16 {{jira url="http://jira.xwiki.org" style="list" source="list" fields="status, key, summary"}}
17 XWIKI-13651
18 {{/jira}}
19 {{/error}}
20
Guillaume Delhumeau 15.1 21 = New and Noteworthy (since XWiki 8.2) =
Guillaume Delhumeau 1.1 22
Guillaume Delhumeau 15.1 23 [[Full list of issues fixed and Dashboard for 8.3>>http://jira.xwiki.org/secure/Dashboard.jspa?selectPageId=13629]].
Guillaume Delhumeau 1.1 24
Vincent Massol 40.1 25 == New Children Macro ==
26
Vincent Massol 41.2 27 A new [[##~~{~~{children/}}## macro>>extensions:Extension.Children Macro.WebHome]] has been added to display a tree view of all children of the current page.
Vincent Massol 40.1 28
29 Example:
30
31 {{image reference="childrenmacro.png"/}}
32
Guillaume Delhumeau 13.1 33 == Export a page with children ==
34
35 It's now possible, for HTML and XAR formats, to export selected children along with the current page:
36
37 (((
38 {{image reference="export.png"/}}
39 )))
40
Thomas Mortagne 23.1 41 == Repository improvements ==
42
43 Rating is now displayed in the home page livetable.
Thomas Mortagne 35.1 44 The number of active installs is displayed for each extension in the home page livetable and in the extension page.
Thomas Mortagne 23.1 45
Thomas Mortagne 36.1 46 {{image reference="rating_home.png"/}}{{image reference="exo4.png"/}}
Thomas Mortagne 23.1 47
Guillaume Delhumeau 45.1 48 == Color themes ==
Guillaume Delhumeau 1.1 49
Guillaume Delhumeau 45.1 50 It's now possible, on a subwiki, to use a color theme coming from the main wiki (global themes):(((
Guillaume Delhumeau 2.1 51 {{image reference="FlamingoThemePicker.png"/}}
52 {{image reference="FlamingoThemesHome.png"/}}
53 )))
Guillaume Delhumeau 45.1 54
55 == User Profile ==
56 * Added hints for User Profile Preferences:(((
57 {{image reference="userProfileHints.png"/}}
58 )))
59
60 == Blog Application ==
Vincent Massol 6.1 61 * The Blog Category Panel now has an entry for All blog posts with a RSS feed for all:(((
62 {{image reference="BlogPanel.png"/}}
63 )))
Guillaume Delhumeau 45.1 64
65 == Suggestions when a page or an attachment is not found ==
66
Eduard Moraru 12.3 67 * 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:
68 ** Documents:
Eduard Moraru 12.2 69 {{image reference="docnotfound-suggestsions-mixed.png"/}}
Eduard Moraru 12.3 70 ** Attachments:
Eduard Moraru 12.2 71 {{image reference="attachmentnotfound-suggestsions-mixed.png"/}}
Guillaume Delhumeau 45.1 72
73 == Miscellaneous ==
74
Thomas Mortagne 26.1 75 * It's now possible to customize a Maven repository in ##xwiki.properties## with any Aether property. See [[extensions:Extension.XWiki Commons - Extension - Repository - Maven]].
Thomas Mortagne 27.1 76 * 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]].
Thomas Mortagne 28.2 77 * Active installs client now send the memory used by the instance
Thomas Mortagne 30.1 78 * 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
Guillaume Delhumeau 1.1 79
Guillaume Delhumeau 15.1 80 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.
Guillaume Delhumeau 1.1 81
82 = For Developers =
83
Thomas Mortagne 28.1 84 == Velocity and Script context improvements ==
85
86 ##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).
87
88 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.
89
90 New APIs to help with that:
91
92 * ##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
93 * ##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
94 * ##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.
95
96 Another consequence of this is that you can (finally) do things like:
97
98 {{code}}
99 {{velocity}}
100 ## Setting some script binding in Velocity
101 #set($myvar = "toto")
102 {{/velocity}}
103
104 {{groovy}}
105 // Lets use the script binding that has been set in previous script
106 print myvar
107 {{/groovy}}
108 {{/code}}
109
110 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##.
111
Thomas Mortagne 24.1 112 == Filter framework improvements ==
Guillaume Delhumeau 1.1 113
Vincent Massol 39.3 114 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.
Guillaume Delhumeau 1.1 115
Thomas Mortagne 33.1 116 It's also possible to override the name of the event (which is by default extracted from the method name) using the ##@Name## annotation.
117
Thomas Mortagne 39.1 118 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).
119
Thomas Mortagne 20.2 120 == Cache module moved to XWiki Commons ==
121
122 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.
123
Guillaume Delhumeau 1.1 124 == Deprecated and Retired projects ==
125
Thomas Mortagne 17.1 126 * Application Manager moved to https://github.com/xwiki-contrib/xwiki-platform-application-manager, it can still be installed as extension if required
Guillaume Delhumeau 1.1 127
128 == Upgrades ==
129
130 The following dependencies have been upgraded:
131
Thomas Mortagne 10.1 132 * [[Jackson 2.8.1>>http://jira.xwiki.org/browse/XCOMMONS-1015]]
133 * [[cssparser 0.9.20>>http://jira.xwiki.org/browse/XCOMMONS-1024]]
Thomas Mortagne 18.1 134 * [[Infinispan 8.2.4>>http://jira.xwiki.org/browse/XCOMMONS-1046]]
Thomas Mortagne 19.1 135 * [[JSON-Java 20160810>>http://jira.xwiki.org/browse/XCOMMONS-1045]]
Thomas Mortagne 31.1 136 * [[Bouncy Castle 1.55>>http://jira.xwiki.org/browse/XCOMMONS-1049]]
Guillaume Delhumeau 1.1 137
138 == Miscellaneous ==
139
Eduard Moraru 15.2 140 * 2 new generic extension points for the Document/Attachment Not Found views:
141 ** [[platform:ExtensionPoint.Document Does Not Exist]]
142 ** [[platform:ExtensionPoint.Attachment Does Not Exist]]
143 * 2 new specific extension points for providing recommendations in the Document/Attachment Not Found views:
144 ** [[platform:ExtensionPoint.Suggestions for Document Does Not Exist]]
145 ** [[platform:ExtensionPoint.Suggestions for Attachment Does Not Exist]]
Thomas Mortagne 37.1 146 * injected extension repositories can now be associated with a priority
Eduard Moraru 15.2 147
Guillaume Delhumeau 1.1 148 <other dev stuff to add and link to JIRA for all issues fixed>
149
150 = Translations =
151
152 The following translations have been updated:
153
154 {{language codes="none, none"/}}
155
156 = Tested Browsers & Databases =
157
158 {{warning}}
159 The QA Tests are executed after the release has been done. Thus, they are being prepared now and will be published soon.
160 {{/warning}}
161
162 {{comment}}
163 TODO: uncomment and update with proper link when the report is ready.
164 {{include reference="TestReports.ManualTestReportTemplateSummary"/}}
165 {{/comment}}
166
167 = Performances tests compared to <last super stable version> =
168
169 <a summary of the comparison with latest super stable version>
170
171 More details on <link to the test report>.
172
173 = Known issues =
174
175 * [[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]]
176
177 = Backward Compatibility and Migration Notes =
178
179 == General Notes ==
180
181 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.
182
Thomas Mortagne 16.1 183 == Issues specific to XWiki 8.3 Milestone 1 ==
Guillaume Delhumeau 1.1 184
Thomas Mortagne 17.1 185 === LDAP Module moved to Contrib ===
Guillaume Delhumeau 1.1 186
Thomas Mortagne 16.1 187 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.
188
Thomas Mortagne 20.1 189 === Cache module moved to XWiki Commons ===
190
191 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-*##
192
Guillaume Delhumeau 1.1 193 == API Breakages ==
194
195 The following APIs were modified since <project> <version - 1>:
196
197 {{comment}}
198 Remove!
199 {{backwardCompatiblityReport version="<version>"/}}
200 {{/comment}}
201
202 = Credits =
203
204 The following people have contributed code to this release (sorted alphabetically):
205
206 <code contributors>

Get Connected