Version 25.1 by Thomas Mortagne on 2014/01/22

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 <insert description of release here>
8
9 = New and Noteworthy (since XWiki 5.4 Milestone 1) =
10
11 [[Full list of issues fixed and Dashboard for XWiki 5.4>>http://jira.xwiki.org/secure/Dashboard.jspa?selectPageId=11990]].
12
13 == Distribution Wizard improvements ==
14
15 The upgrade mode has been removed, instead both modes are kind of enabled: it's always proposed to upgrade subwikis from main wiki and the Distribution Wizard is also always enabled on sub-wikis and displayed only if there is something to do.
16
17 == Miscellaneous ==
18
19 * Images that are copy-pasted as HTML in the WYSIWYG editor now work fine, thanks to the added support of the [[Data URI scheme>>http://en.wikipedia.org/wiki/Data_URI_scheme]] in XWiki Syntax 2.1. The wiki syntax is:(((
20 {{code language="none"}}
21 image:data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABAAAAAQCAYAAAAf8/9hAAAABHNCSVQICAgIfAhkiAAAAO9JREFUOE+lUrsNwjAUdCyWIBXjIEokVoCejgkyQ2gYAIkSsQUrUIUxwrund5bjX4OlyPG9u3v22Z2rjM1uWEtpkq//PC/fCs35UoHi/WGL8mTrErVsAJGJHU2KagGzHUi3I8iP+0s1nInXjBSPSfI/n2/vGTNFJZOVCRkYltdGl1FMRqmHYL0FFM6MjnFXaxCwNJMOZAbW6JyVkI1cbwcD3T5MGBjZLQxi8Lw9kp5iFFikUYwZr2dNQzQT7EavsDFOwl2ErNuIh5kgaX1E0bEyMTiZAcA0WAa26GSL7CUaHjJJz1wyqWLpe6gS/yn8AD9tcjFN7/ajAAAAAElFTkSuQmCC
22 {{/code}}
23 )))
24 * The user/group picker now takes into account [[the User Scope specified when you create a new wiki>>extensions:Extension.Wiki Application||anchor="HCreateanewwiki"]]. If the current wiki supports only global users then the user picker will suggest global users. If the current wiki supports both local and global users then the user picker has a toggle that lets you choose whether to get local or global suggestions.
25 * Increased the size of the security cache to improve performances from 500 entries to 10000 entries. This setting could still be overwritten in the infinispan configuration of the cache named ##platform.security.authorization.cache##. This new setting should be sufficient for most usages while the previous default were only valid for small single wiki.
26 * Improvement in the wiki descriptor pages. It is now consistent with our [[vertical forms standard>>platform:DevGuide.VerticalForms]].
27 [[{{image reference="descriptor-improvement1.png" width="35%"/}}>>attach:descriptor-improvement1.png]] [[{{image reference="descriptor-improvement2.png" width="35%"/}}>>attach:descriptor-improvement2.png]]
28 * When the user creates a new wiki, without a template, a message is displayed to explain him the Distribution Wizard will be started to initialize the new created wiki.
29 [[{{image reference="create-a-wiki-dw.png" width="35%"/}}>>attach:create-a-wiki-dw.png]]
30
31 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%2C+XEM%29+and+status+%3D+Closed+and+resolution+%3D+Fixed+and+fixVersion+%3D+%22<version>%22&tempMax=1000]] fixed in this release.
32
33 = For Developers =
34
35 == New APIs to manipulate XAR files ==
36
37 A new ##"xar"## ScriptService has been introduced with APIs to manipulate XAR files. It does not yet contains a lot of methods and new will be added as needed. See [[XAR Module extension>>extensions:Extension.XAR Module]] for more details.
38
39 == Deprecated and Retired projects ==
40
41 <description of deprecated and retired projects>
42
43 == Upgrades ==
44
45 The following dependencies have been upgraded:
46
47 * <list libraries that have been upgraded>
48
49 == Miscellaneous ==
50
51 * We added a new parameter to the [[Live Table Velocity macro>>extensions:Extension.Livetable Macro]] named 'selectedTags' which controls the list of tags that are selected initially in the tag cloud. You can still select different tags after the live table loads. With this new parameter you can have a permanent link to a live table that has the rows filtered initially by some tags:(((
52 {{code language="none"}}
53 ## /xwiki/bin/view/Demo/WebHome?tag=news&tag=science
54 #set ($options = {
55 'className': 'Demo.DemoClass',
56 ...
57 'tagCloud': true,
58 'selectedTags': $request.getParameterValues('tag'),
59 ...
60 })
61 {{/code}}
62 )))
63 * The module {{code}}xwiki-platform-wiki-rest{{/code}} replaces the old module {{code}}xwiki-platform-wiki-manager-rest{{/code}} in order to move {{code}}xwiki-platform-wiki-manager{{/code}} in {{code}}contrib{{/code}}, but the API is unchanged.
64 * Verbosity of the job is now configurable right from the ##org.xwiki.job.Request## object
65 * Log generator now generates BeginEvent/EndEvent variants based on marker informations
66 * The following ##java.lang.Class## methods are now allowed in Velocity by default: ##name, isArray, isAssignableFrom, isEnum, isInstance, isInterface, isLocalClass, isMemberClass, isPrimitive, isSynthetic##
67 * Default job status does not provide log tree anymore. Was making the API too complex. It can be created from the log queue very easily in Java and a helper method has been added in logging ScriptService to create one: {{code language="velocity"}}$services.logging.toLogTree($logs){{/code}}
68 * Various APIs have been added to help translate log. See [[Logging Module>>extensions:Extension.Logging Module||anchor="HTranslatelog"]] for more details
69 * It's now [[possible to add new Images Types when rendering in XHTML>>rendering:Main.Extending||anchor="HAddinganewImageType"]]
70 * Introduced ##org.xwiki.observation.AbstractEventListener##
71 * New model API and script service API to create a tree from a list of entity references
72
73 = Translations =
74
75 The following translations have been updated:
76
77 {{language codes="none, none"/}}
78
79 = Tested Browsers & Databases =
80
81 {{include reference="TestReports.ManualTestReportXWiki54RC1Summary"/}}
82
83 = Known issues =
84
85 * [[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]]
86
87 = Backward Compatibility and Migration Notes =
88
89 == General Notes ==
90
91 == General Notes ==
92
93 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.
94
95 == Issues specific to XWiki 5.4RC1 ==
96
97 === New Velocity uberspector ===
98
99 If you modified {{code language="properties"}}velocity.properties = runtime.introspector.uberspect.chainClasses = ...{{/code}} property in ##xwiki.propertes## file you should make sure to replace ##org.apache.velocity.util.introspection.SecureUberspector## with ##org.xwiki.velocity.introspection.SecureUberspector##.
100
101 == API Breakages ==
102
103 The following APIs were modified since <project> <version - 1>:
104
105 {{code language="none"}}
106 <clirr output here>
107 {{/code}}
108
109 * {{code language="none"}}$services.wiki.lastException{{/code}}, {{code language="none"}}$services.wiki.user.lastException{{/code}}, {{code language="none"}}$services.wiki.template.lastException{{/code}} are deprecated now. Please use the corresponding {{code language="none"}}lastError{{/code}} function instead.

Get Connected