Last modified by Thomas Mortagne on 2023/10/13

Show last authors
1 {{box cssClass="floatinginfobox" title="**Contents**"}}
2 {{toc/}}
3 {{/box}}
4
5 First milestone of the XWiki Enterprise 2.5 version ([[Roadmap>>Main.Roadmap]]).
6
7 The highlights of this release are: improvements to action menus, a mechanism for inserting custom links in the header, the introduction of cancelable events and better external search engine indexing support.
8
9 = New and Noteworthy (since XWiki Enterprise 2.4) =
10
11 == Improvements to Action Menus ==
12
13 * New Add menu: Use the "Add" menu to create new spaces, pages, add attachments and comments.(((
14 [[image:AddMenu.png||style="border:1px solid black;"]]
15 )))
16 * Improved Wiki and Space menus: You may now access the document index straight from the wiki & space menus.(((
17 [[image:WikiMenu.png||style="border:1px solid black;"]] [[image:SpaceMenu.png||style="border:1px solid black;"]]
18 )))
19 * New Page menu: Integrates the Watch, Copy, Rename and Delete actions.(((
20 [[image:PageMenu.png||style="border:1px solid black;"]]
21 )))
22 * The Edit, Export, More actions and Profile menus also benefited from a refresh.
23
24 == Mechanism for inserting custom links in the header ==
25
26 As a new part of the [[UI extensions>>dev:Design.InterfaceExtensions]] mechanism, similar to [[skin extensions>>extensions:Extension.Skin Extension Plugin]], applications can now insert custom ##<link>## elements in the HTML header of the page, which allows to insert, for example:
27 * custom navigational links (universal edit, paged navigation, index, author...)
28 * custom RSS feed links
29 * custom metadata links (DOAP, FOAF, generic RDF...)
30
31 Usage example:
32
33 {{code}}$xwiki.linkx.use($xwiki.getURL('Blog.BlogRss', 'view', "xpage=plain&blog=${blogDoc.fullName}"),
34 {'rel' : 'alternate', 'type' : 'application/rss+xml', 'title' : $title}){{/code}}
35
36 == Introduced cancelable events ==
37
38 This allows to cancel document saving, better security with script execution and canceling an event that has errors on initialization.
39
40 == Better external search engine indexing support ==
41
42 Google search results now always point to canonical view of pages.
43
44 == Visible content menu when scrolling down ==
45
46 [[image:ActionMenu.png||style="border:1px solid black;"]]
47
48 When scrolling down on a document, the content menu will follow, so the user will not have to scroll up on top of the page in order to access it.
49
50 == Introduced [[XWiki Cryptographic Module>>extensions:Extension.Cryptographic Module]] ==
51 This module exposes high level api, allowing developers to bolster their security using cryptography for both integrity and confidentiality.
52 You can find more information about the cryptographic module including examples at the code zone page for the [[XWiki Cryptographic Module>>extensions:Extension.Cryptographic Module]].
53
54 = Known issues =
55
56 = Backward Compatibility and Migration Notes =
57
58 == General Notes ==
59
60 {{warning}}
61 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,...//.
62 {{/warning}}
63
64 You may also want to [[import the default wiki XAR>>Main.Download]] in order to benefit from the improvements listed above.
65
66 {{warning}}
67 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.
68 {{/warning}}
69
70 == Migration Notes ==
71
72 The main entry point for the search UI is now the Main.Search page that will use the configured search engine (Lucene by default). If you want to refer to Lucene or Database search explicitly you can use the ##Main.LuceneSearch## and ##Main.DatabaseSearch## pages. Note that nothing is broken here (##Main.WebSearch## page is still there and internally it includes the ##Main.DatabaseSearch## page), it's just the new clean way of targeting the search page.
73
74 === Removed deprecated flickr plugin ===
75
76 The old flickr plugin was outdated and the API was broken, so, as a consequence, it has been removed. A new plugin will be available in the future. Meanwhile you can still find it in {{scm user="xwiki-contrib" project="retired" path="plugin-flickr"}}the contrib-retired repository{{/scm}}.
77
78 === Update your web.xml ===
79
80 Some servlet filters (SetCharacterEncodingFilter, used to handle character encoding and SavedRequestRestorerFilter, used to restore requests on login) were refactored and moved to another package. Make sure you update your //WEB-INF/web.xml// to the current version, otherwise XWiki server will fail to start.
81
82 == API Breakages ==
83
84 The following APIs were modified since XWiki Enterprise 2.4:
85
86 {{code language="none"}}
87 [ERROR] org.xwiki.rendering.macro.script.AbstractJSR223ScriptMacro: Method 'protected boolean canExecuteScript()' has been removed
88 [ERROR] org.xwiki.rendering.macro.script.AbstractJSR223ScriptMacro: Method 'public java.util.List execute(org.xwiki.rendering.macro.script.JSR223ScriptMacroParameters, java.lang.String, org.xwiki.rendering.transformation.MacroTransformationContext)' has been removed
89 [ERROR] org.xwiki.rendering.macro.script.AbstractScriptMacro: Method 'protected boolean canHaveJarsParameters()' has been removed
90 [ERROR] org.xwiki.rendering.macro.script.AbstractScriptMacro: Method 'protected java.lang.ClassLoader getClassLoader(java.lang.String, java.lang.ClassLoader)' has been removed
91 [ERROR] org.xwiki.bridge.DocumentAccessBridge: Method 'public java.lang.String getDocumentURL(org.xwiki.model.reference.DocumentReference, java.lang.String, java.lang.String, java.lang.String, boolean)' has been added to an interface
92 {{/code}}

Get Connected