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 an upgrade to the Java 8 runtime, a new Tips panel that replaces the old Quick Links panel, Extension Manager improvements and LDAP avatar synchronization. As usual, a lot of bug fixes (81) and minor improvements (43) are also included.
8
9 = New and Noteworthy (since XWiki 8.0) =
10
11 [[Full list of issues fixed and Dashboard for 8.1>>https://jira.xwiki.org/secure/Dashboard.jspa?selectPageId=13603]].
12
13 {{display reference="ReleaseNotesXWiki81M1" section="HRequiresJava8"/}}
14
15 {{display reference="ReleaseNotesXWiki81M1" section="HTipsPanel"/}}
16
17 {{display reference="ReleaseNotesXWiki81M1" section="HSandboxRelocation"/}}
18
19 {{display reference="ReleaseNotesXWiki81M2" section="HDocumentsMacroImprovement"/}}
20
21 {{display reference="ReleaseNotesXWiki81M2" section="HRSSMacroImprovements"/}}
22
23 {{display reference="ReleaseNotesXWiki81M1" section="HExtensionManagerimprovements"/}}
24
25 {{display reference="ReleaseNotesXWiki81M1" section="HFlavorsimprovements"/}}
26
27 {{display reference="ReleaseNotesXWiki81M2" section="HSynchronizationofuseravatarfromLDAP"/}}
28
29 {{display reference="ReleaseNotesXWiki81M1" section="HActiveInstalls"/}}
30
31 == Miscellaneous ==
32
33 * The Annotations Application's Administration section has been updated to present the exception spaces as "locations", using the ##documentTree## macro. The behavior has not been changed.(((
34 {{image reference="[email protected]" width="600px"/}}
35 )))
36 * The [[Gadget's title>>extensions:Extension.Dashboard Macro||anchor="HGadget27stitile"]] has now a default value which is internationalized.
37 * Put a link to the product home page in the footer by default
38 * Template providers that are restricted to certain pages are now also available on the children of those pages.
39 * The [[Document Tree Macro>>extensions:Extension.Document Tree Macro||anchor="HParameters"]] has a new parameter to limit the number of child nodes displayed when a parent node is expanded for the first time.
40 * The ##xwiki.usedefaultweb## parameter from ##xwiki.cfg## has been removed. See below.
41 * Job module does not validate stored status at startup. This might improve a lot the startup time when there is a lot of status. Also there seems to still be use cases where XStream get lost in edge case when parsing, this was blocking the whole XWiki startup for a very long time.
42
43 See the [[full list of JIRA issues>>https://jira.xwiki.org/issues/?filter=14308]] fixed in this release.
44
45 = For Developers =
46
47 {{display reference="ReleaseNotesXWiki81M2" section="HStandardjava.lang.Packageproperties"/}}
48
49 {{display reference="ReleaseNotesXWiki81M1" section="HDeferredJavaScriptModuleDependencyLoading"/}}
50
51 {{display reference="ReleaseNotesXWiki81RC1" section="HContextandcacheinconsistencyhunting"/}}
52
53 {{display reference="ReleaseNotesXWiki81RC1" section="HExtensionManagerimprovements"/}}
54
55 == Upgrades ==
56
57 The following dependencies have been upgraded:
58
59 * [[Bootstrap 3.3.6>>https://jira.xwiki.org/browse/XWIKI-12951]]
60 * [[commons-compress 1.11>>https://jira.xwiki.org/browse/XCOMMONS-960]]
61 * [[commons-io 2.5>>https://jira.xwiki.org/browse/XCOMMONS-969]]
62 * [[commons-net 3.5>>https://jira.xwiki.org/browse/XCOMMONS-977]]
63 * [[GWT 2.7>>https://jira.xwiki.org/browse/XWIKI-13236]]
64 * [[Infinispan 8.2.1>>https://jira.xwiki.org/browse/XWIKI-13293]]
65 * [[Jackson 2.7.4>>https://jira.xwiki.org/browse/XCOMMONS-972]]
66 * [[JGroups 3.6.9>>https://jira.xwiki.org/browse/XWIKI-13344]]
67 * [[jQuery 2.2.2>>https://jira.xwiki.org/browse/XWIKI-11095]]
68 * [[JSqlParser 0.9.5>>https://jira.xwiki.org/browse/XWIKI-13215]]
69 * [[logback 1.1.7>>https://jira.xwiki.org/browse/XCOMMONS-953]]
70 * [[RequireJS 2.2>>https://jira.xwiki.org/browse/XWIKI-11095]]
71 * [[slf4j 1.7.21>>https://jira.xwiki.org/browse/XCOMMONS-958]]
72 * [[XStream 1.4.9>>https://jira.xwiki.org/browse/XCOMMONS-941]]
73
74 == Miscellaneous ==
75
76 * The default LiveTable results page (##XWiki.LiveTableResults##, the page that generates the JSON displayed by the LiveTable) [[now supports a ##location## extra parameter>>extensions:Extension.Livetable Macro||anchor="HParameter24options"]].
77 * [[Modified WebJars URL format>>extensions:Extension.WebJars Integration||anchor="HURLFormat"]] and added some new Script Service methods:(((
78 {{code language="none"}}
79 public String url(String webjarId, String namespace, String path, Map<String, ?> params)
80 public String url(String webjarId, String namespace, String path)
81 {{/code}}
82 )))
83 * IRC Bot Application has been moved to XWiki Contrib under the new extension id of ##org.xwiki.contrib:application-ircbot-ui##
84 * Selenium Application had been moved to XWiki Contrib under the new extension id of ##org.xwiki.contrib:application-selenium##
85 * FAQ Application has been moved to XWiki Contrib under the new extension id of ##org.xwiki.contrib:application-faq-ui##
86 * Starting With XWiki 8.1M1, the backward-compatibility tool we use is [[Revapi>>http://revapi.org/]]. We had to move away from CLIRR since it didn't support Java 8 constructs.
87 * Introduced JobFinishingEvent to be called at the end of the job execution before starting to close it
88 * Introduced new JobStatus#getError() which return the exception that filled the job main execution (if any) (it's also logged in the log as an error like before)
89 * The XAR plugin now also verifies that Translation pages are using the ##plain/1.0## syntax (it checks pages having a Translation xobject in them).
90 * This Methods Arguments Velocity Uberspector [[now supports calling varargs methods>>extensions:Extension.Velocity Module||anchor="HMethodArgumentsUberspector"]].
91
92 = Translations =
93
94 The following translations have been updated:
95
96 {{language codes="ca, de, fr, pt_BR, ru"/}}
97
98 = Tested Browsers & Databases =
99
100 {{include reference="TestReports.ManualTestReportSummaryXWiki81"/}}
101
102 = Performances tests compared to <last super stable version> =
103
104 <a summary of the comparison with latest super stable version>
105
106 More details on <link to the test report>.
107
108 = Known issues =
109
110 * [[Bugs we know about>>https://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]]
111
112 = Backward Compatibility and Migration Notes =
113
114 == General Notes ==
115
116 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.
117
118 == Issues specific to XWiki 8.1 ==
119
120 * Since we've modified content of the Quick Links Panel, the Distribution Wizard may detect a merge conflict if this panel was customized. In addition, the Quick Links panel may disappear after an upgrade to 8.1M1+. You can add it back from the administration UI if you want to keep it (e.g. if it has been customized).
121 * The WebJars URL format has been modified to support relative WebJars URL in subwikis. The new format is {{code language="none"}}/webjars/<namespace>/<path/to/resource>?...{{/code}}. Reminder: you should not use this format directly and instead you should use the Script Service to generate a valid WebJars URL; this isolate you from any URL change. Example from Velocity: {{code language="none"}}$services.webjars.url(...){{/code}}.
122 * The ##xwiki.usedefaultweb## parameter has been removed from ##xwiki.cfg##. This parameter had not been working since XWiki 7.2-milestone-1; when we introduced Nested Pages we had to make a choice and we decided to support addressing top-level Nested Pages without having to have ##WebHome## in the URL (nor having to finish URLs with a trailing ##/##). For example, ##http:~/~/<server>/xwiki/bin/view/something## points to ##something.WebHome## by default since XWiki 7.2-milestone-1.
123
124 == API Breakages ==
125
126 The following APIs were modified since XWiki 8.0:
127
128 {{backwardCompatiblityReport version="8.1"/}}

Get Connected