Version 42.1 by Marius Dumitru Florea on 2014/01/27

Hide last authors
Thomas Mortagne 1.1 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
Thomas Mortagne 10.1 9 = New and Noteworthy (since XWiki 5.4 Milestone 1) =
Thomas Mortagne 1.1 10
11 [[Full list of issues fixed and Dashboard for XWiki 5.4>>http://jira.xwiki.org/secure/Dashboard.jspa?selectPageId=11990]].
12
Marius Dumitru Florea 36.1 13 == Solr Search Improvements ==
14
15 The search facets now support multiple selection. Moreover, selecting a facet value doesn't hide the rest of the values of that facet. You can still see the number of results matching that value. We also decided to display a facet even when it has only one value, so that the user understands that all the results have that value for the specified facet. The facet selection is now preserved when you perform a new search. You can reset the current facets from the header of the facet pane if you want.
16
Marius Dumitru Florea 42.1 17 {{image reference="searchFacetMultipleSelection.png"/}}
Marius Dumitru Florea 39.2 18
Marius Dumitru Florea 36.1 19 === Advanced Search Options Removed ===
20
21 We decided to remove the Advanced Search Options (i.e. the search filters) because they weren't visible enough (you had to notice the arrow at the end of the search input) and, most importantly, because most of these options were duplicated by search facets, creating confusion. We integrated into the facet column the filters that were not already present there. The query boost option is no longer available but you can achieve the same thing from the query input and we'll add later a query boost configuration in the search administration section.
22
23 Following this change, we aligned the search input to the left. The reason it was centered before is because we didn't want the advanced search pane to hide the start of the first search results.
24
25 The Result Type facet has the document type selected by default. This is consistent with the old Result Type filter from the Advanced Search Options which was set to include by default only documents in the search results.
26
27 === Improved File Type Facet ===
28
29 The File Type facet filters results based on the attachment file type. E.g. "documents that have attached images", "text attachments". File types are grouped by category. You can select both an entire category and a specific file type. Categories can be expanded and collapsed.
30
31 {{image reference="searchFileTypeFacet.png"/}}
32
33 === Improved File Size Facet ===
34
35 The File Size facet lets you filter the results based on the size (in bytes) of the attachments. You can new choose between 4 ranges:
36
37 * tiny (less than 10KB)
38 * small (between 10KB and 500KB)
39 * medium (between 500KB and 5MB)
40 * large (more than 5MB)
41
42 {{image reference="searchFileSizeFacet.png"/}}
43
Marius Dumitru Florea 41.1 44 === Debug Mode ===
45
46 You can enable search debug mode by adding ##&debug=true## to the search URL query string. See the [[Solr Search Application>>extensions:Extension.Solr Search Application]] for more details.
47
Marius Dumitru Florea 42.1 48 {{image reference="searchDebug.png" width="400"/}}
Marius Dumitru Florea 41.1 49
Thomas Mortagne 1.1 50 == Distribution Wizard improvements ==
51
Thomas Mortagne 35.1 52 === No ##Upgrade Mode## anymore ===
Thomas Mortagne 33.1 53
Thomas Mortagne 1.1 54 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.
55
Thomas Mortagne 33.1 56 === New report step ===
57
58 A new last step has been introduce to display all the changes made to the wiki and give a chance to do some rollbacks.
59
60 {{image reference="dw-report.png"/}}
61
Guillaume Delhumeau 30.1 62 == Activity Stream improvements ==
63
Guillaume Delhumeau 29.1 64 * The name of the wiki where the event has happened is displayed now, if the event concerns an other wiki than the current one.
65 * On the main wiki, Activity Stream now display events from every wikis where the current user has view right.
66 [[{{image reference="activity.png" width="35%"/}}>>attach:activity.png]]
67
Thomas Mortagne 1.1 68 == Miscellaneous ==
69
Vincent Massol 14.1 70 * 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:(((
71 {{code language="none"}}
72 image:data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABAAAAAQCAYAAAAf8/9hAAAABHNCSVQICAgIfAhkiAAAAO9JREFUOE+lUrsNwjAUdCyWIBXjIEokVoCejgkyQ2gYAIkSsQUrUIUxwrund5bjX4OlyPG9u3v22Z2rjM1uWEtpkq//PC/fCs35UoHi/WGL8mTrErVsAJGJHU2KagGzHUi3I8iP+0s1nInXjBSPSfI/n2/vGTNFJZOVCRkYltdGl1FMRqmHYL0FFM6MjnFXaxCwNJMOZAbW6JyVkI1cbwcD3T5MGBjZLQxi8Lw9kp5iFFikUYwZr2dNQzQT7EavsDFOwl2ErNuIh5kgaX1E0bEyMTiZAcA0WAa26GSL7CUaHjJJz1wyqWLpe6gS/yn8AD9tcjFN7/ajAAAAAElFTkSuQmCC
73 {{/code}}
74 )))
Marius Dumitru Florea 31.1 75 * The user and group pickers now take 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. The group picker behaves slightly different because you can have local groups even when only global users are allowed (to be able to setup various rights for the global users). Thus the group picker shows the scope toggle when you are in a subwiki that accepts global users, otherwise it suggests only local groups (from the current wiki, which can be the main wiki).
Marius Dumitru Florea 17.1 76 * 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.
Guillaume Delhumeau 20.1 77 * Improvement in the wiki descriptor pages. It is now consistent with our [[vertical forms standard>>platform:DevGuide.VerticalForms]].
Guillaume Delhumeau 24.1 78 [[{{image reference="descriptor-improvement1.png" width="35%"/}}>>attach:descriptor-improvement1.png]] [[{{image reference="descriptor-improvement2.png" width="35%"/}}>>attach:descriptor-improvement2.png]]
79 * 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.
80 [[{{image reference="create-a-wiki-dw.png" width="35%"/}}>>attach:create-a-wiki-dw.png]]
Guillaume Delhumeau 28.1 81 * In the Activity Stream, the name of the wiki where the event has happened is displayed now, if the event concerns an other wiki than the current one.
82 [[{{image reference="activity.png" width="35%"/}}>>attach:activity.png]]
Thomas Mortagne 1.1 83
Manuel Smeria 35.2 84 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+%225.4-rc-1%22&tempMax=1000]] fixed in this release.
Thomas Mortagne 1.1 85
86 = For Developers =
87
Thomas Mortagne 25.1 88 == New APIs to manipulate XAR files ==
Thomas Mortagne 1.1 89
Thomas Mortagne 25.1 90 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.
Thomas Mortagne 1.1 91
92 == Deprecated and Retired projects ==
93
94 <description of deprecated and retired projects>
95
96 == Upgrades ==
97
98 The following dependencies have been upgraded:
99
100 * <list libraries that have been upgraded>
101
102 == Miscellaneous ==
103
Marius Dumitru Florea 2.1 104 * 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:(((
105 {{code language="none"}}
Marius Dumitru Florea 2.2 106 ## /xwiki/bin/view/Demo/WebHome?tag=news&tag=science
Marius Dumitru Florea 2.1 107 #set ($options = {
108 'className': 'Demo.DemoClass',
109 ...
110 'tagCloud': true,
111 'selectedTags': $request.getParameterValues('tag'),
112 ...
113 })
114 {{/code}}
115 )))
Guillaume Delhumeau 3.1 116 * 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.
Thomas Mortagne 4.1 117 * Verbosity of the job is now configurable right from the ##org.xwiki.job.Request## object
Thomas Mortagne 5.1 118 * Log generator now generates BeginEvent/EndEvent variants based on marker informations
Thomas Mortagne 6.1 119 * The following ##java.lang.Class## methods are now allowed in Velocity by default: ##name, isArray, isAssignableFrom, isEnum, isInstance, isInterface, isLocalClass, isMemberClass, isPrimitive, isSynthetic##
Thomas Mortagne 11.1 120 * 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}}
Thomas Mortagne 16.1 121 * Various APIs have been added to help translate log. See [[Logging Module>>extensions:Extension.Logging Module||anchor="HTranslatelog"]] for more details
122 * It's now [[possible to add new Images Types when rendering in XHTML>>rendering:Main.Extending||anchor="HAddinganewImageType"]]
123 * Introduced ##org.xwiki.observation.AbstractEventListener##
Thomas Mortagne 26.1 124 * New model API and script service API to create a tree from a list of entity references. See [[Model Module>>extensions:Extension.Model Module]] for more details
Vincent Massol 32.1 125 * [[New option in the XAR plugin's ##format## mojo to add missing license headers>>dev:Community.XARPlugin||anchor="HFormatMojo"]]
Marius Dumitru Florea 42.1 126 * If you want to restrict the list of wikis that are searchable by default with Solr from the main wiki then you can define the following Velocity variable in a page that includes ##Main.SolrSearch##:(((
127 {{code language="none"}}
128 #set ($wikisSearchableFromMainWiki = ["xwiki", "platform", "enterprise", ..., "commons", "rendering"])
129 {{/code}}
130 )))
Thomas Mortagne 1.1 131
132 = Translations =
133
134 The following translations have been updated:
135
136 {{language codes="none, none"/}}
137
138 = Tested Browsers & Databases =
139
Manuel Smeria 16.2 140 {{include reference="TestReports.ManualTestReportXWiki54RC1Summary"/}}
Thomas Mortagne 1.1 141
142 = Known issues =
143
144 * [[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]]
145
146 = Backward Compatibility and Migration Notes =
147
148 == General Notes ==
149
150 == General Notes ==
151
152 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.
153
Thomas Mortagne 7.1 154 == Issues specific to XWiki 5.4RC1 ==
Thomas Mortagne 1.1 155
Thomas Mortagne 7.1 156 === New Velocity uberspector ===
Thomas Mortagne 1.1 157
Thomas Mortagne 9.1 158 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##.
Thomas Mortagne 7.1 159
Thomas Mortagne 1.1 160 == API Breakages ==
161
162 The following APIs were modified since <project> <version - 1>:
163
164 {{code language="none"}}
165 <clirr output here>
166 {{/code}}
Guillaume Delhumeau 18.1 167
Guillaume Delhumeau 19.1 168 * {{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