Version 18.3 by Sergiu Dumitriu on 2010/07/22

Hide last authors
Sergiu Dumitriu 3.1 1 = XWiki Enterprise 2.4 Release Notes =
Caleb James DeLisle 1.1 2
Silvia Macovei 15.1 3 {{box cssClass="floatinginfobox" title="**Contents**"}}
4 {{toc/}}
5 {{/box}}
Caleb James DeLisle 1.1 6
7 = New and Noteworthy =
8
Silvia Macovei 4.1 9 == Search ==
10
11 === Changed default search engine ===
12
13 Lucene Search is promoted as default search.
14
15 image:searchlucene.png
16
17 To read about the benefits of using Lucene search over Database search go to the [[search application page>>code:Applications.SearchApplication]].
18
19 Starting with the 2.4 release you can select the wikis where to search in using the LuceneSearch page.
20
21 [[image:wikiselection.png||style="border:1px solid black;"]]
22
23 === New search configuration UI ===
24
25 image:searchadministration.png
26
27 The Search Application now has a dedicated section in the wiki administration section from which you can:
28
29 * Choose the default engine (Lucene or Database).
30 * See the status for the Lucene Search: the number of indexed elements and the number of elements waiting in the queue.
31 * Control the Lucene index by indexing the whole farm, indexing the wiki or customizing the index to your specific preferences.
32
33 For more information check out the [[documentation page>>http://code.xwiki.org/xwiki/bin/view/Applications/SearchApplication]].
34
Silvia Macovei 6.1 35 == New Template-based page creation ==
36
37 Starting with XWiki Enterprise 2.4 users and applications can provide documents that can be used as template when creating new pages. The new document (content, objects and other metadata) will be replicated from the template.
38
39 * After you have [[created the template and the template provider>>code:Applications.AdministrationApplication#HEasyTemplatesCreationandAdministration28StartingwithXWikiEnterprise2.4M229]] you can then start creating pages from this template:
40
41 image:1gcreatedocument.jpg
42
43 * "Wanted Links" also offers the choice to create the new document from the available templates ( "My Template" template in the image below):
44
45 image:1ipopup.jpg
46
47 Find more details about the template creation and administration on the [[documentation page>>code:Applications.AdministrationApplication#HEasyTemplatesCreationandAdministration28StartingwithXWikiEnterprise2.4M229]].
48
49 == New Invitation Manager application ==
50
51 The Invitation Manager application allows users to send emails, inviting friends and colleagues to join a wiki. You will be able to configure your wiki to send emails through an open mail relay on the server or through an email account of your choosing.
52
53 image:InvitationSending.png
54
55 Read more about this application and learn how to configure it by visiting the [[application page>>code:Applications.InvitationApplication]].
56
Silvia Macovei 8.1 57 == WYSIWYG improvements ==
58
59 === Insert external image ===
60
61 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:
62
63 image:XWIKI-5202.png
64
65 === Insert macros ===
66
67 You may insert macros with a single click from the tool bar:
68
69 [[image:insertMacroFromToolBar.png]]
70
71 === Paste with filtered styles ===
72
73 A 'paste with filtered styles' button has also been added to the tool bar:
74
75 [[image:pasteIconOnToolBar.png]]
76
Silvia Macovei 10.1 77 The Wysiwyg editor import from office feature now filters style by default.
Silvia Macovei 8.1 78
Silvia Macovei 10.1 79 == Objects and classes editor improvements ==
80
81 The object and class editor are now fully panel-less, which among other things means that you have the full object/class editors UI even in an empty wiki without having to import the needed XE xar.
82
83 [[image:objecteditor.png||style="border:1px solid black;" width="500"]]
84
85 The class editor also adds better refactoring capabilities:
86
Silvia Macovei 16.3 87 * Reorder class properties
88 * Delete a class property
Silvia Macovei 10.1 89
90 [[image:classeditor.png||style="border:1px solid black;" width="500"]]
91
92 There are also many other small ergonomics improvements to discover !
93
Silvia Macovei 12.1 94 == JMX Administration Console ==
95
96 * XWiki is now using [[JMX to provide runtime Monitoring information>>platform:AdminGuide.Monitoring]].
97 * The first usage implemented is about monitoring the JBoss cachad and the Velocity Macro caches, as shown below:
98
99 image:platform:AdminGuide.Monitoring@jconsole1.png
100
101 == Watchlist improvements ==
102
103 * Allow to remove elements in the watchlist from the user profile
104 * Add in virtual mode, add a wikis section in "elements in your watchlist"
105
106 [[image:watchlist.png||style="border:1px solid black;"]]
107
Silvia Macovei 14.1 108 == Rendering cache ==
109
Silvia Macovei 16.2 110 You can now provide a list of pages for which to cache the result. See ##core.renderingcache.*## properties to control it.
Silvia Macovei 14.1 111
Silvia Macovei 16.2 112 It's also possible to force a page to refresh by using ##refresh=1## parameter in the URL.
Silvia Macovei 14.1 113
114 == New Code macro configuration ==
115
116 It's now possible to indicate which Pygments style to use with the default highlighter based on Pygments.
117
118 See http://code.xwiki.org/xwiki/bin/view/Macros/CodeMacro20 for more details.
119
120 == Security improvements ==
121
122 * Added support for HttpOnly flag for session cookies (XSS protection measure)
123 * Fixed some XSS issues
124 * Improved file access sandboxing
125
126 == Performance improvements ==
127
Silvia Macovei 16.3 128 * Defered scripts
Silvia Macovei 14.1 129
130 == Chart macro improvements ==
131
Silvia Macovei 16.3 132 * Chart macro now supports more than 26 columns.
Silvia Macovei 14.1 133
134 == Script improvements ==
135
136 * Make the Query Manager use the Script Service to expose services to scripts. See [[Query Guide>>platform:DevGuide.QueryGuide]] for more details.
137 * Make possible to directly return the Block based result of a script macro. It's supported for all JSR 223 macro which means all script macro script Velocity macro for now. See [[Script Macro>>code:Macros.ScriptMacro]] for more details.
138 * Prevent nested script macros by default: It's now impossible for the output of a script macro to become another script macro for security reasons. See [[Script Macro>>code:Macros.ScriptMacro]] for more details.
Silvia Macovei 15.1 139 * Provide a way to escape regexp literal string from velocity
140 {{code language="none"}}$regextool.quote("some[literal]text"){{/code}}
Silvia Macovei 14.1 141
142 == Javascript improvements ==
143
144 * Start writing a Javascript mirror of the XWiki data model: Document.getURL
145 * New "suggestDocuments" behavior for input fields
146
Silvia Macovei 16.1 147 == REST improvements ==
148
149 * Isolate REST API JAXB model classes in a separate module
150
Silvia Macovei 17.1 151 == Dependencies upgrade ==
152
153 * Doxia 1.1.3
154 * JODConverter 3.0 beta3
155 * JBossCache 3.2.5.GA
156 * Groovy 1.7.3
157 * Script.aculo.us 1.8.3
158 * Jython 2.5.2b1
159 * Hibernate Validator 4.0.2
160 * JGroups 2.8
161 * JFreeChart 1.0.13
162
Silvia Macovei 14.1 163 == Translations ==
164
165 * WYSIWYG newly supported language: Russian
166 * All the translations have been updated
167
Caleb James DeLisle 1.1 168 = Known issues =
169
Sergiu Dumitriu 18.3 170 * [[Bugs we know about>>http://jira.xwiki.org/jira/secure/IssueNavigator.jspa?reset=true&jqlQuery=category+in+%28%22XWiki.org+Top+Level+Projects%22%2C+%22XWiki+Plugins%2C+Applications+%26+Skins%22%29+AND+issuetype+%3D+Bug+AND+resolution+%3D+Unresolved+ORDER+BY+updated+DESC]]
Caleb James DeLisle 1.1 171
172 = Backward Compatibility and Migration Notes =
173
174 == Important non-compatible changes ==
175
Silvia Macovei 15.1 176 {{warning}}
Sergiu Dumitriu 18.1 177 ERROR: org.xwiki.bridge.DocumentAccessBridge: Method 'public void setCurrentUser(java.lang.String)' has been added to an interface
178 ERROR: org.xwiki.officeimporter.openoffice.OpenOfficeManager: Return type of method 'public net.sf.jodconverter.OfficeDocumentConverter getDocumentConverter()' has been changed to org.artofsolving.jodconverter.OfficeDocumentConverter
179 ERROR: org.xwiki.query.xwql.AliasGenerator: Class org.xwiki.query.xwql.AliasGenerator removed
180 ERROR: org.xwiki.query.xwql.InvalidQueryException: Class org.xwiki.query.xwql.InvalidQueryException removed
181 ERROR: org.xwiki.query.xwql.QueryAnalizer: Class org.xwiki.query.xwql.QueryAnalizer removed
182 ERROR: org.xwiki.query.xwql.QueryContext: Class org.xwiki.query.xwql.QueryContext removed
183 ERROR: org.xwiki.query.xwql.QueryContext$DocumentInfo: Class org.xwiki.query.xwql.QueryContext$DocumentInfo removed
184 ERROR: org.xwiki.query.xwql.QueryContext$ObjectInfo: Class org.xwiki.query.xwql.QueryContext$ObjectInfo removed
185 ERROR: org.xwiki.query.xwql.QueryContext$PropertyInfo: Class org.xwiki.query.xwql.QueryContext$PropertyInfo removed
186 ERROR: org.xwiki.query.xwql.QueryTranslator: Class org.xwiki.query.xwql.QueryTranslator removed
187 ERROR: org.xwiki.query.xwql.XWQLQueryExecutor: Class org.xwiki.query.xwql.XWQLQueryExecutor removed
188 ERROR: org.xwiki.query.xwql.hql.ObjectPrinter: Class org.xwiki.query.xwql.hql.ObjectPrinter removed
189 ERROR: org.xwiki.query.xwql.hql.Printer: Class org.xwiki.query.xwql.hql.Printer removed
190 ERROR: org.xwiki.query.xwql.hql.PropertyPrinter: Class org.xwiki.query.xwql.hql.PropertyPrinter removed
191 ERROR: org.xwiki.query.xwql.hql.TreePrinter: Class org.xwiki.query.xwql.hql.TreePrinter removed
192 ERROR: org.xwiki.query.xwql.hql.XWQLtoHQLTranslator: Class org.xwiki.query.xwql.hql.XWQLtoHQLTranslator removed
193 ERROR: org.xwiki.query.jpql.JPQLParser: Class org.xwiki.query.jpql.JPQLParser removed
194 ERROR: org.xwiki.velocity.VelocityEngine: Method 'public void clearMacroNamespace(java.lang.String)' has been added to an interface
195 ERROR: org.xwiki.velocity.VelocityEngine: Method 'public void startedUsingMacroNamespace(java.lang.String)' has been added to an interface
196 ERROR: org.xwiki.velocity.VelocityEngine: Method 'public void stoppedUsingMacroNamespace(java.lang.String)' has been added to an interface
197 ERROR: org.xwiki.model.ModelContext: Method 'public void setCurrentEntityReference(org.xwiki.model.reference.EntityReference)' has been added to an interface
198 ERROR: org.xwiki.rendering.scaffolding.RenderingTestCase: In method 'public RenderingTestCase(java.lang.String, java.lang.String, java.lang.String, java.lang.String, java.lang.String, boolean)' the number of arguments has changed
199 ERROR: org.xwiki.rendering.listener.DefaultAttachement: Class org.xwiki.rendering.listener.DefaultAttachement removed
200 ERROR: org.xwiki.rendering.transformation.MacroTransformationContext: Method 'public org.xwiki.rendering.internal.transformation.MacroTransformation getMacroTransformation()' has been removed
201 ERROR: org.xwiki.rendering.transformation.MacroTransformationContext: Method 'public void setMacroTransformation(org.xwiki.rendering.internal.transformation.MacroTransformation)' has been removed
202 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
203 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
204 ERROR: org.xwiki.rendering.macro.script.AbstractJSR223ScriptMacro: Method 'protected java.lang.String evaluate(org.xwiki.rendering.macro.script.JSR223ScriptMacroParameters, java.lang.String, org.xwiki.rendering.transformation.MacroTransformationContext)' has been removed
Silvia Macovei 15.1 205 {{/warning}}
Caleb James DeLisle 1.1 206
207 == General Notes ==
208
Silvia Macovei 15.1 209 {{warning}}
210 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.
211 {{/warning}}

Get Connected