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.4 version ([[Roadmap>>Main.Roadmap]]).
6
7 The highlights of this release are: Lucene by default and Lucene admin, rendering cache as well as performances and security improvements.
8
9 = New and Noteworthy (since XWiki Enterprise 2.3.1) =
10
11 == Search ==
12
13 === Changed default search engine ===
14
15 Lucene Search is promoted as default search.
16
17 image:searchlucene.png
18
19 The Lucene search has several benefits over the Database search:
20
21 * It indexes attachments (such as PDFs or MS Word documents) searchable. It does not replace the search page itself but rather makes more content available for searching.
22 * It provides a scoring for the search results.
23 * It offers pagination when there are lots of results.
24 * It scales well when there are lots of documents in the wiki.
25 * It supports multi wikis.
26 * It supports a strong query syntax.
27
28 === New search configuration UI ===
29
30 image:searchadministration.png
31
32 The Search Application now has a dedicated section in the wiki administration section from which you can:
33
34 * Choose the default engine (Lucene or Database).
35 * See the status for the Lucene Search: the number of indexed elements and the number of elements waiting in the queue.
36 * Control the Lucene index by indexing the whole farm, indexing the wiki or customizing the index to your specific preferences.
37
38 For more information check out the [[documentation page>>http://code.xwiki.org/xwiki/bin/view/Applications/SearchApplication]].
39
40 == Rendering cache ==
41
42 You can now provide a list of pages for which to cache the result. See ##core.renderingcache.*## properties to control it.
43
44 It's also possible to force a page to refresh by using ##refresh=1## parameter in the URL.
45
46 == WYSIWYG improvements ==
47
48 === Insert external image ===
49
50 You can now insert an external image in the edited page while in WYSIWYG mode. The external image is specified by its location on the web, i.e. its URL. To do this go to Image > Insert Image... menu and select the "External" tab:
51
52 image:XWIKI-5202.png
53
54 == New Code macro configuration ==
55
56 It's now possible to indicate which Pygments style to use with the default highlighter based on Pygments.
57
58 See http://code.xwiki.org/xwiki/bin/view/Macros/CodeMacro20 for more details.
59
60 == Security improvements ==
61
62 * Added support for HttpOnly flag for session cookies (XSS protection measure)
63 * Fixed some XSS issues
64 * Improved file access sandboxing
65
66 == Performance improvements ==
67
68 Defered scripts.
69
70 == Chart macro improvements ==
71
72 Chart macro now support more than 26 columns.
73
74 == Translations ==
75
76 * WYSIWYG newly supported language: Russian
77 * All the translations have been updated
78
79 = Known issues =
80
81 * [[Bugs we know about>>https://jira.xwiki.org/secure/IssueNavigator.jspa?reset=true&&type=1&pid=10010&resolution=-1&sorter/field=updated&sorter/order=DESC]]
82
83 = Backward Compatibility and Migration Notes =
84
85 == General Notes ==
86
87 {{warning}}
88 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,...//.
89 {{/warning}}
90
91 You may also want to [[import the default wiki XAR>>Main.Download]] in order to benefit from the improvements listed above.
92
93 {{warning}}
94 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.
95 {{/warning}}
96
97 == Migration Notes ==
98
99 * 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.
100
101 == API Breakages ==
102
103 The following APIs were modified since XWiki Enterprise 2.3:
104
105 {{code language="none"}}
106 [ERROR] org.xwiki.rendering.transformation.MacroTransformationContext: Method 'public org.xwiki.rendering.internal.transformation.MacroTransformation getMacroTransformation()' has been removed
107 [ERROR] org.xwiki.rendering.transformation.MacroTransformationContext: Method 'public void setMacroTransformation(org.xwiki.rendering.internal.transformation.MacroTransformation)' has been removed
108 [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
109 [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
110 {{/code}}

Get Connected