Changes for page Release Notes for XWiki Enterprise 3.0
Last modified by Thomas Mortagne on 2023/10/13
Change comment:
There is no comment for this version
Summary
-
Page properties (2 modified, 0 added, 0 removed)
Details
- Page properties
-
- Author
-
... ... @@ -1,1 +1,1 @@ 1 -XWiki. Caleb_James_DeLisle1 +XWiki.lucaa - Content
-
... ... @@ -7,6 +7,7 @@ 7 7 {{/box}} 8 8 9 9 This is the first release of the [[3.x>>enterprise:Main.Roadmap]] [[cycle>>dev:Community.VersioningAndReleasePractices#HReleaseCyclesandReleaseStrategy]]. Conforming to the [[general themes of the 3.x cycle>>enterprise:Main.Roadmap#HXWikiEnterprise3.xCycle]], a lot of features have been polished and improved, and a few new features have been introduced as well. The highlights of this release are: 10 + 10 10 * Twitter-like **messaging and networking** inside the wiki, 11 11 * a new **filesystem storage for attachments** which allows huge attachments to be uploaded without requiring a lot of memory or database storage, 12 12 * **improved dashboard editing**, ... ... @@ -16,6 +16,7 @@ 16 16 * a new UI for **changing user avatars**. 17 17 18 18 On the developers' front, we've made it easier to reuse the XWiki rendering engine outside our own codebase, by extracting two new top level projects: 20 + 19 19 * XWiki Commons, holding generic modules not tied to the rest of the platform, 20 20 * XWiki Rendering, holding all the XWiki-independent modules of the rendering engine. 21 21 ... ... @@ -148,6 +148,7 @@ 148 148 ))) 149 149 150 150 The maximum attachment size will still be bounded by a configuration parameter so if you want to start attaching mega huge attachments right away, logged in as an administrator, open the ##{{{<your site>/xwiki/bin/edit/XWiki/XWikiPreferences?editor=object}}}## page and scroll down until you find ##Maximum Upload Size##, and change that number to something huge like: ##999999999999##. Then click save at the bottom of the page. 153 + 151 151 * Numbers that are too large cannot be parsed but the one above is known to be small enough. You will just have to live with only attachments smaller than a petabyte. 152 152 153 153 If you have an existing wiki and you want to start taking advantage of the attachment store, you can use the [[extensions:Extension.Filesystem Attachment Porter]] to move the attachments over to the filesystem. The description of the porter also contains more information about filesystem attachment storage in general so reading the page is recommended even if you don't need it. ... ... @@ -259,7 +259,6 @@ 259 259 260 260 Suppose you had a macro like this: 261 261 262 - 263 263 {{code language="none"}} 264 264 #macro(isBlogGlobal $blogDoc $isGlobal) 265 265 #set($isGlobal = false) ... ... @@ -270,6 +270,7 @@ 270 270 #end 271 271 {{/code}} 272 272 275 + 273 273 Here ##$isGlobal## is the output variable which now doesn't always work. The updated version of the macro can be written as: 274 274 275 275 {{code language="none"}} ... ... @@ -321,12 +321,18 @@ 321 321 322 322 === Update dashboard macro calls === 323 323 324 -Because of the implementation of [[XWIKI-5938>>http://jira.xwiki.org/jira/browse/XWIKI-5938]], when upgrading from 2.x to 3.0, if the dashboard macro was used in its form from 2.5 (with the macro calls in the source of the page), it needs to be manually converted to the objects form. 327 +Because of the implementation of [[XWIKI-5938>>http://jira.xwiki.org/jira/browse/XWIKI-5938]], when upgrading from 2.x to 3.0, if the dashboard macro was used in its form from 2.5 (with the macro calls in the source of the page), it needs to either be manually converted to the objects form (if you want to benefit from all the dashboard improvements described above) either be converted it to a simple container macro with columns layout if the focus is column layouting of content. 325 325 326 -{{todo}} 327 -Anca, please give more details about the update steps. 328 -{{/todo}} 329 +The steps to take are: 329 329 331 +* if you want to benefit from all the dashboard improvements\\ 332 +*1. remove the content of the dashboard macro 333 +*1. use the visual dashboard editor (as described above) to add the gadgets you need on the dashboard. If you need advanced content, such as custom scripts, etc, you can also use the objects editor for the current page to edit the ##XWiki.GadgetClass## objects attached to the page. 334 +* if you only need columns layout content\\ 335 +*1. modify the ##~{~{dashboard}}## macro call to a ##~{~{container layoutStyle="columns"}}## macro call, leaving the same content in the macro. 336 + 337 +Note that the default Main.WebHome page distributed in XWiki Enterprise contains a dashboard, so if you upgraded XE and didn't upgrade this page, you'll need to manually upgrade that dashboard or manually merge it with the one from the 3.0 version. 338 + 330 330 === Update web.xml === 331 331 332 332 Due to the package rename done for [[XWIKI-6158>>http://jira.xwiki.org/jira/browse/XWIKI-6158]] when upgrading from 2.x to 3.0 you must edit your ##web.xml## file and replace all occurrences of ##com.xpn.xwiki.wysiwyg## with ##org.xwiki.wysiwyg##. ... ... @@ -342,7 +342,7 @@ 342 342 * ##notification_pages## - mechanism for registering ##xwiki/1.0## documents containing Groovy code as notification listeners; both the syntax and the notification mechanism are deprecated, consider rewriting these listeners as components 343 343 * ##pageWidth## - unused customization for the layout of the skin, an early experiment for the old ##finch## skin, never fully used or exposed 344 344 * ##renderXWikiGroovyRenderer##, ##renderXWikiRadeoxRenderer##, ##renderXWikiVelocityRenderer## - customizations for the ##xwiki/1.0## rendering process 345 -* ##webbgcolor## - old setting for the extinct ##dodo## skin 354 +* ##webbgcolor## - old setting for the extinct ##dodo## skin~{~{/dashboard}} 346 346 347 347 == API Breakages == 348 348