Wiki source code of Release Notes for XWiki 6.4-milestone-3
Last modified by Thomas Mortagne on 2017/03/24
Hide last authors
author | version | line-number | content |
---|---|---|---|
![]() |
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 | |||
![]() |
21.1 | 7 | This milestone integrates the Ratings module inside platform, providing the ability to rate extensions inside the Extension Repository and visualise them inside Extension Manager. We have also added improvements for Flamingo Skin on the responsiveness aspect, reintroduced the Wiki configuration section in Administration and done massive work in augmenting the Mail Sender API to be able to send large number of emails. |
![]() |
1.1 | 8 | |
![]() |
20.2 | 9 | = New and Noteworthy (since XWiki 6.4-milestone-2) = |
![]() |
1.1 | 10 | |
![]() |
30.1 | 11 | [[Full list of issues fixed and Dashboard for 6.4>>https://jira.xwiki.org/secure/Dashboard.jspa?selectPageId=12791]]. |
![]() |
1.1 | 12 | |
![]() |
22.1 | 13 | == Rating Features == |
![]() |
16.1 | 14 | |
![]() |
22.1 | 15 | === Ratings module === |
![]() |
16.1 | 16 | |
![]() |
22.1 | 17 | Contrib ratings project has been moved to platform. Java APIs have been broken by the package renaming but script APIs have been kept retro-compatible and the UI is mostly the same. |
18 | |||
![]() |
16.1 | 19 | See [[Ratings Application>>extensions:Extension.Ratings Application]]. |
20 | |||
![]() |
22.1 | 21 | === Ratings support for extensions === |
![]() |
16.1 | 22 | |
23 | It's now possible to rate extensions in [[Extension Repository>>extensions:Extension.Repository Application]] and any repository handler can expose extension rating that are displayed (read only for now) in [[Extension Manager>>extensions:Extension.Extension Manager Application]]. | ||
24 | |||
25 | {{image reference="ratingem.png"/}} {{image reference="ratinger.png"/}} | ||
26 | |||
![]() |
5.1 | 27 | == Wiki Configuration == |
![]() |
1.1 | 28 | |
![]() |
5.1 | 29 | A new "Configuration > Wiki" section is added in Administration where you can configure the current wiki, whether it is the main wiki or a subwiki. |
![]() |
1.1 | 30 | |
![]() |
5.1 | 31 | {{image reference="wikiDescriptorEditingAdministration-cropped.png"/}} |
32 | |||
33 | For more information, see the [[documentation>>extensions:Extension.Wiki Application||anchor="HConfigureWiki"]]. | ||
34 | |||
![]() |
22.1 | 35 | == Flamingo Skin == |
![]() |
8.1 | 36 | |
37 | Some improvements have been made on the responsive tables (including the livetables) and we have fixed the broken livetables for mobiles on some places: | ||
38 | |||
39 | ((( | ||
![]() |
11.1 | 40 | {{image reference="livetable-rights.png" width="30%"/}} {{image reference="mobile-users.png" width="30%"/}} {{image reference="mobile-groups.png" width="30%"/}} |
![]() |
8.1 | 41 | ))) |
42 | |||
![]() |
22.1 | 43 | == Batch Mail Sending == |
44 | |||
![]() |
24.3 | 45 | The [[Mail Sender API>>extensions:Extension.Mail Sender API]] has been modified to support sending a large number of mails at once. In addition the [[Mail Admin UI>>extensions:Extension.Mail Application]] has been improved to display the statuses of mails (when they're sent by XWiki features specifying that the mail statuses should be persisted). |
![]() |
22.1 | 46 | |
![]() |
25.1 | 47 | {{image reference="emailcategory.png"/}} |
![]() |
22.1 | 48 | |
![]() |
25.1 | 49 | {{image reference="emailstatus.png"/}} |
![]() |
22.1 | 50 | |
![]() |
15.1 | 51 | == Solr server setup package == |
52 | |||
![]() |
15.2 | 53 | Everything needed to setup an XWiki index in a remote Solr server is now packaged in a standalone project (##xwiki-platform-search-solr-server-data##). A Debian package (##xwiki-solr-data##) has also been provided to make easier to keep it up to date. |
![]() |
15.1 | 54 | |
![]() |
1.1 | 55 | == Miscellaneous == |
56 | |||
![]() |
6.2 | 57 | * Displaying the 'Stable versions' label in an extension's description in Extension Manager before and after the list of versions is retrieved. |
![]() |
1.1 | 58 | |
![]() |
30.1 | 59 | See the [[full list of JIRA issues>>https://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.4-milestone-3%22&tempMax=1000]] fixed in this release. |
![]() |
1.1 | 60 | |
61 | = For Developers = | ||
62 | |||
![]() |
13.1 | 63 | == Rendering == |
![]() |
1.1 | 64 | |
![]() |
13.1 | 65 | * XWiki Rendering now provide an HTML5 Renderer. |
![]() |
1.1 | 66 | |
![]() |
28.1 | 67 | == REST == |
68 | |||
69 | The REST API for the repository module has been updated to include information about the extension's rating. | ||
70 | The information regarding ratings has been included in the AbstractExtension element of the XML Schema, thus it is available in the extension's detailed information and in the search results. | ||
71 | |||
72 | **More information:** | ||
73 | * [[Repository module documentation>>http://extensions.xwiki.org/xwiki/bin/view/Extension/Repository+Module#HREST]] | ||
74 | |||
75 | **Example:** | ||
76 | |||
77 | {{code language="xml"}} | ||
78 | <extension> | ||
79 | <id>org.xwiki.contrib:application-filemanager-ui</id> | ||
80 | <name>File Manager Application</name> | ||
81 | <type>xar</type> | ||
82 | <!-- start rating info --> | ||
83 | <rating> | ||
84 | <totalVotes>821</totalVotes> | ||
85 | <averageVote>5.0</averageVote> | ||
86 | </rating> | ||
87 | <!-- end rating info --> | ||
88 | <summary>Application to manage a hierarchy of folders and files. It embeds viewers for many known file types, such as office and PDF.</summary> | ||
89 | <description>This application lets your organize your files inside XWiki using a tree hierarchy of folders. It supports all standard operations like move, rename, copy, delete on both files and folders. You can use drag & drop to upload new files and to modify the folder hierarchy. A wide range of files types can be viewed or played (in case of audio and video files) directly from the wiki. This includes PDF and office documents [...]</description> | ||
90 | <licenses> | ||
91 | <name>GNU Lesser General Public License 2.1</name> | ||
92 | </licenses> | ||
93 | <website>http://extensions.xwiki.org/xwiki/bin/view/Extension/File+Manager+Application</website> | ||
94 | <authors> | ||
95 | <name>Thomas Delafosse</name> | ||
96 | <url>http://www.xwiki.org/xwiki/bin/view/XWiki/tdelafosse</url> | ||
97 | </authors> | ||
98 | <authors> | ||
99 | <name>Ludovic Dubost</name> | ||
100 | <url>http://www.xwiki.org/xwiki/bin/view/XWiki/LudovicDubost</url> | ||
101 | </authors> | ||
102 | <authors> | ||
103 | <name>Marius Dumitru Florea</name> | ||
104 | <url>http://www.xwiki.org/xwiki/bin/view/XWiki/mflorea</url> | ||
105 | </authors> | ||
106 | <features>tdelafosse:file-manager-application</features> | ||
107 | <features>org.xwiki.contrib:application-filemanager</features> | ||
108 | </extension> | ||
109 | {{/code}} | ||
110 | |||
![]() |
29.1 | 111 | {{comment}} |
112 | == Deprecated and Retired projects == | ||
113 | |||
114 | <description of deprecated and retired projects> | ||
115 | {{/comment}} | ||
116 | |||
117 | == Upgrades == | ||
118 | |||
119 | The following dependencies have been upgraded: | ||
120 | |||
![]() |
30.1 | 121 | * [[slf4j 1.7.9>>https://jira.xwiki.org/browse/XCOMMONS-712]] |
122 | * [[Lucene and SOLR 4.10.3>>https://jira.xwiki.org/browse/XWIKI-11603]] | ||
![]() |
29.1 | 123 | |
124 | {{comment}} | ||
125 | == Miscellaneous == | ||
126 | |||
127 | <other dev stuff to add and link to JIRA for all issues fixed> | ||
128 | {{/comment}} | ||
129 | |||
![]() |
1.1 | 130 | = Translations = |
131 | |||
132 | The following translations have been updated: | ||
133 | |||
![]() |
20.1 | 134 | {{language codes="de, pl"/}} |
![]() |
1.1 | 135 | |
136 | = Tested Browsers & Databases = | ||
137 | |||
![]() |
26.1 | 138 | {{include reference="TestReports.ManualTestReportSummaryXWiki64M3"/}} |
![]() |
1.1 | 139 | |
![]() |
20.6 | 140 | {{comment}} |
![]() |
1.1 | 141 | = Performances tests compared to <last super stable version> = |
142 | |||
143 | <a summary of the comparison with latest super stable version> | ||
144 | |||
145 | More details on <link to the test report>. | ||
146 | |||
![]() |
20.6 | 147 | {{/comment}} |
148 | |||
![]() |
1.1 | 149 | = Known issues = |
150 | |||
![]() |
30.1 | 151 | * [[Bugs we know about>>https://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]] |
![]() |
1.1 | 152 | |
153 | = Backward Compatibility and Migration Notes = | ||
154 | |||
155 | == General Notes == | ||
156 | |||
157 | 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. | ||
158 | |||
![]() |
20.6 | 159 | {{comment}} |
![]() |
1.1 | 160 | == Issues specific to XWiki <version> == |
161 | |||
162 | <issues specific to the project> | ||
163 | |||
![]() |
20.6 | 164 | {{/comment}} |
165 | |||
![]() |
1.1 | 166 | == API Breakages == |
167 | |||
![]() |
25.1 | 168 | The following APIs were modified since XWiki 6.3: |
![]() |
1.1 | 169 | |
![]() |
25.1 | 170 | * It's very unlikely that this class is implemented by anything else and it does not make much sense to not have this method, since this is not really a cache behind it but a Map that keep engines forever it may create a memory leak on a big farm running for a long time((( |
![]() |
1.1 | 171 | {{code language="none"}} |
![]() |
25.1 | 172 | org.xwiki.velocity.VelocityFactory: Method 'public org.xwiki.velocity.VelocityEngine removeVelocityEngine(java.lang.String)' has been added to an interface |
![]() |
1.1 | 173 | {{/code}} |
![]() |
25.1 | 174 | ))) |
175 | |||
176 | * This shouldn't be a backward incompatible change since it's a method addition on an Annotation.((( | ||
177 | {{code language="none"}} | ||
178 | org.xwiki.component.annotation.Component: Method 'public boolean staticRegistration()' has been added to an interface | ||
179 | {{/code}} | ||
180 | ))) | ||
181 | |||
182 | * Young API, this method needs to be available for consistency with the getMainWikiDescriptor/Id pair of methods((( | ||
183 | {{code language="none"}} | ||
184 | org.xwiki.wiki.descriptor.WikiDescriptorManager: Method 'public org.xwiki.wiki.descriptor.WikiDescriptor getCurrentWikiDescriptor()' has been added to an interface | ||
185 | {{/code}} | ||
186 | ))) | ||
187 | |||
188 | * WYSIWYG's MacroService API was not previously considering a multiwiki environment.((( | ||
189 | {{code language="none"}} | ||
190 | org.xwiki.gwt.wysiwyg.client.plugin.macro.MacroService: Method 'public org.xwiki.gwt.wysiwyg.client.plugin.macro.MacroDescriptor getMacroDescriptor(java.lang.String, java.lang.String, java.lang.String)' has been added to an interface | ||
191 | org.xwiki.gwt.wysiwyg.client.plugin.macro.MacroService: Method 'public java.util.List getMacroDescriptors(java.lang.String, java.lang.String)' has been added to an interface | ||
192 | org.xwiki.gwt.wysiwyg.client.plugin.macro.MacroServiceAsync: Method 'public void getMacroDescriptor(java.lang.String, java.lang.String, java.lang.String, com.google.gwt.user.client.rpc.AsyncCallback)' has been added to an interface | ||
193 | org.xwiki.gwt.wysiwyg.client.plugin.macro.MacroServiceAsync: Method 'public void getMacroDescriptors(java.lang.String, java.lang.String, com.google.gwt.user.client.rpc.AsyncCallback)' has been added to an interface | ||
194 | {{/code}} | ||
195 | ))) | ||
196 | |||
197 | * Add new methods to the Icon Set Module((( | ||
198 | {{code language="none"}} | ||
199 | org.xwiki.icon.IconManager: Method 'public java.util.List getIconNames()' has been added to an interface | ||
200 | org.xwiki.icon.IconManager: Method 'public java.util.List getIconNames(java.lang.String)' has been added to an interface | ||
201 | org.xwiki.icon.IconSetManager: Method 'public java.util.List getIconSetNames()' has been added to an interface | ||
202 | {{/code}} | ||
203 | ))) | ||
204 | |||
205 | * LESS refactoring.((( | ||
206 | {{code language="none"}} | ||
207 | org.xwiki.lesscss.LessCompilerScriptService: Method 'public boolean clearCacheFromFileSystemSkin(java.lang.String)' has been removed | ||
208 | org.xwiki.lesscss.LessCompilerScriptService: Return type of method 'public org.xwiki.lesscss.ColorTheme getColorThemeFromSkinFile(java.lang.String)' has been changed to org.xwiki.lesscss.colortheme.ColorTheme | ||
209 | org.xwiki.lesscss.LessCompilerScriptService: Return type of method 'public org.xwiki.lesscss.ColorTheme getColorThemeFromSkinFile(java.lang.String, java.lang.String)' has been changed to org.xwiki.lesscss.colortheme.ColorTheme | ||
210 | org.xwiki.lesscss.ColorTheme: Class org.xwiki.lesscss.ColorTheme removed | ||
211 | org.xwiki.lesscss.ColorThemeCache: Class org.xwiki.lesscss.ColorThemeCache removed | ||
212 | org.xwiki.lesscss.LESSCache: Class org.xwiki.lesscss.LESSCache removed | ||
213 | org.xwiki.lesscss.LESSColorThemeConverter: Class org.xwiki.lesscss.LESSColorThemeConverter removed | ||
214 | org.xwiki.lesscss.LESSCompiler: Class org.xwiki.lesscss.LESSCompiler removed | ||
215 | org.xwiki.lesscss.LESSCompilerException: Class org.xwiki.lesscss.LESSCompilerException removed | ||
216 | org.xwiki.lesscss.LESSSkinFileCache: Class org.xwiki.lesscss.LESSSkinFileCache removed | ||
217 | org.xwiki.lesscss.LESSSkinFileCompiler: Class org.xwiki.lesscss.LESSSkinFileCompiler removed | ||
218 | {{/code}} | ||
219 | ))) | ||
220 | |||
221 | * Lots of refactoring on the new Mail module, which is a young API((( | ||
222 | {{code language="none"}} | ||
223 | org.xwiki.mail.MailResultListener: Class org.xwiki.mail.MailResultListener removed | ||
224 | org.xwiki.mail.MailSender: Parameter 1 of 'public void send(javax.mail.internet.MimeMessage, javax.mail.Session)' has changed its type to java.lang.Iterable | ||
225 | org.xwiki.mail.MailSender: Return type of method 'public void send(javax.mail.internet.MimeMessage, javax.mail.Session)' has been changed to org.xwiki.mail.MailResult | ||
226 | org.xwiki.mail.MailSender: Parameter 1 of 'public void sendAsynchronously(javax.mail.internet.MimeMessage, javax.mail.Session, org.xwiki.mail.MailResultListener)' has changed its type to java.lang.Iterable | ||
227 | org.xwiki.mail.MailSender: Parameter 3 of 'public void sendAsynchronously(javax.mail.internet.MimeMessage, javax.mail.Session, org.xwiki.mail.MailResultListener)' has changed its type to org.xwiki.mail.MailListener | ||
228 | org.xwiki.mail.MailSender: Return type of method 'public void sendAsynchronously(javax.mail.internet.MimeMessage, javax.mail.Session, org.xwiki.mail.MailResultListener)' has been changed to org.xwiki.mail.MailResult | ||
229 | org.xwiki.mail.MailSender: Method 'public void waitTillSent(long)' has been removed | ||
230 | org.xwiki.mail.MailSenderConfiguration: Method 'public java.util.List getBCCAddresses()' has been added to an interface | ||
231 | org.xwiki.mail.MailSenderConfiguration: Method 'public java.lang.String getScriptServicePermissionCheckerHint()' has been added to an interface | ||
232 | org.xwiki.mail.script.MimeMessageWrapper: In method 'public MimeMessageWrapper(org.xwiki.mail.internal.ExtendedMimeMessage, javax.mail.Session, org.xwiki.mail.MailSender, org.xwiki.context.Execution, org.xwiki.component.manager.ComponentManager)' the number of arguments has changed | ||
233 | org.xwiki.mail.script.MimeMessageWrapper: Accessibility of method 'public MimeMessageWrapper(org.xwiki.mail.internal.ExtendedMimeMessage, javax.mail.Session, org.xwiki.mail.MailSender, org.xwiki.context.Execution, org.xwiki.component.manager.ComponentManager)' has been decreased from public to package | ||
234 | org.xwiki.mail.script.MimeMessageWrapper: Method 'public java.util.concurrent.BlockingQueue getErrors()' has been removed | ||
235 | org.xwiki.mail.script.MimeMessageWrapper: Method 'public void send()' has been removed | ||
236 | org.xwiki.mail.script.MimeMessageWrapper: Method 'public void sendAsynchronously()' has been removed | ||
237 | org.xwiki.mail.script.MimeMessageWrapper: Method 'public void waitTillSent(long)' has been removed | ||
238 | {{/code}} | ||
239 | ))) |