Version 58.2 by Marius Dumitru Florea on 2014/11/07
Show last authors
1 {{box cssClass="floatinginfobox" title="**Contents**"}}
2 {{toc/}}
3 {{/box}}
4
5 This is the release notes for [[XWiki Commons>>http://commons.xwiki.org]], [[XWiki Rendering>>http://rendering.xwiki.org]], [[XWiki Platform>>http://platform.xwiki.org]] and [[XWiki Enterprise>>http://enterprise.xwiki.org]]. They share the same release notes as they are released together and have the same version.
6
7 This release comes with 16 new Flamingo themes adapted from Bootswatch and a new application to manage them. The document index tree and the Navigation panel have been greatly improved by using a new tree widget which is exposed as a wiki macro. The developers will be interested by the new WebJar integration features. This, along with 17 improvements and 33 bug fixes, makes the release worth trying.
8
9 = New and Noteworthy (since XWiki 6.3-milestone-2) =
10
11 [[Full list of issues fixed and Dashboard for 6.3>>http://jira.xwiki.org/secure/Dashboard.jspa?selectPageId=12599]].
12
13 == Flamingo Themes Application ==
14
15 Now, when you click on "Manage color theme" in the Administration, you reach the [[new application to manage the Flamingo Themes>>extensions:Extension.Flamingo Theme Application]]:
16
17 (((
18 {{image reference="[email protected]" width="50%"/}}
19 )))
20
21 You can use it to change the current theme, modify any theme or create new ones.
22
23 We have also added 3 new themes: Marina, Garden and Kitty.
24
25 {{gallery}}
26 image:Marina.png
27 image:Garden.png
28 image:Kitty.png
29 {{/gallery}}
30
31 == Bootswatch Themes for Flamingo ==
32
33 XWiki comes with [[16 new themes for Flamingo>>extensions:Extension.Bootswatch Themes for Flamingo]], that have been adapted from [[Bootswatch>>http://bootswatch.com/]].
34
35 {{gallery}}
36 image:Cerulean.png
37 image:Cosmo.png
38 image:Cyborg.png
39 image:Darkly.png
40 image:Flatly.png
41 image:Journal.png
42 image:Lumen.png
43 image:Paper.png
44 image:Readable.png
45 image:Sandstone.png
46 image:Simplex.png
47 image:Slate.png
48 image:Spacelab.png
49 image:Superhero.png
50 image:United.png
51 image:Yeti.png
52 {{/gallery}}
53
54 == Document Tree Macro ==
55
56 We introduce [[a new wiki macro>>extensions:Extension.Document Tree Macro]] to display the hierarchy of documents:
57
58 {{code language="none"}}
59 {{documentTree /}}
60 {{/code}}
61
62 {{image reference="docHierarchyTree.png"/}}
63
64 === Document Index Tree ===
65
66 The new [[Document Tree Macro>>extensions:Extension.Document Tree Macro]] is now used in the Wiki document index.
67
68 {{image reference="index-alldocs-tree.png"/}}
69
70 === Navigation Panel ===
71
72 We also changed the Navigation Panel to use the new [[Document Tree Macro>>extensions:Extension.Document Tree Macro]].
73
74 {{image reference="navigationPanel.png"/}}
75
76 == Miscellaneous ==
77
78 * Updated [[XAR export URL format>>platform:Features.Exports||anchor="HXARExport"]] to allow exporting a full space, a full wiki, or any list of pages matching a pattern. For example:(((
79 {{code language="none"}}
80 http://localhost:8080/xwiki/bin/export/Main/WebHome?format=xar&name=test&pages=Main.%25
81 http://localhost:8080/xwiki/bin/export/Main/WebHome?format=xar&name=test&pages=%25.%25
82 http://localhost:8080/xwiki/bin/export/Main/WebHome?format=xar&name=test&pages=%25.%25Home
83 {{/code}}
84 )))
85 * Added an edit button to easily change the default Welcome message that is displayed on the homepage. Users have reportedly been struggling with this task for a while now and, until we come up with a new format for the homepage, this is the solution we have proposed to make things easier.(((
86 {{image reference="editWelcomeMessage.png"/}}
87 )))
88 * The configuration of the [[Applications Panel>>extensions:Extension.Panels Application||anchor="HApplicationPanel"]] now works with touch-screen devices too.
89 * The Standalone Distribution [[now has a new startup parameter to enable monitoring/managing the Jetty instance>>platform:AdminGuide.Monitoring||anchor="HJMXConsole"]]. You can use it with ##start_xwiki.sh -j## (or ##start_xwiki.sh ~-~-jmx##).
90 * Updated the notification message when the panel layout is saved to use the standard notification widget.
91
92 See the [[full list of JIRA issues>>http://jira.xwiki.org/sr/jira.issueviews:searchrequest-printable/temp/SearchRequest.html?jqlQuery=project+in+%28XCOMMONS%2C+XRENDERING%2C+XWIKI%2C+XE%29+and+status+%3D+Closed+and+resolution+%3D+Fixed+and+fixVersion+%3D+%226.3-rc-1%22&tempMax=1000]] fixed in this release.
93
94 = For Developers =
95
96 == Tree Widget ==
97
98 We introduce a [[new JavaScript widget>>extensions:Extension.Tree Widget]] that can be used to create tree views for the structured data stored in the wiki. It is based on [[jsTree>>http://www.jstree.com/]] and thus has support for both static and dynamic (interactive) trees.
99
100 == Tree Macro ==
101
102 We introduce [[a new wiki macro>>extensions:Extension.Tree Macro]] that allows you to easily define a tree in a wiki page. It uses the tree widget.
103
104 {{code language="none"}}
105 {{tree}}
106 * Parent
107 ** Child
108 {{/tree}}
109
110 {{tree reference="Space.MyDynamicTree" /}}
111 {{/code}}
112
113 == Improved WebJars Integration ==
114
115 We added 2 new features to improve the WebJars Integration:
116
117 * You can now omit the WebJar version:(((
118 {{code language="none"}}
119 $services.webjars.url('angularjs', 'angular.js')
120 {{/code}}
121 )))
122 * You can use Velocity code in WebJar resources. This means you can use for instance Color Theme variables inside your CSS files that are packaged inside a WebJar:(((
123 {{code language="none"}}
124 $services.webjars.url('org.xwiki.contrib:my-webjar', 'style.css', {'evaluate': true})
125 {{/code}}
126 )))
127
128 See the [[WebJar Integration documentation>>extensions:Extension.WebJars Integration]] for more information.
129
130 == Miscellaneous ==
131
132 * Suggest widget now has an extra ##propagateEventKeyCodes## option where key codes can be listed so their events will be propagated. See the [[documentation>>platform:DevGuide.AutoSuggestWidget||anchor="HJavascriptparametersfortheXWiki.widgets.Suggestconstructor"]].
133 * Extended modalPopup.js to support specifying keyboard shortcut options for the defined actions. See the [[documentation>>platform:DevGuide.ModalPopup||anchor="HConstructorfieldsfortheModalPopupJavascriptclass"]].
134 * You can now [[render an icon from any icon theme present on the wiki>>extensions:Extension.Icon Theme Application||anchor="HUsagewithscripts"]], referenced by its name:(((
135 {{code language="velocity"}}
136 $services.icon.render('globe', 'Silk')
137 $services.icon.render('globe', 'Font Awesome')
138 {{/code}}
139 )))
140
141 == Upgrades ==
142
143 The following dependencies have been upgraded:
144
145 * [[httpcore 4.3.3>>http://jira.xwiki.org/browse/XCOMMONS-679]]
146
147 = Translations =
148
149 The following translations have been updated:
150
151 {{language codes="de, fr, lv"/}}
152
153 = Tested Browsers & Databases =
154
155 {{include reference="TestReports.ManualTestReportSummaryXWiki63RC1"/}}
156
157 = Performances tests compared to <last super stable version> =
158
159 <a summary of the comparison with latest super stable version>
160
161 More details on <link to the test report>.
162
163 = Known issues =
164
165 * [[Bugs we know about>>http://jira.xwiki.org/secure/IssueNavigator.jspa?reset=true&jqlQuery=category+%3D+%22Top+Level+Projects%22+AND+issuetype+%3D+Bug+AND+resolution+%3D+Unresolved+ORDER+BY+updated+DESC]]
166
167 = Backward Compatibility and Migration Notes =
168
169 == General Notes ==
170
171 When upgrading make sure you compare your ##xwiki.cfg##, ##xwiki.properties## and ##web.xml## files with the newest version since some configuration parameters may have been modified or added. Note that 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.
172
173 == Issues specific to XWiki 6.3-rc-1 ==
174
175 * Wiki page does not have access anymore to Velocity macro defined in the skin template (except for macro.vm template).
176
177 == API Breakages ==
178
179 The following APIs were modified since XWiki 6.2.3:
180
181 * Add issue management and SCM information to extension descriptors. Should be safe enough since most repository handlers extend AbstractExtension instead of directly implementing Extension.
182
183 {{code language="none"}}
184 org.xwiki.extension.Extension: Method 'public org.xwiki.extension.ExtensionIssueManagement getIssueManagement()' has been added to an interface
185 org.xwiki.extension.Extension: Method 'public org.xwiki.extension.ExtensionScm getScm()' has been added to an interface
186 {{/code}}
187
188 * serializeReference method has never been public. AspectJ hacks...
189
190 {{code language="none"}}
191 com.xpn.xwiki.doc.XWikiDocument: Method 'public java.lang.String ajc$privMethod$com_xpn_xwiki_doc_XWikiDocumentCompatibilityAspect$com_xpn_xwiki_doc_XWikiDocument$serializeReference(org.xwiki.model.reference.DocumentReference, org.xwiki.model.reference.EntityReferenceSerializer, org.xwiki.model.reference.DocumentReference)' has been removed
192 {{/code}}
193
194 * Never really been supposed to be exposed as an API
195
196 {{code language="none"}}
197 com.xpn.xwiki.objects.BaseElement: Accessibility of field localEntityReferenceSerializer has been weakened from protected to private
198 {{/code}}
199
200 * Added new methods to the unstable Icon Module
201
202 {{code language="none"}}
203 org.xwiki.icon.IconManager: Method 'public java.lang.String render(java.lang.String, java.lang.String)' has been added to an interface
204 org.xwiki.icon.IconManager: Method 'public java.lang.String render(java.lang.String, java.lang.String, boolean)' has been added to an interface
205 org.xwiki.icon.IconManager: Method 'public java.lang.String renderHTML(java.lang.String, java.lang.String)' has been added to an interface
206 org.xwiki.icon.IconManager: Method 'public java.lang.String renderHTML(java.lang.String, java.lang.String, boolean)' has been added to an interface
207 org.xwiki.icon.IconSetCache: Method 'public void clear(java.lang.String, java.lang.String)' has been added to an interface
208 org.xwiki.icon.IconSetCache: Method 'public org.xwiki.icon.IconSet get(java.lang.String, java.lang.String)' has been added to an interface
209 org.xwiki.icon.IconSetCache: Method 'public void put(java.lang.String, java.lang.String, org.xwiki.icon.IconSet)' has been added to an interface
210 org.xwiki.icon.IconSetManager: Method 'public org.xwiki.icon.IconSet getIconSet(java.lang.String)' has been added to an interface
211 {{/code}}

About

About

Support

Platform

User Guide

Admin Guide

Developer Guide

Projects

XWiki

Extensions

Other

Contribute

Status

Practices

Under the Hood

Get Involved

Get Connected