Changes for page Release Notes for XWiki Enterprise 2.5
Last modified by Thomas Mortagne on 2017/03/24
Change comment:
There is no comment for this version
Summary
-
Page properties (1 modified, 0 added, 0 removed)
Details
- Page properties
-
- Content
-
... ... @@ -13,13 +13,13 @@ 13 13 == Improvements to Action Menus == 14 14 15 15 * New Add menu: Use the "Add" menu to create new spaces, pages, add attachments and comments.((( 16 -[[image:AddMenu.png||style="border:1px solid black;"]] 16 +[[image:AddMenu.png||style="border: 1px solid black;"]] 17 17 ))) 18 18 * Improved Wiki and Space menus: You may now access the document index straight from the wiki & space menus.((( 19 -[[image:WikiMenu.png||style="border:1px solid black;"]] [[image:SpaceMenu.png||style="border:1px solid black;"]] 19 +[[image:WikiMenu.png||style="border: 1px solid black;"]] [[image:SpaceMenu.png||style="border: 1px solid black;"]] 20 20 ))) 21 21 * New Page menu: Integrates the Watch, Copy, Rename and Delete actions.((( 22 -[[image:PageMenu.png||style="border:1px solid black;"]] 22 +[[image:PageMenu.png||style="border: 1px solid black;"]] 23 23 ))) 24 24 * The Edit, Export, More actions and Profile menus also benefited from a refresh. 25 25 ... ... @@ -26,6 +26,7 @@ 26 26 == Mechanism for inserting custom links in the header == 27 27 28 28 As a new part of the [[UI extensions>>dev:Design.InterfaceExtensions]] mechanism, similar to [[skin extensions>>code:Plugins.SkinExtensionsPlugin]], applications can now insert custom ##<link>## elements in the HTML header of the page, which allows to insert, for example: 29 + 29 29 * custom navigational links (universal edit, paged navigation, index, author...) 30 30 * custom RSS feed links 31 31 * custom metadata links (DOAP, FOAF, generic RDF...) ... ... @@ -32,8 +32,10 @@ 32 32 33 33 Usage example: 34 34 35 -{{code}}$xwiki.linkx.use($xwiki.getURL('Blog.BlogRss', 'view', "xpage=plain&blog=${blogDoc.fullName}"), 36 - {'rel' : 'alternate', 'type' : 'application/rss+xml', 'title' : $title}){{/code}} 36 +{{code}} 37 +$xwiki.linkx.use($xwiki.getURL('Blog.BlogRss', 'view', "xpage=plain&blog=${blogDoc.fullName}"), 38 + {'rel' : 'alternate', 'type' : 'application/rss+xml', 'title' : $title}) 39 +{{/code}} 37 37 38 38 == Introduced cancelable events == 39 39 ... ... @@ -45,56 +45,20 @@ 45 45 46 46 == Visible content menu when scrolling down == 47 47 48 -[[image:ActionMenu.png||style="border:1px solid black;"]] 51 +[[image:ActionMenu.png||style="border: 1px solid black;"]] 49 49 50 50 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. 51 51 52 52 == Introduced [[XWiki Cryptographic Module>>code:Modules.CryptographicModule]] == 56 + 53 53 This module exposes high level api, allowing developers to bolster their security using cryptography for both integrity and confidentiality. 54 54 You can find more information about the cryptographic module including examples at the code zone page for the [[XWiki Cryptographic Module>>code:Modules.CryptographicModule]]. 55 55 56 -= Known issues = 57 57 58 -= Backward Compatibility and Migration Notes = 59 59 60 -== General Notes == 61 61 62 -{{warning}} 63 -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,...//. 64 -{{/warning}} 65 65 66 -You may also want to [[import the default wiki XAR>>Main.Download]] in order to benefit from the improvements listed above. 67 67 68 -{{warning}} 69 -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. 70 -{{/warning}} 71 - 72 -== Migration Notes == 73 - 74 -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. 75 - 76 -=== Removed deprecated flickr plugin === 77 - 78 -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/]]. 79 - 80 -=== Update your web.xml === 81 - 82 -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. 83 - 84 -== API Breakages == 85 - 86 -The following APIs were modified since XWiki Enterprise 2.4: 87 - 88 -{{code language="none"}} 89 -[ERROR] org.xwiki.rendering.transformation.MacroTransformationContext: Method 'public org.xwiki.rendering.internal.transformation.MacroTransformation getMacroTransformation()' has been removed 90 -[ERROR] org.xwiki.rendering.transformation.MacroTransformationContext: Method 'public void setMacroTransformation(org.xwiki.rendering.internal.transformation.MacroTransformation)' has been removed 91 -[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 92 -[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 93 -{{/code}} 94 - 95 - 96 - 97 - 98 98 M2 99 99 100 100 Second milestone of the XWiki Enterprise 2.5 version ([[Roadmap>>enterprise:Main.Roadmap]]). ... ... @@ -111,13 +111,13 @@ 111 111 112 112 We also included a new Macro for the WYSIWYG Editor. It allows to embed a office file into a page. 113 113 114 -[[image:MacroOfficeViewer||style="border:1px solid black;"]] 81 +[[image:MacroOfficeViewer||style="border: 1px solid black;"]] 115 115 116 116 == Experimental Extension Manager == 117 117 118 118 The new Extension Manager will allow you to install new extensions to your XWiki XE. Please note that this is an experimental feature. Use it at your own risk. 119 119 120 -[[image:ExtensionManager.png||style="border:1px solid black;"]] 87 +[[image:ExtensionManager.png||style="border: 1px solid black;"]] 121 121 122 122 == New User Directory == 123 123 ... ... @@ -250,42 +250,9 @@ 250 250 * To explicitly drop programming rights, a new API method was introduced: ##$xcontext.dropPermissions()## 251 251 * 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. 252 252 253 -= Backward Compatibility and Migration Notes = 254 254 255 -== General Notes == 256 256 257 -{{warning}} 258 -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,...//. 259 -{{/warning}} 260 260 261 -You may also want to [[import the default wiki XAR>>Main.Download]] in order to benefit from the improvements listed above. 262 - 263 -{{warning}} 264 -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. 265 -{{/warning}} 266 - 267 -{{warning}} 268 -Experimental support 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 applications in most cases, but which might insert an extra validation step needed for actually saving the data. 269 -{{/warning}} 270 - 271 -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: 272 - 273 -{{code language="html"}} 274 -<input type="hidden" name="form_token" value="$!{services.csrf.getToken()}" /> 275 -{{/code}} 276 - 277 -== API Breakages == 278 - 279 -The following APIs were modified since XWiki Enterprise 2.4: 280 - 281 -{{code language="none"}} 282 -[ERROR] org.xwiki.rendering.transformation.MacroTransformationContext: Method 'public org.xwiki.rendering.internal.transformation.MacroTransformation getMacroTransformation()' has been removed 283 -[ERROR] org.xwiki.rendering.transformation.MacroTransformationContext: Method 'public void setMacroTransformation(org.xwiki.rendering.internal.transformation.MacroTransformation)' has been removed 284 -[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 285 -[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 286 -{{/code}} 287 - 288 - 289 289 RC1 290 290 291 291 ... ... @@ -348,32 +348,90 @@ 348 348 349 349 350 350 285 += Known issues = 351 351 287 += Backward Compatibility and Migration Notes = 352 352 289 +== Important non-compatible changes == 353 353 291 +== General Notes == 354 354 293 +{{warning}} 294 +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. 295 +{{/warning}} 355 355 297 += Known issues = 356 356 299 +* [[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]] 357 357 301 += Backward Compatibility and Migration Notes = 358 358 303 +== General Notes == 359 359 360 -{{ box cssClass="floatinginfobox" title="**Contents**"}}361 - {{toc/}}362 -{{/ box}}305 +{{warning}} 306 +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,...//. 307 +{{/warning}} 363 363 364 - =New andNoteworthy=309 +You may also want to [[import the default wiki XAR>>Main.Download]] in order to benefit from the improvements listed above. 365 365 366 -= Known issues = 311 +{{warning}} 312 +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. 313 +{{/warning}} 367 367 368 - * [[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]]315 +== Migration Notes == 369 369 370 - =BackwardCompatibility and MigrationNotes=317 +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. 371 371 372 -== Importantnon-compatible changes==319 +=== Removed deprecated flickr plugin === 373 373 321 +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/]]. 322 + 323 +=== Update your web.xml === 324 + 325 +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. 326 + 327 +== API Breakages == 328 + 329 +The following APIs were modified since XWiki Enterprise 2.4: 330 + 331 +{{code language="none"}} 332 +[ERROR] org.xwiki.rendering.transformation.MacroTransformationContext: Method 'public org.xwiki.rendering.internal.transformation.MacroTransformation getMacroTransformation()' has been removed 333 +[ERROR] org.xwiki.rendering.transformation.MacroTransformationContext: Method 'public void setMacroTransformation(org.xwiki.rendering.internal.transformation.MacroTransformation)' has been removed 334 +[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 335 +[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 336 +{{/code}} 337 + 338 += Backward Compatibility and Migration Notes = 339 + 374 374 == General Notes == 375 375 376 376 {{warning}} 377 - Alwaysmake sureyoucompareyour##xwiki.cfg##filewiththe newest version sincesomeconfigurationparameterswereadded.Noteyoushould add ##xwiki.store.migration=1##sothatXWikiwill attempttoautomaticallymigrateyourcurrentdatabase tothenew schema. Make sureyoubackup yourDatabaseeforedoing anything.343 +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,...//. 378 378 {{/warning}} 379 379 346 +You may also want to [[import the default wiki XAR>>Main.Download]] in order to benefit from the improvements listed above. 347 + 348 +{{warning}} 349 +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. 350 +{{/warning}} 351 + 352 +{{warning}} 353 +Experimental support 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 applications in most cases, but which might insert an extra validation step needed for actually saving the data. 354 +{{/warning}} 355 + 356 +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: 357 + 358 +{{code language="html"}} 359 +<input type="hidden" name="form_token" value="$!{services.csrf.getToken()}" /> 360 +{{/code}} 361 + 362 +== API Breakages == 363 + 364 +The following APIs were modified since XWiki Enterprise 2.4: 365 + 366 +{{code language="none"}} 367 +[ERROR] org.xwiki.rendering.transformation.MacroTransformationContext: Method 'public org.xwiki.rendering.internal.transformation.MacroTransformation getMacroTransformation()' has been removed 368 +[ERROR] org.xwiki.rendering.transformation.MacroTransformationContext: Method 'public void setMacroTransformation(org.xwiki.rendering.internal.transformation.MacroTransformation)' has been removed 369 +[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 370 +[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 371 +{{/code}}