Version 27.1 by Sergiu Dumitriu on 2010/10/04

Show last authors
1 {{box cssClass="floatinginfobox" title="**Contents**"}}
2 {{toc/}}
3 {{/box}}
4
5 Second milestone of the XWiki Enterprise 2.5 version ([[Roadmap>>enterprise:Main.Roadmap]]).
6
7 The highlights of this release are: support for [[viewing attached office documents>>code:Macros.OfficeViewerMacro]] in the wiki, an experimental Extension Manager, experimental [[CSRF>>http://en.wikipedia.org/wiki/CSRF]] protection, further improvements to the edit UI, more consistent [[use of user avatars>>http://incubator.myxwiki.org/xwiki/bin/view/Improvements/Avatars]], and an experimental xwiki/2.1 wiki syntax.
8
9 = New and Noteworthy (since XWiki Enterprise 2.4) =
10
11 == Support for viewing attached office documents in the wiki ==
12
13 == Experimental Extension Manager ==
14
15 == Further improvements to the edit UI ==
16
17 == More image manipulation settings ==
18
19 For a long time it was possible to scale attached images on the server, thus reducing the download time and ensuring consistent scaling of images across browsers. This is achieved by appending ##width## and/or ##height## query string parameters to the URL of the image. This feature has been further enhanced:
20
21 * It is now possible to force the same aspect ratio of the original picture even when both width/height parameters were used (the ##keepAspectRatio## parameter).
22 * The size of the generated JPGs can be further tweaked by specifying an encoding ##quality## (the configurable default is at 30%, but will be changed to 50% before the final release). This does not affect lossless image formats such as PNG.
23 * The WYSIWYG editor also supports the width and height parameters, setting them as needed when manually resizing the image in the editor.
24
25 == Better handling of attachment versions when rolling back documents ==
26
27 Rolling back a document will also roll back the correct attachment version, including restoring a deleted attachment from the trash (if not manually deleted from there). Even if an attachment was deleted and re-uploaded several times, the platform will try to find the right version for the attachment, if it still exists in the attachment trash.
28
29 == Experimental xwiki/2.1 wiki syntax ==
30
31 The xwiki wiki syntax sees further improvements as xwiki/2.1, still in an experimental stage. A new feature is an enhanced syntax for links, which is more generic and allows easier extensions with new link types, demonstrated in this release with support for [[interwiki links>>http://en.wikipedia.org/wiki/Interwiki_links]].
32
33 Basic syntax:
34
35 {{code language="none"}}[[label>>referenceType:referenceData]]{{/code}}
36
37 Document references are still the implicit default, with the explicit ##doc:## reference type. The other standard reference types are ##url##, ##mailto##, ##attach##, ##image##, and the new ##interwiki##.
38
39 === [[Interwiki links>>http://en.wikipedia.org/wiki/Interwiki_links]] ===
40
41 Basic syntax:
42
43 {{code language="none"}}
44 [[label>>interwiki:wikiAlias:path/data]]
45 [[Interwiki links>>interwiki:wikipedia:Interwiki_links]]
46 {{/code}}
47
48 By default no sister wikis are defined. You can define some in ##xwiki.properties## by adding ##rendering.interWikiDefinitions## values:
49
50 {{code language="none"}}
51 rendering.interWikiDefinitions = wikipedia = http://en.wikipedia.org/wiki/
52 rendering.interWikiDefinitions = udic = http://www.urbandictionary.com/define.php?term=
53 {{/code}}
54
55 == Various Security improvements ==
56
57 Continuing a push for better security started this summer, 2.5M2 fixes some of the few remaining cross-site scripting and SQL injections holes, and tightens the scope of programming rights. Of particular concern:
58
59 * With a default skin, programming rights are no longer available after the main content of the page; this means that the panels and the bottom tabs can't use restricted APIs anymore.
60 * To explicitly drop programming rights, a new API method was introduced: ##$xcontext.dropPermissions()##
61 * An experimental Cross-Site Request Forgery prevention mechanism is included, though not enabled by default. To enable it and test/upgrade your custom applications for compatibility, edit ##xwiki.properties## and flip on the ##core.csrf.enabled## setting.
62
63 = Backward Compatibility and Migration Notes =
64
65 == General Notes ==
66
67 {{warning}}
68 If you're running in a multiwiki setup you'll also need to define the property //xwiki.store.migration.databases=all// to your //xwiki.cfg// file or explicitly name all databases to be migrated as in //xwiki.store.migration.databases=db1,db2,...//.
69 {{/warning}}
70
71 You may also want to [[import the default wiki XAR>>Main.Download]] in order to benefit from the improvements listed above.
72
73 {{warning}}
74 Always make sure you compare your //xwiki.cfg// file with the newest version since some configuration parameters were added. Note 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.
75 {{/warning}}
76
77 == API Breakages ==
78
79 The following APIs were modified since XWiki Enterprise 2.4:
80
81 {{code language="none"}}
82 [ERROR] org.xwiki.rendering.transformation.MacroTransformationContext: Method 'public org.xwiki.rendering.internal.transformation.MacroTransformation getMacroTransformation()' has been removed
83 [ERROR] org.xwiki.rendering.transformation.MacroTransformationContext: Method 'public void setMacroTransformation(org.xwiki.rendering.internal.transformation.MacroTransformation)' has been removed
84 [ERROR] org.xwiki.rendering.transformation.Transformation: Method 'public void transform(org.xwiki.rendering.block.Block, org.xwiki.rendering.transformation.TransformationContext)' has been added to an interface
85 [ERROR] org.xwiki.rendering.transformation.TransformationManager: Method 'public void performTransformations(org.xwiki.rendering.block.Block, org.xwiki.rendering.transformation.TransformationContext)' has been added to an interface
86 {{/code}}

Get Connected