Version 15.1 by Thomas Mortagne on 2013/10/16

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.2) =
10
11 [[Full list of issues fixed and Dashboard for 5.3>>http://jira.xwiki.org/secure/Dashboard.jspa?selectPageId=11698]].
12
13 == <feature N> ==
14
15 <description of feature N>
16
17 == Miscellaneous ==
18
19 * Some XSS fixes
20
21 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.
22
23 = For Developers =
24
25 == DocumentReference Locale now taken into account in XWiki#exists and XWiki#getDocument ==
26
27 You can now use ##XWiki#exist## method to check for some translation existence too, before that the only way was to either load the XWikiDocument or write your own XWQL or HQL query.
28
29 ##XWiki#getDocument## has been modified accordingly too to be consistent so you don't need to go through ##XWikiDocument#getTranslatedDocument## anymore.
30
31 It also mean that you need to be careful of what Locale is in the DocumentReference with those APIs now.
32
33 == New Extension Manager APIs
34
35 === Extension sub script services
36
37 The ##extension## service now expose an extension point for extension related script service so that it's used as entry point for all of them.
38
39 By default the following are provided:
40 * $services.extension.core (for core extensions APIs)
41 * $services.extension.local (for local extensions APIs)
42 * $services.extension.installed (for installed extensions APIs)
43 * $services.extension.xar (for XAR extension APIS)
44
45 == XWiki Enterprise Archetype ==
46
47 A new archetype is now available to easily create your own product based on XWiki Enterprise. To use:
48
49 {{code}}
50 mvn archetype:generate \
51 -DarchetypeArtifactId=xwiki-enterprise-archetype \
52 -DarchetypeGroupId=org.xwiki.enterprise \
53 -DarchetypeVersion=5.3-milestone-1
54 {{/code}}
55
56 == XAR plugin improvements ==
57
58 The XAR plugin now provides the ability to change values in the XML pages. For example:
59
60 {{code}}
61 <plugin>
62 <groupId>org.xwiki.commons</groupId>
63 <artifactId>xwiki-commons-tool-xar-plugin</artifactId>
64 <configuration>
65 <transformations>
66 <transformation>
67 <file>Blog/WebHome.xml</file>
68 <xpath>/xwikidoc/object/property/itemsPerPage</xpath>
69 <value>100</value>
70 </transformation>
71 <transformation>
72 <artifact>org.xwiki.platform:xwiki-platform-administration-ui</artifact>
73 <file>XWiki/XWikiPreferences.xml</file>
74 <xpath>/xwikidoc/object/property/colorTheme</xpath>
75 <value>ColorThemes.Mint</value>
76 </transformation>
77 </transformations>
78 </configuration>
79 </plugin>
80 {{/code}}
81
82 == Miscellaneous ==
83
84 * [[Script Services implementations have been moved outside of the ##internal## package>>dev:Community.JavaCodeStyle||anchor="HPackagenames"]] in order for CLIRR to check them for backward incompatibilities and so that their API are made available in generated Javadoc.
85
86 == Deprecated and Retired projects ==
87
88 <description of deprecated and retired projects>
89
90 == Upgrades ==
91
92 The following dependencies have been upgraded:
93
94 * [[commons-fileupload 1.3>>http://jira.xwiki.org/browse/XCOMMONS-458]]
95 * [[cssparser 0.9.10>>http://jira.xwiki.org/browse/XCOMMONS-459]]
96 * [[XStream 1.4.5>>http://jira.xwiki.org/browse/XCOMMONS-462]]
97 * [[HttpClient 4.3>>http://jira.xwiki.org/browse/XCOMMONS-460]]
98 * [[Bean Validation 1.1>>http://jira.xwiki.org/browse/XCOMMONS-461]] (and [[Hibernate Validator 5.0.1>>http://jira.xwiki.org/browse/XWIKI-9548]])
99
100 = Translations =
101
102 The following translations have been updated:
103
104 {{language codes="none, none"/}}
105
106 = Tested Browsers & Databases =
107
108 {{include reference="TestReports.ManualTestReportTemplateSummary"/}}
109
110 = Known issues =
111
112 * [[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]]
113
114 = Backward Compatibility and Migration Notes =
115
116 == General Notes ==
117
118 You may also want to [[import the default wiki XAR>>Main.Download]] in order to benefit from all the improvements listed above.
119
120 {{warning}}
121 Always make sure you compare your ##xwiki.cfg## and ##xwiki.properties## files with the newest version since some configuration parameters were 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.
122 {{/warning}}
123
124 == Issues specific to XWiki <version> ==
125
126 <issues specific to the project>
127
128 == API Breakages ==
129
130 The following APIs were modified since <project> <version - 1>:
131
132 {{code language="none"}}
133 <clirr output here>
134 {{/code}}

Get Connected