Wiki source code of Release Notes for XWiki 7.1 Milestone 1
Version 49.1 by Marius Dumitru Florea on 2015/05/05
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 | |||
| 7 | <insert description of release here> | ||
| 8 | |||
| 9 | = New and Noteworthy (since XWiki 7.0) = | ||
| 10 | |||
 |
48.3 | 11 | [[Full list of issues fixed and Dashboard for 7.1>>http://jira.xwiki.org/secure/Dashboard.jspa?selectPageId=13193]]. |
| |
1.1 | 12 | |
| |
41.1 | 13 | == Extension Diff View Summary == |
| |
1.1 | 14 | |
| |
41.1 | 15 | Since [[XWiki 7.0RC1>>ReleaseNotes.ReleaseNotesXWiki70RC1||anchor="HExtensionDiffView"]] you can view the local changes that have been made to the wiki pages of an installed extension. In this release we have improved the diff view by adding a summary that will help you navigate the changes. |
| |
1.1 | 16 | |
 |
43.2 | 17 | {{image reference="extensionDiffViewSummary.png"/}} |
| |
42.2 | 18 | |
| |
44.2 | 19 | See the [[Extension Manager Application>>extensions:Extension.Extension Manager Application||anchor="HChanges"]] for more details. |
| 20 | |||
| |
46.1 | 21 | == Responsive Search UI == |
| 22 | |||
| 23 | We worked on making the search UI responsive on small screens. On mobile phones the list of search facets is now collapsed above the search results and the user can toggle it with a tap. We improved the way the search results of type Object and Object Property are displayed (check the result title and location / breadcrumb). We switched to using the icon themes for the search result icons and we also fixed some small spacing and alignment issues introduced by the migration from the old Colibri skin to the new Flamingo skin. Last but not least, we worked on refreshing the search UI without reloading the entire page when the user sorts the search results, uses the pagination or drills down the results using the search facets. | ||
| 24 | |||
| |
47.1 | 25 | {{image reference="searchPageMobile.png"/}} |
| |
46.1 | 26 | |
| 27 | See the [[Solr Search Application>>extensions:Extension.Solr Search Application]] documentation for more details. | ||
| 28 | |||
| |
1.1 | 29 | == Miscellaneous == |
| 30 | |||
| 31 | * The Script Macro has been improved to [[return any type of value even no binding is used to output content>>extensions:Extension.Script Macro||anchor="HReturn"]]. | ||
 |
13.1 | 32 | * The default Java version triggered as dependency for the Debian packages is not Java 8 |
 |
19.1 | 33 | * In the [[extensions:Extension.Administration Application]], when you change the space you are administrating, you don't lose the current section anymore (if the current section exists in that space).((( |
| 34 | {{image reference="administration-change-space.png" width="50%"/}} | ||
| 35 | ))) | ||
| |
28.1 | 36 | * In edit mode, Password fields do not display the obfuscation placholder () anymore when the password value is empty. For example this removes the confusion when editing the Mail Admin UI and users were thinking that the SMTP Server password was set. |
| |
30.1 | 37 | * Not existing document won't end up in the document cache anymore. That mean request lots of not existing document won't ditch "real" documents from the cache anymore. |
| |
36.2 | 38 | * The WatchList application now uses the new Mail API instead of the old and deprecated Mail Plugin. |
| |
36.3 | 39 | * The WatchList Realtime notification option has been reworked and the previous performance penalty has been removed. |
| |
48.2 | 40 | * In [[extensions:Extension.App Within Minutes Application]], the newly created applications don't have 'App Within Minutes' as parent, but the home page of the current wiki and their home page title doesn't contain the word 'Home' any more. |
| |
43.2 | 41 | * A new option was added to Watch a page that was just shared by mail directly from the email's body.((( |
| 42 | {{image reference="share-footer-actions-watch.png"/}} | ||
| 43 | ))) | ||
| |
1.1 | 44 | |
 |
35.1 | 45 | 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+%227.1-milestone-1%22&tempMax=1000]] fixed in this release. |
| |
1.1 | 46 | |
| 47 | = For Developers = | ||
| 48 | |||
| |
40.1 | 49 | == Trigger Prototype Event Listeners from jQuery == |
| |
1.1 | 50 | |
| |
40.1 | 51 | The event listeners registered from Prototype are now notified when a custom XWiki event is fired using the jQuery API. |
| |
1.1 | 52 | |
| |
40.1 | 53 | {{code language="js"}} |
| 54 | // Prototype (old code that you don't have time to rewrite) | ||
| 55 | document.observe('xwiki:dom:updated', function(event) { | ||
| 56 | event.memo.elements.each(function(element) { | ||
| 57 | // Do something. | ||
| 58 | }); | ||
| 59 | }); | ||
| 60 | ... | ||
| |
40.2 | 61 | // jQuery (new code, in a different file/page) |
| |
40.1 | 62 | require(['jquery', 'xwiki-events-bridge'], function($) { |
| 63 | $(document).trigger('xwiki:dom:updated', {'elements': $('.some-container').toArray()}); | ||
| 64 | }); | ||
| 65 | {{/code}} | ||
| 66 | |||
| 67 | See the [[developer's guide>>platform:DevGuide.JavaScriptAPI||anchor="HBridgingcustomXWikieventsbetweenPrototypeandjQuery"]] for more details. | ||
| 68 | |||
| |
48.1 | 69 | == Integration tests for JavaScript with Jasmine + RequireJS + WebJars == |
| 70 | |||
| 71 | Using Jasmine, we have written a few integration tests for JavaScript code that uses AMD (RequireJS) and that has dependencies packaged as Webjars. We found out that the Jasmine Maven Plugin has support for both [[AMD>>http://searls.github.io/jasmine-maven-plugin/amd-support.html]] and [[WebJars>>http://searls.github.io/jasmine-maven-plugin/webjars-support.html]]. You can check out this [[commit>>https://github.com/xwiki/xwiki-platform/commit/a65618beeacb6c36aa5e6de178d7a495b6e18879]] to see how we configured the plugin in case you want to write similar tests for your extension or module. | ||
| 72 | |||
| |
5.1 | 73 | == Miscellaneous == |
| 74 | |||
| |
8.1 | 75 | * The XAR plugin's ##verify## mojo has been [[improved to allow passing a list of regexes to identify content and technical pages>>dev:Community.XARPlugin]]. For example:((( |
| |
5.1 | 76 | {{code language="xml"}} |
| 77 | <plugin> | ||
| 78 | <groupId>org.xwiki.commons</groupId> | ||
| 79 | <artifactId>xwiki-commons-tool-xar-plugin</artifactId> | ||
| 80 | ... | ||
| 81 | <configuration> | ||
| 82 | ... | ||
| 83 | <!-- Consider all pages named *Translations as content pages by default --> | ||
| 84 | <contentPages> | ||
| 85 | <contentPage>.*Translations\.xml</contentPage> | ||
| 86 | </contentPages> | ||
| |
8.1 | 87 | <!-- The EditTranslations page is not a Translation page and thus not a content page! --> |
| 88 | <technicalPages> | ||
| 89 | <technicalPage>EditTranslations\.xml</technicalPage> | ||
| 90 | </technicalPages> | ||
| |
5.1 | 91 | </configuration> |
| 92 | </plugin> | ||
| |
5.2 | 93 | {{/code}} |
| |
5.1 | 94 | ))) |
| |
9.3 | 95 | * New ##$services.rendering.escape($content, $syntax)## method to escape XWiki syntax. See [[the documentation>>extensions:Extension.Rendering Module||anchor="HRenderingScriptService"]]. |
| |
12.1 | 96 | * The HTML5 renderer is now bundled in XWiki Enterprise. |
| |
33.1 | 97 | * Added a new ##objectPolicy=updateOrCreate## parameter to the save action that allows editing and creating objects in one request. For more details, see [[the documentation>>platform:DevGuide.Standard URL Format||anchor="HParameter:objectPolicy"]]. |
| |
16.1 | 98 | * It is now possible to select the output syntax of a skin, in order to use the correct renderer. |
| |
22.1 | 99 | * Ability to [[register a custom Resource Type>>extensions:Extension.Resource API||anchor="HAddinganewResourceTypeHandler"]]. |
| |
48.2 | 100 | * The WebJar integration now registers a ##webjar## URL type using a [[Resource Handler>>extensions:Extension.Resource API]] (it was reusing the ##bin## URL type before). The new WebJAR URL format is:((( |
| 101 | {{code language="none"}} | ||
| 102 | http://<server>/<context path>/webjars/<path/to/resource>[?version=<version>&evaluate=true|false] | ||
| 103 | {{/code}} | ||
| 104 | |||
| 105 | Note that you should use the [[exposed Script Service method to compute a WebJAR URL>>extensions:Extension.WebJars Integration]]. | ||
| 106 | ))) | ||
| |
24.1 | 107 | * The mime type of uploaded attachment is now automatically stored in the database and won't be recalculated each time it's asked. Also a new API has been introduced in ##com.xpn.xwiki.doc.XWikiAttachment## to change it if needed. |
| |
24.2 | 108 | * The ConfigurableClass mechanism now supports adding field hints / descriptions. See the [[documentation>>extensions:Extension.Administration Application||anchor="HFieldsyoucandefine"]]. |
| |
29.1 | 109 | * The ##xwiki-platform-legacy-crypto-script## legacy module has been removed as it was conflicting with the Bouncy Castle 1.52 upgrade and we considered that there was little chance that this module was used anywhere in any extension. If by chance (so to speak) you were using it, you'd need to use the newer ##xwiki-platform-crypto-script## module and rebuild your extension with it. |
| |
39.1 | 110 | * Added advanced search support to ##org.xwiki.extension.repository.ExtensionRepositoryManager## |
| |
47.1 | 111 | * The Velocity macros from the ##Main.SolrSearch## page have been moved to a separate page, ##Main.SolrSearchMacros##, which should ease the creation of a custom search page (e.g. if you want reuse some macros and to overwrite others). |
| |
5.1 | 112 | |
| |
1.1 | 113 | == Upgrades == |
| 114 | |||
| 115 | The following dependencies have been upgraded: | ||
| 116 | |||
| |
14.1 | 117 | * [[httpclient and httpcore 4.4.1>>http://jira.xwiki.org/browse/XCOMMONS-778]] |
| |
4.1 | 118 | * [[Groovy 2.4.3>>http://jira.xwiki.org/browse/XCOMMONS-779]] |
| |
3.1 | 119 | * [[logback 1.1.3>>http://jira.xwiki.org/browse/XCOMMONS-781]] |
| |
7.1 | 120 | * [[cssparser 0.9.15>>http://jira.xwiki.org/browse/XCOMMONS-782]] |
| |
10.1 | 121 | * [[JGroups 3.6.3>>http://jira.xwiki.org/browse/XWIKI-11980]] |
| |
11.1 | 122 | * [[slf4j 1.7.12>>http://jira.xwiki.org/browse/XCOMMONS-786]] |
| |
15.1 | 123 | * [[Quartz 2.2.1>>http://jira.xwiki.org/browse/XWIKI-6465]] |
 |
20.2 | 124 | * [[commons-lang3 3.4>>http://jira.xwiki.org/browse/XCOMMONS-789]] |
| |
36.1 | 125 | * [[Maven 3.3.3>>http://jira.xwiki.org/browse/XCOMMONS-769]] |
| |
25.1 | 126 | * [[Bouncy Castle 1.52>>http://jira.xwiki.org/browse/XCOMMONS-794]] |
| 127 | * [[Tika 1.8>>http://jira.xwiki.org/browse/XCOMMONS-793]] | ||
| |
26.1 | 128 | * [[Infinispan 7.1.1>>http://jira.xwiki.org/browse/XWIKI-12042]] |
| |
38.1 | 129 | * [[Jython 2.7.0>>http://jira.xwiki.org/browse/XWIKI-12040]] |
| |
28.1 | 130 | * [[Lucene and Solr 4.10.4>>http://jira.xwiki.org/browse/XWIKI-12044]] |
| |
31.1 | 131 | * [[sisu-guice 3.2.6>>http://jira.xwiki.org/browse/XCOMMONS-796]] |
| 132 | * [[org.eclipse.sisu.plexus to 0.3.1>>http://jira.xwiki.org/browse/XCOMMONS-795]] | ||
| |
1.1 | 133 | |
| 134 | = Translations = | ||
| 135 | |||
| 136 | The following translations have been updated: | ||
| 137 | |||
| 138 | {{language codes="none, none"/}} | ||
| 139 | |||
| 140 | = Tested Browsers & Databases = | ||
| 141 | |||
| |
34.1 | 142 | {{include reference="TestReports.ManualTestReportSummaryXWiki71M1"/}} |
| |
1.1 | 143 | |
| 144 | = Known issues = | ||
| 145 | |||
| 146 | * [[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]] | ||
| 147 | |||
| 148 | = Backward Compatibility and Migration 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 | |||
| |
49.1 | 154 | == Loading JavaScript from WebJars with RequireJS == |
| |
1.1 | 155 | |
| |
49.1 | 156 | [[WebJars integration>>extensions:Extension.WebJars Integration]], available since 6.0M1, allows us to use JavaScript code that has been packaged as JAR and which has been included in the XWiki WAR or installed as an extension. Until this version the URL used to access a resource from a WebJar was looking like this: |
| |
1.1 | 157 | |
| |
49.1 | 158 | {{code language="none"}} |
| 159 | /xwiki/bin/webjars/resources/path?value=angularjs/1.2.11/angular.js | ||
| 160 | {{/code}} | ||
| 161 | |||
| 162 | The file path was specified in the query string. As a consequence, if you wanted to load a JavaScript file from a WebJar using RequireJS you would have written: | ||
| 163 | |||
| 164 | {{code language="js"}} | ||
| 165 | require(["$services.webjars.url('angularjs', 'angular.js')"], function() { | ||
| 166 | ... | ||
| 167 | }); | ||
| 168 | {{/code}} | ||
| 169 | |||
| 170 | Note that the **'.js'** extension had to be included because RequireJS doesn't add it automatically if the URL has a query string. Starting with this version, the WebJar URLs look like this: | ||
| 171 | |||
| 172 | {{code language="none"}} | ||
| 173 | http://<server>/<context path>/webjars/<path/to/resource>[?version=<version>&evaluate=true|false] | ||
| 174 | {{/code}} | ||
| 175 | |||
| 176 | Note that the resource path is not included in the query string any more. This means you need to update the "require" calls: | ||
| 177 | |||
| 178 | {{code language="js"}} | ||
| 179 | require(["$services.webjars.url('angularjs', 'angular')"], function() { | ||
| 180 | ... | ||
| 181 | }); | ||
| 182 | {{/code}} | ||
| 183 | |||
| 184 | Otherwise RequireJS will attempt to load "angular.js.js". **BUT** note that even with the new URL format there are still cases when the WebJar URLs have a query string: e.g. when the resource must be evaluated. In this case you need to keep the ".js" extension: | ||
| 185 | |||
| 186 | {{code language="js"}} | ||
| 187 | require(["$!services.webjars.url('org.xwiki.platform:xwiki-platform-tree-webjar', | ||
| 188 | 'require-config.min.js', {'evaluate': true})"], function() { | ||
| 189 | ... | ||
| 190 | }); | ||
| 191 | {{/code}} | ||
| 192 | |||
| |
1.1 | 193 | == API Breakages == |
| 194 | |||
| |
49.1 | 195 | The following APIs were modified since XWiki 7.0.1: |
| |
1.1 | 196 | |
| 197 | {{code language="none"}} | ||
| 198 | <clirr output here> | ||
| 199 | {{/code}} |
