Show last authors
1 {{box cssClass="floatinginfobox" title="**Contents**"}}
2 {{toc/}}
3 {{/box}}
5 Second milestone of the XWiki Enterprise 2.5 version ([[Roadmap>>enterprise:Main.Roadmap]]).
7 The highlights of this release are: support for [[viewing attached office documents>>code:Macros.OfficeMacro]] in the wiki, an experimental Extension Manager, experimental [[CSRF>>]] protection, further improvements to the edit UI, more consistent [[use of user avatars>>]], and an experimental xwiki/2.1 wiki syntax.
9 = New and Noteworthy (since XWiki Enterprise 2.4) =
11 == Support for viewing attached office documents in the wiki ==
13 == Experimental Extension Manager ==
15 == Further improvements to the edit UI ==
17 == More image manipulation settings ==
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:
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.
25 == Better handling of attachment versions when rolling back documents ==
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.
29 == Experimental xwiki/2.1 wiki syntax ==
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>>]].
33 Basic syntax:
35 {{code language="none"}}[[label>>referenceType:referenceData]]{{/code}}
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##.
39 === [[Interwiki links>>]] ===
41 Basic syntax:
43 {{code language="none"}}
44 [[label>>interwiki:wikiAlias:path/data]]
45 [[Interwiki links>>interwiki:wikipedia:Interwiki_links]]
46 {{/code}}
48 By default no sister wikis are defined. You can define some in by adding ##rendering.interWikiDefinitions## values:
50 {{code language="none"}}
51 rendering.interWikiDefinitions = wikipedia =
52 rendering.interWikiDefinitions = udic =
53 {{/code}}
55 == Various Security improvements ==
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:
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 and flip on the ##core.csrf.enabled## setting.
63 = Backward Compatibility and Migration Notes =
65 == General Notes ==
67 {{warning}}
68 If you're running in a multiwiki setup you'll also need to define the property // to your //xwiki.cfg// file or explicitly name all databases to be migrated as in //,db2,...//.
69 {{/warning}}
71 You may also want to [[import the default wiki XAR>>Main.Download]] in order to benefit from the improvements listed above.
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 // 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}}
77 == API Breakages ==
79 The following APIs were modified since XWiki Enterprise 2.4:
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