Show last authors
author | version | line-number | content |
---|---|---|---|
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}} |