Wiki source code of Release Notes for XWiki 7.4

Version 25.1 by Guillaume Delhumeau on 2015/12/28

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 7.3) =
10
11 [[Full list of issues fixed and Dashboard for 7.4>>http://jira.xwiki.org/secure/Dashboard.jspa?selectPageId=13590]].
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 * 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.(((
19 {{image reference="WatchList-Notifications.png"/}}
20 )))
21 * The livetable of the [[WatchList macro>>extensions:Extension.Watchlist Application]] have been updated to support Nested Pages.(((
22 {{image reference="WatchListTable.png"/}}
23 )))
24
25 == App Within Minutes ==
26
27 The application Code and Data pages are now being created. The Code page lists the application code pages.
28
29 {{image reference="[email protected]"/}}
30
31 The application Data page shows a live table with the application entries. The application home page has been modified to include the Data page.
32
33 {{image reference="[email protected]"/}}
34
35 The application entries (custom) live table results page is not generated any more because it was used only to load the translations on demand and now they are loaded on the wiki or user scope, based on the user rights.
36
37 == Support for template hierarchies ==
38
39 When creating a new document from template, if the template has descendent documents under its path, those documents will also be copied over to the new document's location, preserving the hierarchy, as it was under the template document.
40
41 The save operation will display progress and if it was a Save&View operation, the form will be disabled until the operation is complete.
42
43 More details on the [[documentation page on document templates>>extensions:Extension.Administration Application||anchor="HUsingahierarchyofNestedDocumentsastemplate"]].
44
45 {{image reference="[email protected]" width="50%"/}}
46
47 == Automatic Redirect on Page Rename ==
48
49 The [[Rename Page>>platform:Features.DocumentLifecycle||anchor="HMove2FRename"]] action has a new option (selected by default) to create an automatic redirect from the old page location to the new one. This will ensure that the external links (e.g. the bookmarks) to the renamed page (and its children) will continue to work.
50
51 {{image reference="[email protected]"/}}
52
53 == Database Search ==
54
55 The [[Database Search>>extensions:Extension.Search Application||anchor="HDatabaseSearch"]] UI has been modified to support nested pages.
56
57 {{image reference="[email protected]"/}}
58
59 == Miscellaneous ==
60
61 * Some [[bootswatch themes>>extensions:Extension.Bootswatch Themes for Flamingo]] have now a more accurate logo.
62 * When the search button on the top menu is clicked, it now closes all other menus.
63 * The Sandbox now uses XWiki Syntax 2.1.
64 * Non terminal pages are now exported with their corresponding ##WebPreferences## page
65 * The "annotations" button in the "More Actions" menu has been moved in the same menu but with other actions and renamed "Annotate".(((
66 {{image reference="[email protected]"/}}
67 )))
68 * The Create Page UI allows you to view and change the location of the new page (that is going to be created) even when you [[open directly the URL of a new page>>platform:Features.DocumentLifecycle||anchor="HByenteringdirectlytheURLofthenewpage"]].
69
70 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%22&tempMax=1000]] fixed in this release.
71
72 = For Developers =
73
74 == Flamingo ==
75
76 An extension point to add content inside the new "Notifications" menu has been added:
77
78 |=##[[org.xwiki.platform.notifications>>platform:ExtensionPoint.Notifications]]##
79 |{{image reference="[email protected]"/}}
80
81 == Tree Velocity Macros ==
82
83 You are now able to "call" the Document Tree from Velocity using something like this:
84
85 {{code language="none"}}
86 #documentTree({
87 'class': 'location-tree',
88 'finder': true,
89 'showAttachments': false,
90 'showRoot': $showRoot,
91 'showTerminalDocuments': false,
92 'showTranslations': false,
93 'showWikis': $showWikis
94 })
95 {{/code}}
96
97 The same is possible with the generic Tree Widget:
98
99 {{code language="none"}}
100 #tree({
101 'reference': 'XWiki.DocumentTree',
102 'root': 'document:xwiki:Sandbox.WebHome',
103 'openTo': 'document:xwiki:Sandbox.TestPage2'
104 })
105 {{/code}}
106
107 All the parameters that are available for the wiki macros (##~{~{documentTree}}## and ##~{~{tree}}##) should be available also for the corresponding Velocity macro.
108
109 == New public Abstract job ==
110
111 A public ##org.xwiki.job.AbstractJob## (and corresponding ##AbstractJobStatus##) is now provided to help implementing a Job. An ##AbstractJob## class already existed since a long time but it was in an internal package.
112
113 == New lifespan LRU Cache setup ==
114
115 It's now possible to define the maximum time to live since the entry is put in the cache. It used to be possible to set it only since the last time the value was used.
116
117 {{code language="java"}}
118 // Configure cache eviction policy
119 LRUEvictionConfiguration lru = new LRUEvictionConfiguration();
120 // Set maximum size of the cache as 1000 entries
121 lru.setMaxEntries(1000);
122 // Set the maximum time to live since when the entry is used to 1 hour
123 lru.setMaxIdle(3600)
124 // Set the maximum time to live since when the entry is put in the cache to 1 hour
125 lru.setLifespan(3600)
126 {{/code}}
127
128 [[Cache Macro>>extensions:Extension.Cache Macro]] and [[Rendering Cache>>platform:AdminGuide.Performances||anchor="HRenderingcache"]] are now based on this behavior.
129
130 == VFS API ==
131
132 {{warning}}
133 Right now the [[VFS API is missing authorization checks>>http://jira.xwiki.org/browse/XWIKI-12912]], meaning that you should use it only for public archives.
134 {{/warning}}
135
136 Replacement of the [[Zip Explorer Plugin>>extensions:Extension.ZIP Explorer Plugin]]. API to access the content of archives files (zip, jar, gzip, tar, etc) located as attachments in wiki pages or elsewhere (external URLs, file system, et).
137
138 In addition a new [[Velocity Tool>>extensions:Extension.Velocity Module||anchor="HVelocityTools"]] was added in order to be able to use a portion of the NIO2 API from Velocity: ##niotool##.
139
140 See [[VFS API>>extensions:Extension.VFS API]] and [[VFS Tree Macro>>extensions:Extension.VFS Tree Macro]] for more details. Some API examples:
141
142 {{code language="velocity"}}
143 {{velocity}}
144 ## Get the URL to access the content of a file inside a zip:
145 [[link to file in zip>>$services.vfs.url("attach:[email protected]/vma.txt")]]
146
147 ## Display inline an image from a zip attached to a wiki page:
148 [[image:path:$services.vfs.url("attach:[email protected]/test.png")]]
149
150 ## Read the content of a file inside a zip attached to a page:
151 $stringtool.toString($niotool.readAllBytes("attach:[email protected]/vma.txt"), "utf-8")
152
153 ## List all entries inside a zip attached to a page:
154 #set ($dirStream = $niotool.newDirectoryStream("attach:[email protected]/"))
155 #foreach ($entry in $dirStream)
156 * {{{$entry}}} - $niotool.isDirectory($entry)
157 #end
158 {{/velocity}}
159
160 {{vfsTree root="attach:[email protected]/"/}}
161 {{/code}}
162
163 Example of using the ##vfsTree## Macro:
164
165 {{code language="none"}}
166 {{vfsTree root="attach:[email protected]/"/}}
167 {{/code}}
168
169 Results in:
170
171 {{image reference="[email protected]"/}}
172
173
174 == Miscellaneous ==
175
176 * 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.
177 * 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.(((
178 {{code language="none"}}
179 $escapetool.css('a#b.c d[e=f]g{h:i;j}k')
180 ## Output: a\\#b\\.c\\ d\\[e\\=f\\]g\\{h\\:i\\;j\\}k
181 {{/code}}
182 )))
183 * 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.(((
184 {{code language="none"}}
185 {{documentTree filterHiddenDocuments="false" /}}
186 {{/code}}
187 )))
188 * Temporary resources can now be forced to be downloaded by using the ##force-download=1## URL parameter
189 * [[WebJars URL format>>extensions:Extension.WebJars Integration||anchor="HURLFormat"]] now supports a ##wiki## query string parameter to specify the wiki in which the webjars resource is available. For example: {{code language="none"}}/xwiki/webjars/AjaxQ/0.0.2/ajaxq.js?wiki=mywiki{{/code}}
190 * The default link behaviour can be disabled for a tree node, when you use the [[Tree Widget>>extensions:Extension.Tree Widget]], by using the 'jstree-no-link' CSS class on the node anchor, which can be set from the node JSON:(((
191 {{code language="none"}}
192 {
193 ... (node JSON) ...
194 'a_attr': {
195 'class': 'jstree-no-link',
196 'href': 'some/url'
197 }
198 }
199 {{/code}}
200 )))
201 * The ##$regextool## [[Velocity Tool>>extensions:Extension.Velocity Module||anchor="HVelocityTools"]] has a new method:(((
202 {{code language="java"}}
203 /**
204 * @param content the content to parse
205 * @param regex the regular expression to look for in the passed content
206 * @return an empty list if the passed regular expression doesn't match the content, several {@link RegexResult}
207 * objects containing the matched position and matched content for all capturing groups and sub-groups
208 * otherwise
209 */
210 public List<List<RegexResult>> findAll(String content, String regex)
211 {{/code}}
212
213 We had to add a new method because the existing ##RegexTool#find(String, String)## returns information about only the first capturing group. Here's a test to show how the new method works:
214
215 {{code language="java"}}
216 @Test
217 public void findAll()
218 {
219 RegexTool tool = new RegexTool();
220 List<List<RegexResult>> result =
221 tool.findAll("one :two three (:four) five :six seven=:eight", ":(\\w+) (\\w+)");
222
223 Assert.assertEquals(2, result.size());
224 Assert.assertEquals(":two three", result.get(0).get(0).getGroup());
225 Assert.assertEquals(":six seven", result.get(1).get(0).getGroup());
226
227 Assert.assertEquals(3, result.get(0).size());
228 Assert.assertEquals("two", result.get(0).get(1).getGroup());
229 Assert.assertEquals("three", result.get(0).get(2).getGroup());
230
231 Assert.assertEquals(3, result.get(1).size());
232 Assert.assertEquals("six", result.get(1).get(1).getGroup());
233 Assert.assertEquals("seven", result.get(1).get(2).getGroup());
234 }
235 {{/code}}
236 )))
237
238 * The top level Commons POM now performs some checks on the POMs that have it as parent; for example it checks that non core POMs don't use the "XWiki Development Team" in the developers section so that non-core Extensions deployed on extensions.xwiki.org don't appear as developed by the XWiki Development Team.
239 * You can now disable the default [[Live Table>>extensions:Extension.Livetable Macro]] query filters by passing the empty string as the value of the ##queryFilters## parameter.
240
241 == Deprecated and Retired projects ==
242
243 * XML-RPC module have been moved to https://github.com/xwiki-contrib/xwiki-platform-xmlrpc
244
245 == Upgrades ==
246
247 The following dependencies have been upgraded:
248
249 * [[Batik 1.8>>http://jira.xwiki.org/browse/XWIKI-12904]]
250 * [[commons-collections 4.1>>http://jira.xwiki.org/browse/XCOMMONS-889]]
251 * [[commons-dbcp2 2.1.1>>http://jira.xwiki.org/browse/XCOMMONS-884]]
252 * [[commons-net 3.4>>http://jira.xwiki.org/browse/XCOMMONS-887]]
253 * [[FOP 2.0>>http://jira.xwiki.org/browse/XWIKI-12871]]
254 * [[guava 19>>http://jira.xwiki.org/browse/XCOMMONS-894]]
255 * [[Guice 4.0>>http://jira.xwiki.org/browse/XCOMMONS-883]]
256 * [[Jackson 2.6.4>>http://jira.xwiki.org/browse/XCOMMONS-893]]
257 * [[jboss-logging 3.1.4>>http://jira.xwiki.org/browse/XCOMMONS-885]]
258 * [[Joda-Time 2.9.1>>http://jira.xwiki.org/browse/XWIKI-12816]]
259 * [[Less4j 1.15.4>>http://jira.xwiki.org/browse/XWIKI-12905]]
260 * [[Maven 3.3.9>>http://jira.xwiki.org/browse/XCOMMONS-883]]
261 * [[slf4j 1.7.13>>http://jira.xwiki.org/browse/XCOMMONS-879]]
262 * [[Woodstox 4.4.1>>http://jira.xwiki.org/browse/XWIKI-12853]]
263
264 = Translations =
265
266 The following translations have been updated:
267
268 {{language codes="none, none"/}}
269
270 = Tested Browsers & Databases =
271
272 {{warning}}
273 The QA Tests are executed after the release has been done. Thus, they are being prepared now and will be published soon.
274 {{/warning}}
275
276 {{comment}}
277 TODO: uncomment and update with proper link when the report is ready.
278 {{include reference="TestReports.ManualTestReportTemplateSummary"/}}
279 {{/comment}}
280
281 = Performances tests compared to <last super stable version> =
282
283 <a summary of the comparison with latest super stable version>
284
285 More details on <link to the test report>.
286
287 = Known issues =
288
289 * [[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]]
290
291 = Backward Compatibility and Migration Notes =
292
293 == General Notes ==
294
295 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.
296
297 == Issues specific to XWiki 7.4 ==
298
299 * Better backward-compatibility for URLs has been added for the following 2 cases:
300 ** 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
301 ** The ##view## action can be specified even when the wiki is configured to hide the ##view## action.
302 ** Note that this fixes [[some backward-compatibility issue introduced in XWiki 7.2>>ReleaseNotes.ReleaseNotesXWiki72||anchor="HURLs"]]
303
304 == API Breakages ==
305
306 The following APIs were modified since <project> <version - 1>:
307
308 {{code language="none"}}
309 <clirr output here>
310 {{/code}}

Get Connected