Changes for page Release Notes for XWiki Enterprise 2.5
Last modified by Thomas Mortagne on 2017/03/24
Change comment:
Updated API breakages
Summary
-
Page properties (2 modified, 0 added, 0 removed)
Details
- Page properties
-
- Author
-
... ... @@ -1,1 +1,1 @@ 1 -XWiki. VincentMassol1 +XWiki.Sergiu - Content
-
... ... @@ -156,9 +156,9 @@ 156 156 157 157 == Experimental xwiki/2.1 wiki syntax == 158 158 159 -The xwiki wiki syntax sees further improvements as xwiki/2.1 is 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 path and [[interwiki links>>http://en.wikipedia.org/wiki/Interwiki_links]]. 159 +The xwiki wiki syntax sees further improvements as xwiki/2.1 is still in an experimental stage. A new feature is an enhanced syntax for links and images, which is more generic and allows easier extensions with new link types, demonstrated in this release with support for path and [[interwiki links>>http://en.wikipedia.org/wiki/Interwiki_links]]. 160 160 161 -Basic syntax: 161 +Basic syntax for links: 162 162 163 163 {{code language="none"}} 164 164 [[label>>referenceType:referenceData]] ... ... @@ -178,13 +178,29 @@ 178 178 {{velocity}}[[reset the history>>path:$doc.getURL('reset')||queryString="confirm=1"]]{{/velocity}} 179 179 {{/code}} 180 180 181 - {{info}}This syntaxis not enabled by default, youmust edit ##xwiki.cfg##and add it to the ##xwiki.rendering.syntaxes## setting to try it out.{{/info}}181 +Basic syntax for images: 182 182 183 +{{code language="none"}} 184 +image:referenceType:referenceData 185 +[[image:referenceType:referenceData||paramN=valueN]] 186 +{{/code}} 187 + 188 +{{info}} 189 +This syntax is not enabled by default, you must edit ##xwiki.cfg## and add it to the ##xwiki.rendering.syntaxes## setting to try it out. 190 +{{/info}} 191 + 183 183 === [[Interwiki links>>http://en.wikipedia.org/wiki/Interwiki_links]] === 184 184 185 -Basic syntax: 194 +Basic syntax for XWiki Syntax 2.0: 186 186 187 187 {{code language="none"}} 197 +[[label>>path@interwikiAlias]] 198 +[[Interwiki links>>Interwiki_links@wikipedia]] 199 +{{/code}} 200 + 201 +Basic syntax for XWiki Syntax 2.1: 202 + 203 +{{code language="none"}} 188 188 [[label>>interwiki:wikiAlias:path/data]] 189 189 [[Interwiki links>>interwiki:wikipedia:Interwiki_links]] 190 190 {{/code}} ... ... @@ -249,14 +249,28 @@ 249 249 250 250 == General Notes == 251 251 252 -{{warning}}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,...//.{{/warning}} 268 +{{warning}} 269 +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,...//. 270 +{{/warning}} 253 253 254 254 You may also want to [[import the default wiki XAR>>Main.Download]] in order to benefit from the improvements listed above. 255 255 256 -{{warning}}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.{{/warning}} 274 +{{warning}} 275 +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. 276 +{{/warning}} 257 257 258 - {{warning}}Experimentalsupport for CSRF protection is included in this release, although not enabled by default. This mechanism changes the way data is supposed to be saved, a change which will not completely break custom applicationsin mostcases,but which might insert an extra validation step needed for actually saving the data.{{/warning}}278 +== Migration Notes == 259 259 280 +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. 281 + 282 +=== Testing CSRF protection === 283 + 284 +An experimental support for CSRF protection is included in this release, although not enabled by default. 285 + 286 +{{warning}} 287 +This mechanism changes the way data is supposed to be saved, a change which will not completely break custom applications in most cases, but which might insert an extra validation step needed for actually saving the data. 288 +{{/warning}} 289 + 260 260 It is **strongly recommended** to set up a testing/development environment, enable this feature and fully test all the code. In most cases things should work with no additional changes. If the default edit mode is not used, or if the default velocity templates are not used, it should be enough to add the following line: 261 261 262 262 {{code language="html"}} ... ... @@ -263,10 +263,6 @@ 263 263 <input type="hidden" name="form_token" value="$!{services.csrf.getToken()}" /> 264 264 {{/code}} 265 265 266 -== Migration Notes == 267 - 268 -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. 269 - 270 270 === Removed deprecated flickr plugin === 271 271 272 272 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 the contrib-retired at this [[link>>http://svn.xwiki.org/svnroot/xwiki/contrib/retired/plugin-flickr/]]. ... ... @@ -280,8 +280,81 @@ 280 280 The following APIs were modified since XWiki Enterprise 2.4.4: 281 281 282 282 {{code language="none"}} 283 -[ERROR] org.xwiki.rendering.transformation.MacroTransformationContext: Method 'public org.xwiki.rendering.internal.transformation.MacroTransformation getMacroTransformation()' has been removed 284 -[ERROR] org.xwiki.rendering.transformation.MacroTransformationContext: Method 'public void setMacroTransformation(org.xwiki.rendering.internal.transformation.MacroTransformation)' has been removed 285 -[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 286 -[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 309 +[ERROR] org.xwiki.rendering.scaffolding.MockWikiModel: In method 'public java.lang.String getAttachmentURL(java.lang.String, java.lang.String)' the number of arguments has changed 310 +[ERROR] org.xwiki.rendering.scaffolding.MockWikiModel: In method 'public java.lang.String getDocumentEditURL(java.lang.String, java.lang.String, java.lang.String)' the number of arguments has changed 311 +[ERROR] org.xwiki.rendering.scaffolding.MockWikiModel: In method 'public java.lang.String getDocumentViewURL(java.lang.String, java.lang.String, java.lang.String)' the number of arguments has changed 312 +[ERROR] org.xwiki.rendering.scaffolding.MockWikiModel: Parameter 1 of 'public boolean isDocumentAvailable(java.lang.String)' has changed its type to org.xwiki.rendering.listener.reference.ResourceReference 313 +[ERROR] org.xwiki.rendering.scaffolding.RenderingTestSuite: In method 'public void addTestsFromResource(java.lang.String, boolean)' the number of arguments has changed 314 +[ERROR] org.xwiki.rendering.scaffolding.RenderingTestSuite: Method 'public void addTestsFromResource(java.lang.String, boolean, java.util.Map)' has been removed 315 +[ERROR] org.xwiki.rendering.macro.script.AbstractJSR223ScriptMacro: Method 'protected boolean canExecuteScript()' has been removed 316 +[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 317 +[ERROR] org.xwiki.rendering.macro.script.AbstractScriptMacro: Method 'protected boolean canHaveJarsParameters()' has been removed 318 +[ERROR] org.xwiki.rendering.macro.script.AbstractScriptMacro: Method 'protected java.lang.ClassLoader getClassLoader(java.lang.String, java.lang.ClassLoader)' has been removed 319 +[ERROR] org.xwiki.rendering.block.ImageBlock: Parameter 1 of 'public ImageBlock(org.xwiki.rendering.listener.Image, boolean)' has changed its type to org.xwiki.rendering.listener.reference.ResourceReference 320 +[ERROR] org.xwiki.rendering.block.ImageBlock: Parameter 1 of 'public ImageBlock(org.xwiki.rendering.listener.Image, boolean, java.util.Map)' has changed its type to org.xwiki.rendering.listener.reference.ResourceReference 321 +[ERROR] org.xwiki.rendering.block.ImageBlock: Method 'public org.xwiki.rendering.listener.Image getImage()' has been removed 322 +[ERROR] org.xwiki.rendering.block.LinkBlock: Parameter 2 of 'public LinkBlock(java.util.List, org.xwiki.rendering.listener.Link, boolean)' has changed its type to org.xwiki.rendering.listener.reference.ResourceReference 323 +[ERROR] org.xwiki.rendering.block.LinkBlock: Parameter 2 of 'public LinkBlock(java.util.List, org.xwiki.rendering.listener.Link, boolean, java.util.Map)' has changed its type to org.xwiki.rendering.listener.reference.ResourceReference 324 +[ERROR] org.xwiki.rendering.block.LinkBlock: Method 'public org.xwiki.rendering.listener.Link getLink()' has been removed 325 +[ERROR] org.xwiki.rendering.block.PlainTextBlockFilter: Parameter 2 of 'public PlainTextBlockFilter(org.xwiki.rendering.parser.Parser, org.xwiki.rendering.renderer.LinkLabelGenerator)' has changed its type to org.xwiki.rendering.renderer.reference.link.LinkLabelGenerator 326 +[ERROR] org.xwiki.rendering.configuration.RenderingConfiguration: Method 'public java.util.Properties getInterWikiDefinitions()' has been added to an interface 327 +[ERROR] org.xwiki.rendering.listener.AbstractImage: Class org.xwiki.rendering.listener.AbstractImage removed 328 +[ERROR] org.xwiki.rendering.listener.Attachment: Class org.xwiki.rendering.listener.Attachment removed 329 +[ERROR] org.xwiki.rendering.listener.CompositeListener: Parameter 1 of 'public void beginLink(org.xwiki.rendering.listener.Link, boolean, java.util.Map)' has changed its type to org.xwiki.rendering.listener.reference.ResourceReference 330 +[ERROR] org.xwiki.rendering.listener.CompositeListener: Parameter 1 of 'public void endLink(org.xwiki.rendering.listener.Link, boolean, java.util.Map)' has changed its type to org.xwiki.rendering.listener.reference.ResourceReference 331 +[ERROR] org.xwiki.rendering.listener.CompositeListener: Parameter 1 of 'public void onImage(org.xwiki.rendering.listener.Image, boolean, java.util.Map)' has changed its type to org.xwiki.rendering.listener.reference.ResourceReference 332 +[ERROR] org.xwiki.rendering.listener.DefaultAttachment: Class org.xwiki.rendering.listener.DefaultAttachment removed 333 +[ERROR] org.xwiki.rendering.listener.DocumentImage: Class org.xwiki.rendering.listener.DocumentImage removed 334 +[ERROR] org.xwiki.rendering.listener.Image: Class org.xwiki.rendering.listener.Image removed 335 +[ERROR] org.xwiki.rendering.listener.ImageListener: Parameter 1 of 'public void onImage(org.xwiki.rendering.listener.Image, boolean, java.util.Map)' has changed its type to org.xwiki.rendering.listener.reference.ResourceReference 336 +[ERROR] org.xwiki.rendering.listener.ImageType: Class org.xwiki.rendering.listener.ImageType removed 337 +[ERROR] org.xwiki.rendering.listener.Link: Class org.xwiki.rendering.listener.Link removed 338 +[ERROR] org.xwiki.rendering.listener.LinkListener: Parameter 1 of 'public void beginLink(org.xwiki.rendering.listener.Link, boolean, java.util.Map)' has changed its type to org.xwiki.rendering.listener.reference.ResourceReference 339 +[ERROR] org.xwiki.rendering.listener.LinkListener: Parameter 1 of 'public void endLink(org.xwiki.rendering.listener.Link, boolean, java.util.Map)' has changed its type to org.xwiki.rendering.listener.reference.ResourceReference 340 +[ERROR] org.xwiki.rendering.listener.LinkType: Class org.xwiki.rendering.listener.LinkType removed 341 +[ERROR] org.xwiki.rendering.listener.QueueListener: Parameter 1 of 'public void beginLink(org.xwiki.rendering.listener.Link, boolean, java.util.Map)' has changed its type to org.xwiki.rendering.listener.reference.ResourceReference 342 +[ERROR] org.xwiki.rendering.listener.QueueListener: Parameter 1 of 'public void endLink(org.xwiki.rendering.listener.Link, boolean, java.util.Map)' has changed its type to org.xwiki.rendering.listener.reference.ResourceReference 343 +[ERROR] org.xwiki.rendering.listener.QueueListener: Parameter 1 of 'public void onImage(org.xwiki.rendering.listener.Image, boolean, java.util.Map)' has changed its type to org.xwiki.rendering.listener.reference.ResourceReference 344 +[ERROR] org.xwiki.rendering.listener.URLImage: Class org.xwiki.rendering.listener.URLImage removed 345 +[ERROR] org.xwiki.rendering.listener.WrappingListener: Parameter 1 of 'public void beginLink(org.xwiki.rendering.listener.Link, boolean, java.util.Map)' has changed its type to org.xwiki.rendering.listener.reference.ResourceReference 346 +[ERROR] org.xwiki.rendering.listener.WrappingListener: Parameter 1 of 'public void endLink(org.xwiki.rendering.listener.Link, boolean, java.util.Map)' has changed its type to org.xwiki.rendering.listener.reference.ResourceReference 347 +[ERROR] org.xwiki.rendering.listener.WrappingListener: Parameter 1 of 'public void onImage(org.xwiki.rendering.listener.Image, boolean, java.util.Map)' has changed its type to org.xwiki.rendering.listener.reference.ResourceReference 348 +[ERROR] org.xwiki.rendering.listener.chaining.AbstractChainingListener: Parameter 1 of 'public void beginLink(org.xwiki.rendering.listener.Link, boolean, java.util.Map)' has changed its type to org.xwiki.rendering.listener.reference.ResourceReference 349 +[ERROR] org.xwiki.rendering.listener.chaining.AbstractChainingListener: Parameter 1 of 'public void endLink(org.xwiki.rendering.listener.Link, boolean, java.util.Map)' has changed its type to org.xwiki.rendering.listener.reference.ResourceReference 350 +[ERROR] org.xwiki.rendering.listener.chaining.AbstractChainingListener: Parameter 1 of 'public void onImage(org.xwiki.rendering.listener.Image, boolean, java.util.Map)' has changed its type to org.xwiki.rendering.listener.reference.ResourceReference 351 +[ERROR] org.xwiki.rendering.listener.chaining.BlockStateChainingListener: Parameter 1 of 'public void beginLink(org.xwiki.rendering.listener.Link, boolean, java.util.Map)' has changed its type to org.xwiki.rendering.listener.reference.ResourceReference 352 +[ERROR] org.xwiki.rendering.listener.chaining.BlockStateChainingListener: Parameter 1 of 'public void endLink(org.xwiki.rendering.listener.Link, boolean, java.util.Map)' has changed its type to org.xwiki.rendering.listener.reference.ResourceReference 353 +[ERROR] org.xwiki.rendering.listener.chaining.BlockStateChainingListener: Parameter 1 of 'public void onImage(org.xwiki.rendering.listener.Image, boolean, java.util.Map)' has changed its type to org.xwiki.rendering.listener.reference.ResourceReference 354 +[ERROR] org.xwiki.rendering.listener.chaining.ConsecutiveNewLineStateChainingListener: Parameter 1 of 'public void endLink(org.xwiki.rendering.listener.Link, boolean, java.util.Map)' has changed its type to org.xwiki.rendering.listener.reference.ResourceReference 355 +[ERROR] org.xwiki.rendering.listener.chaining.ConsecutiveNewLineStateChainingListener: Parameter 1 of 'public void onImage(org.xwiki.rendering.listener.Image, boolean, java.util.Map)' has changed its type to org.xwiki.rendering.listener.reference.ResourceReference 356 +[ERROR] org.xwiki.rendering.listener.chaining.EmptyBlockChainingListener: Parameter 1 of 'public void beginLink(org.xwiki.rendering.listener.Link, boolean, java.util.Map)' has changed its type to org.xwiki.rendering.listener.reference.ResourceReference 357 +[ERROR] org.xwiki.rendering.listener.chaining.EmptyBlockChainingListener: Parameter 1 of 'public void endLink(org.xwiki.rendering.listener.Link, boolean, java.util.Map)' has changed its type to org.xwiki.rendering.listener.reference.ResourceReference 358 +[ERROR] org.xwiki.rendering.listener.chaining.EmptyBlockChainingListener: Parameter 1 of 'public void onImage(org.xwiki.rendering.listener.Image, boolean, java.util.Map)' has changed its type to org.xwiki.rendering.listener.reference.ResourceReference 359 +[ERROR] org.xwiki.rendering.listener.chaining.LookaheadChainingListener: Parameter 1 of 'public void beginLink(org.xwiki.rendering.listener.Link, boolean, java.util.Map)' has changed its type to org.xwiki.rendering.listener.reference.ResourceReference 360 +[ERROR] org.xwiki.rendering.listener.chaining.LookaheadChainingListener: Parameter 1 of 'public void endLink(org.xwiki.rendering.listener.Link, boolean, java.util.Map)' has changed its type to org.xwiki.rendering.listener.reference.ResourceReference 361 +[ERROR] org.xwiki.rendering.listener.chaining.LookaheadChainingListener: Parameter 1 of 'public void onImage(org.xwiki.rendering.listener.Image, boolean, java.util.Map)' has changed its type to org.xwiki.rendering.listener.reference.ResourceReference 362 +[ERROR] org.xwiki.rendering.listener.chaining.TextOnNewLineStateChainingListener: Parameter 1 of 'public void beginLink(org.xwiki.rendering.listener.Link, boolean, java.util.Map)' has changed its type to org.xwiki.rendering.listener.reference.ResourceReference 363 +[ERROR] org.xwiki.rendering.listener.chaining.TextOnNewLineStateChainingListener: Parameter 1 of 'public void endLink(org.xwiki.rendering.listener.Link, boolean, java.util.Map)' has changed its type to org.xwiki.rendering.listener.reference.ResourceReference 364 +[ERROR] org.xwiki.rendering.listener.chaining.TextOnNewLineStateChainingListener: Parameter 1 of 'public void onImage(org.xwiki.rendering.listener.Image, boolean, java.util.Map)' has changed its type to org.xwiki.rendering.listener.reference.ResourceReference 365 +[ERROR] org.xwiki.rendering.parser.AttachmentParser: Class org.xwiki.rendering.parser.AttachmentParser removed 366 +[ERROR] org.xwiki.rendering.parser.ImageParser: Class org.xwiki.rendering.parser.ImageParser removed 367 +[ERROR] org.xwiki.rendering.parser.LinkParser: Class org.xwiki.rendering.parser.LinkParser removed 368 +[ERROR] org.xwiki.rendering.renderer.LinkLabelGenerator: Class org.xwiki.rendering.renderer.LinkLabelGenerator removed 369 +[ERROR] org.xwiki.rendering.renderer.LinkReferenceSerializer: Class org.xwiki.rendering.renderer.LinkReferenceSerializer removed 370 +[ERROR] org.xwiki.rendering.renderer.URILabelGenerator: Class org.xwiki.rendering.renderer.URILabelGenerator removed 371 +[ERROR] org.xwiki.rendering.renderer.XWikiSyntaxListenerChain: Class org.xwiki.rendering.renderer.XWikiSyntaxListenerChain removed 372 +[ERROR] org.xwiki.rendering.renderer.xhtml.XHTMLImageRenderer: Class org.xwiki.rendering.renderer.xhtml.XHTMLImageRenderer removed 373 +[ERROR] org.xwiki.rendering.renderer.xhtml.XHTMLLinkRenderer: Class org.xwiki.rendering.renderer.xhtml.XHTMLLinkRenderer removed 374 +[ERROR] org.xwiki.rendering.wiki.WikiModel: In method 'public java.lang.String getAttachmentURL(java.lang.String, java.lang.String)' the number of arguments has changed 375 +[ERROR] org.xwiki.rendering.wiki.WikiModel: In method 'public java.lang.String getDocumentEditURL(java.lang.String, java.lang.String, java.lang.String)' the number of arguments has changed 376 +[ERROR] org.xwiki.rendering.wiki.WikiModel: In method 'public java.lang.String getDocumentViewURL(java.lang.String, java.lang.String, java.lang.String)' the number of arguments has changed 377 +[ERROR] org.xwiki.rendering.wiki.WikiModel: Method 'public java.lang.String getImageURL(org.xwiki.rendering.listener.reference.ResourceReference, java.util.Map)' has been added to an interface 378 +[ERROR] org.xwiki.rendering.wiki.WikiModel: Parameter 1 of 'public boolean isDocumentAvailable(java.lang.String)' has changed its type to org.xwiki.rendering.listener.reference.ResourceReference 379 +[ERROR] org.xwiki.bridge.DocumentAccessBridge: Method 'public java.lang.String getAttachmentURL(org.xwiki.model.reference.AttachmentReference, java.lang.String, boolean)' has been added to an interface 380 +[ERROR] org.xwiki.bridge.DocumentAccessBridge: Method 'public java.lang.String getAttachmentVersion(org.xwiki.model.reference.AttachmentReference)' has been added to an interface 381 +[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 382 +[ERROR] org.xwiki.annotation.renderer.AbstractAnnotationRenderer: Return type of method 'public org.xwiki.rendering.renderer.LinkLabelGenerator getLinkLabelGenerator()' has been changed to org.xwiki.rendering.renderer.reference.link.LinkLabelGenerator 383 +[ERROR] org.xwiki.annotation.renderer.LinkLabelGeneratorChainingListener: Changed type of field linkLabelGenerator from org.xwiki.rendering.renderer.LinkLabelGenerator to org.xwiki.rendering.renderer.reference.link.LinkLabelGenerator 384 +[ERROR] org.xwiki.annotation.renderer.LinkLabelGeneratorChainingListener: Parameter 1 of 'public LinkLabelGeneratorChainingListener(org.xwiki.rendering.renderer.LinkLabelGenerator, org.xwiki.rendering.parser.StreamParser, org.xwiki.rendering.listener.chaining.ListenerChain)' has changed its type to org.xwiki.rendering.renderer.reference.link.LinkLabelGenerator 385 +[ERROR] org.xwiki.annotation.renderer.LinkLabelGeneratorChainingListener: Parameter 1 of 'public void endLink(org.xwiki.rendering.listener.Link, boolean, java.util.Map)' has changed its type to org.xwiki.rendering.listener.reference.ResourceReference 287 287 {{/code}}