<
From version < 23.1 >
edited by Thomas Mortagne
on 2010/01/16
To version < 24.1 >
edited by Sergiu Dumitriu
on 2010/01/17
>
Change comment: Several updates

Summary

Details

Page properties
Author
... ... @@ -1,1 +1,1 @@
1 -XWiki.ThomasMortagne
1 +XWiki.Sergiu
Content
... ... @@ -1,27 +1,38 @@
1 1  {{box cssClass="floatinginfobox" title="**Contents**"}}{{toc/}}{{/box}}
2 2  
3 -First milestone of the XWiki Enterprise 2.2 version ([[Roadmap>>enterprise:Main.Roadmap]]).
3 +First milestone of the XWiki Enterprise 2.2 version ([[Roadmap>>enterprise:Main.Roadmap]]).
4 4  
5 -This release mainly introduces new Model, the possibility to register wiki macros for any user or wiki and many improvements of xar import.
5 +The highlights of this release are: the possibility to register wiki macros for any user or wiki, improvements of the import interface, support for OOXML (MS Office 2007) documents in the office import feature, started introducing the new Model, new UIs for viewing the contents of the document and attachment trash, and further improvements towards UI consistency and accessibility.
6 6  
7 7  = New and Noteworthy (since XWiki Enterprise 2.1.1) =
8 8  
9 9  == Contextual wikimacros ==
10 10  
11 -It's now possible for any user to register wiki macro anywhere and in any wiki.
11 +Previously, [[wiki macros>>platform:DevGuide.WikiMacroTutorial]] could only be defined by users with administrator rights, and only in the main wiki (when in a virtual wiki farm). It's now possible for any user to register wiki macros, and in any wiki. However, this follows some user rights restrictions, preventing a limited user to write dangerous scripts available to all other users. For example, if the user does not have the proper rights, only he will see and use the macro he registered. To make the macro available globally, an administrator must re-save it.
12 12  
13 -For example if the user does not have the proper right, only he will see the macro he registered, then an admin can re-save it to make it available for everyone if the macro is validated.
13 +== Trash ==
14 14  
15 +While deleted documents and attachments have been stored in a trash instead of being completely deleted since XWiki 1.2, there was no general interface for viewing the contents of the trash. This has been remedied by the introduction of two new tabs in the wiki's Document Index, //Deleted Documents// and //Deleted Attachments//.
16 +
17 +image:trash1.png
18 +
19 +Both use the livetable, thus allowing filtering and ordering for easier browsing. A document from the trash can be viewed, permanently deleted, or restored if the location is still available.
20 +
21 +image:trash2.png
22 +
23 +The attachment trash contains only attachments deleted from a document, and not attachments that were deleted together with their owner document; in the latter case, the attachments are kept together with the document in the document trash. For attachments, there is no restore option yet, it will be implemented in a future release.
24 +
25 +image:trash3.png
26 +
15 15  == General UI improvements ==
16 16  
17 17  * In the wiki source code viewer, allow to toggle line numbers faster from Javascript
18 18  * Enable full screen view when displaying the wiki source code (viewer=code)
19 19  * Internationalize macro descriptors
20 -* Attachment trash
21 -* Display the contents of the Document Recycle Bin in the document index
22 22  * ActionMenu: Add Profile submenu item to the "current user" menu
23 23  image:XSCOLIBRI-170.png
24 24  * Reorder the document actions in the "More actions" menu: copy, rename, delete
35 +* More UI components make use of the (recently introduced) color theme
25 25  
26 26  == Development improvements ==
27 27  
... ... @@ -77,6 +77,62 @@
77 77  
78 78  = Backward Compatibility and Migration Notes =
79 79  
91 +== Important non-compatible changes ==
92 +
93 +{{warning}}
94 +The way URLs are generated and parsed has changed. While previously the wiki encoding was used to convert non-ASCII bytes to their ##%XY## escapes, as allowed by the older HTTP/URL specifications, now all URLs escape the UTF-8 bytes of the path, to better adhere to the modern URI specification. This should only affect non-UTF-8 wikis, and only by breaking some bookmarks.
95 +{{/warning}}
96 +
97 +{{warning}}
98 +The velocity configuration has been changed so that setting ##null## values to variables is now allowed. This could break some scripts and macros, please check before upgrading.
99 +{{/warning}}
100 +
101 +This means that the following script will generate a different result:
102 +
103 +{{code language="velocity"}}
104 +#set($s = 'abc')
105 +$s
106 +#set($s = $util.null)
107 +$s
108 +{{/code}}
109 +
110 +While previously the result would have been ##abc abc##, now it is ##abc $s##.
111 +
112 +Special care must be taken care with constructs like the following:
113 +
114 +{{code language="velocity"}}
115 +#set($var = '')
116 +#set($var = $xwiki.methodThatMightReturnNull())
117 +#if($var != '')
118 + The method succeeded
119 +#else
120 + The method failed
121 +#end
122 +{{/code}}
123 +
124 +Since ##null != ''## in Velocity, now a different branch will be executed. The following rewrites work.
125 +
126 +Works in both modes, with or without null allowed:
127 +{{code language="velocity"}}
128 +#set($var = '')
129 +#set($var = $xwiki.methodThatMightReturnNull())
130 +#if("$!var" != '')
131 + The method succeeded
132 +#else
133 + The method failed
134 +#end
135 +{{/code}}
136 +
137 +Works only in the new mode, with null allowed, but is shorter, slightly faster, and more familiar for java developers:
138 +{{code language="velocity"}}
139 +#set($var = $xwiki.methodThatMightReturnNull())
140 +#if($!var != $util.null)
141 + The method succeeded
142 +#else
143 + The method failed
144 +#end
145 +{{/code}}
146 +
80 80  == General Notes ==
81 81  
82 82  {{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 <tt>xwiki.store.migration.databases=db1,db2,...//.{{/warning}}
... ... @@ -89,8 +89,7 @@
89 89  
90 90  * The new parser/serializer for document names comes with new features and changes some behaviors:
91 91  ** introducing escaping means:
92 -*** ##\## which is escaping character need to be doubled in full document name like in ##Space.Docume
93 -nt## whcih mean space ##Space## and document ##Docum\ent##
159 +*** ##\## which is now the escaping character needs to be doubled in full document name, as in ##Space.Docu\\ment##, which means space ##Space## and document ##Docu\ment##
94 94  *** some generated documents names will now contains ##\## to escape thing like dot in a document name. For example ##Space.Docu\.ment## means space ##Space## and document ##Docu.ment##
95 95  ** support for the syntax ##wikiname:Document## has been dropped, so in this example "wikiname:Document" will be seen as the document name because no ##.## has been found
96 96  

Get Connected