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 <insert description of release here>
8
9 = New and Noteworthy (since XWiki <version - 1>) =
10
11 [[Full list of issues fixed and Dashboard for <version>>>http://jira.xwiki.org/secure/Dashboard.jspa?selectPageId=<fill id here>]].
12
13 == Notifications & Watchlist ==
14
15 * A new menu has been added to the top bar, on the right: the "notifications" menu (represented by a bell). In the future, it will be the place where you can find notifications about some events happening on the wiki (personal message, a page has been modified, etc...).(((
16 {{image reference="Notifications.png"/}}
17 )))
18
19 * In this menu, we have moved the Watchlist icons (watch this page, watch this wiki, etc...). These actions can be triggered with the new switch buttons:(((
20 {{image reference="WatchList-Notifications.png"/}}
21 )))
22
23 == Miscellaneous ==
24
25 * Some [[bootswatch themes>>extensions:Extension.Bootswatch Themes for Flamingo]] have now a more accurate logo.
26 * When the search button on the top menu is clicked, it now closes all other menus.
27 * The Sandbox now uses the last XWiki 2.1 syntax.
28 * Non terminal pages are now exported with their corresponding ##WebPreferences## page
29
30 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+%227.4-milestone-1%22&tempMax=1000]] fixed in this release.
31
32 = For Developers =
33
34 == Tree Velocity Macros ==
35
36 You are now able to "call" the Document Tree from Velocity using something like this:
37
38 {{code language="none"}}
39 #documentTree({
40 'class': 'location-tree',
41 'finder': true,
42 'showAttachments': false,
43 'showRoot': $showRoot,
44 'showTerminalDocuments': false,
45 'showTranslations': false,
46 'showWikis': $showWikis
47 })
48 {{/code}}
49
50 The same is possible with the generic Tree Widget:
51
52 {{code language="none"}}
53 #tree({
54 'reference': 'XWiki.DocumentTree',
55 'root': 'document:xwiki:Sandbox.WebHome',
56 'openTo': 'document:xwiki:Sandbox.TestPage2'
57 })
58 {{/code}}
59
60 All the parameters that are available for the wiki macros (##~{~{documentTree}}## and ##~{~{tree}}##) should be available also for the corresponding Velocity macro.
61
62 == Deprecated and Retired projects ==
63
64 <description of deprecated and retired projects>
65
66 == Upgrades ==
67
68 The following dependencies have been upgraded:
69
70 * [[slf4j 1.7.13>>http://jira.xwiki.org/browse/XCOMMONS-879]]
71 * [[Joda-Time 2.9.1>>http://jira.xwiki.org/browse/XWIKI-12816]]
72 * [[commons-collections 3.2.2>>http://jira.xwiki.org/browse/XCOMMONS-881]]
73 * [[Maven 3.3.9>>http://jira.xwiki.org/browse/XCOMMONS-883]]
74 * [[Guice 4.0>>http://jira.xwiki.org/browse/XCOMMONS-883]]
75 * [[commons-dbcp2 2.1.1>>http://jira.xwiki.org/browse/XCOMMONS-884]]
76 * [[jboss-logging 3.1.4>>http://jira.xwiki.org/browse/XCOMMONS-885]]
77 * [[Woodstox 4.4.1>>http://jira.xwiki.org/browse/XWIKI-12853]]
78 * [[commons-net 3.4>>http://jira.xwiki.org/browse/XCOMMONS-887]]
79 * [[commons-collections 4.1>>http://jira.xwiki.org/browse/XCOMMONS-889]]
80
81 == Miscellaneous ==
82
83 * An extension point to add content inside the new "Notifications" menu has been added:(((
84 |=##[[org.xwiki.platform.notifications>>platform:ExtensionPoint.Notifications]]##
85 |{{image reference="NotificationsInside.png"/}}
86 )))
87 * A new ##extractFirstReference(EntityType)## API has been added to ##EntityReference##: Extract the first entity of the given type from this one by traversing the current entity to the root. This differentiates it from ##extractReference(EntityType)## which extracts the last entity of the given type.
88 * The escape Velocity tool has a new method to escape CSS identifiers. This is similar to ##CSS.escape()## available in JavaScript, and is useful if you want to create CSS selectors dynamicaly using untrusted input.(((
89 {{code language="none"}}
90 $escapetool.css('a#b.c d[e=f]g{h:i;j}k')
91 ## Output: a\\#b\\.c\\ d\\[e\\=f\\]g\\{h\\:i\\;j\\}k
92 {{/code}}
93 )))
94 * The Document Tree Macro has a new parameter to control whether the hidden documents are filtered or not. Set to false to force the display of the hidden documents in the tree.(((
95 {{code language="none"}}
96 {{documentTree filterHiddenDocuments="false" /}}
97 {{/code}}
98 )))
99
100 = Translations =
101
102 The following translations have been updated:
103
104 {{language codes="none, none"/}}
105
106 = Tested Browsers & Databases =
107
108 {{warning}}
109 The QA Tests are executed after the release has been done. Thus, they are being prepared now and will be published soon.
110 {{/warning}}
111
112 {{comment}}
113 TODO: uncomment and update with proper link when the report is ready.
114 {{include reference="TestReports.ManualTestReportTemplateSummary"/}}
115 {{/comment}}
116
117 = Performances tests compared to <last super stable version> =
118
119 <a summary of the comparison with latest super stable version>
120
121 More details on <link to the test report>.
122
123 = Known issues =
124
125 * [[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]]
126
127 = Backward Compatibility and Migration Notes =
128
129 == General Notes ==
130
131 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.
132
133 == Issues specific to XWiki 7.4 Milestone 1 ==
134
135 * Better backward-compatibility for URLs has been added for the following 2 cases:
136 ** If the ##view## action is omitted in the URL and the first space name doesn't match an action name, then the "view" action is implied
137 ** The ##view## action can be specified even when the wiki is configured to hide the ##view## action.
138 ** Note that this fixes [[some backward-compatibility issue introduced in XWiki 7.2>>ReleaseNotes.ReleaseNotesXWiki72||anchor="HURLs"]]
139
140 == API Breakages ==
141
142 The following APIs were modified since <project> <version - 1>:
143
144 {{code language="none"}}
145 <clirr output here>
146 {{/code}}

Get Connected