Wiki source code of Release Notes for XWiki 8.1 Milestone 2
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 | |||
 |
25.1 | 7 | This milestone release brings a new parameter to the Document Macro, the synchronization of the avatars coming from LDAP and the support of feeds delivered over HTTPS in the RSS Macro. |
| |
1.1 | 8 | |
 |
8.2 | 9 | = New and Noteworthy (since XWiki 8.1 Milestone 1) = |
| |
1.1 | 10 | |
| |
33.1 | 11 | [[Full list of issues fixed and Dashboard for 8.1>>https://jira.xwiki.org/secure/Dashboard.jspa?selectPageId=13603]]. |
| |
1.1 | 12 | |
| |
9.1 | 13 | == Documents Macro Improvement == |
| |
1.1 | 14 | |
| |
9.1 | 15 | The [[Documents Macro>>extensions:Extension.Documents Macro||anchor="HUsage"]] now supports a ##location## parameter to display all documents having their full reference matching the ##location## value. |
| |
1.1 | 16 | |
| |
9.1 | 17 | For example: |
| 18 | |||
| 19 | {{code language="none"}} | ||
| 20 | {{documents location="Sand"/}} | ||
| 21 | {{/code}} | ||
| 22 | |||
| 23 | Gives: | ||
| 24 | |||
| 25 | {{image reference="documents-macro-location.png"/}} | ||
| 26 | |||
 |
16.1 | 27 | == RSS Macro Improvements == |
| 28 | |||
| |
18.1 | 29 | The [[RSS Macro>>extensions:Extension.RSS Macro]] now supports feeds delivered over HTTPS. Additionally, it now uses its own ##user-agent## string, ##XWiki/VERSION##, where ##VERSION## is the version of XWiki in use. |
| |
16.1 | 30 | |
 |
20.1 | 31 | == Synchronization of user avatar from LDAP == |
| 32 | |||
| 33 | Binary photos stored in LDAP can be synchronized now to XWiki user avatar. New options are added to control this feature: | ||
| 34 | |||
| |
32.2 | 35 | {{image reference="ldap-photo.png"/}} |
| |
20.1 | 36 | |
| 37 | Please note that user avatar will not be updated from LDAP if user set custom avatar with filename other than specified in XWiki preferences. | ||
| 38 | |||
| |
1.1 | 39 | == Miscellaneous == |
| 40 | |||
 |
5.1 | 41 | * The [[Document Tree Macro>>extensions:Extension.Document Tree Macro||anchor="HParameters"]] has a new parameter to limit the number of child nodes displayed when a parent node is expanded for the first time. |
 |
22.1 | 42 | * The [[Gadget's title>>extensions:Extension.Dashboard Macro||anchor="HGadget27stitile"]] has now a default value which is internationalized. |
| |
1.1 | 43 | |
| |
33.1 | 44 | 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+%228.1-milestone-2%22&tempMax=1000]] fixed in this release. |
| |
1.1 | 45 | |
| 46 | = For Developers = | ||
| 47 | |||
| |
6.1 | 48 | == Standard java.lang.Package properties == |
| |
1.1 | 49 | |
| |
6.1 | 50 | The following properties are now automatically added to all Maven jar modules MANIFEST files: |
| |
1.1 | 51 | |
| |
6.1 | 52 | {{code language="properties"}} |
| 53 | Specification-Title: ${project.name} | ||
| 54 | Specification-Version: ${project.version} | ||
| 55 | Specification-Vendor: ${project.organization.name} | ||
| 56 | Implementation-Title: ${project.name} | ||
| 57 | Implementation-Version: ${project.version} | ||
| 58 | Implementation-Vendor-Id: ${project.groupId} | ||
| 59 | Implementation-Vendor: ${project.organization.name} | ||
| 60 | Implementation-URL: ${project.url} | ||
| 61 | {{/code}} | ||
| 62 | |||
| |
7.1 | 63 | And can be accessed using ##java.lang.Package## from any class. For example: |
| |
6.1 | 64 | |
| 65 | {{code language="java"}} | ||
| 66 | String myVersion = this.getClass().getPackage().getImplementationVersion(); | ||
| 67 | {{/code}} | ||
| 68 | |||
| |
1.1 | 69 | == Upgrades == |
| 70 | |||
| 71 | The following dependencies have been upgraded: | ||
| 72 | |||
| |
33.1 | 73 | * [[Infinispan 8.2.1>>https://jira.xwiki.org/browse/XWIKI-13293]] |
| 74 | * [[slf4j 1.7.21>>https://jira.xwiki.org/browse/XCOMMONS-958]] | ||
| 75 | * [[commons-compress 1.11>>https://jira.xwiki.org/browse/XCOMMONS-960]] | ||
| 76 | * [[Bootstrap 3.3.6>>https://jira.xwiki.org/browse/XWIKI-12951]] | ||
| 77 | * [[JGroups 3.6.9>>https://jira.xwiki.org/browse/XWIKI-13344]] | ||
| 78 | * [[commons-io 2.5>>https://jira.xwiki.org/browse/XCOMMONS-969]] | ||
| |
1.1 | 79 | |
| 80 | == Miscellaneous == | ||
| 81 | |||
| |
11.1 | 82 | * The default LiveTable results page (##XWiki.LiveTableResults##, the page that generates the JSON displayed by the LiveTable) [[now supports a ##location## extra parameter>>extensions:Extension.Livetable Macro||anchor="HParameter24options"]]. |
| |
13.1 | 83 | * [[Modified WebJars URL format>>extensions:Extension.WebJars Integration||anchor="HURLFormat"]] and added some new Script Service methods:((( |
| 84 | {{code language="none"}} | ||
| 85 | public String url(String webjarId, String namespace, String path, Map<String, ?> params) | ||
| 86 | public String url(String webjarId, String namespace, String path) | ||
| 87 | {{/code}} | ||
| 88 | ))) | ||
| 89 | |||
| |
1.1 | 90 | = Translations = |
| 91 | |||
| 92 | The following translations have been updated: | ||
| 93 | |||
| |
26.1 | 94 | {{language codes="fr, de, ru"/}} |
| |
1.1 | 95 | |
| 96 | = Tested Browsers & Databases = | ||
| 97 | |||
 |
30.1 | 98 | {{include reference="TestReports.ManualTestReportSummaryXWiki81M2"/}} |
| |
1.1 | 99 | |
| 100 | = Performances tests compared to <last super stable version> = | ||
| 101 | |||
| 102 | <a summary of the comparison with latest super stable version> | ||
| 103 | |||
| 104 | More details on <link to the test report>. | ||
| 105 | |||
| 106 | = Known issues = | ||
| 107 | |||
| |
33.1 | 108 | * [[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 | 109 | |
| 110 | = Backward Compatibility and Migration Notes = | ||
| 111 | |||
| 112 | == General Notes == | ||
| 113 | |||
| 114 | 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. | ||
| 115 | |||
| |
8.2 | 116 | == Issues specific to XWiki XWiki 8.1 Milestone 2 == |
| |
1.1 | 117 | |
| |
12.1 | 118 | * The WebJars URL format has been modified to support relative WebJars URL in subwikis. The new format is {{code language="none"}}/webjars/<namespace>/<path/to/resource>?...{{/code}}. Reminder: you should not use this format directly and instead you should use the Script Service to generate a valid WebJars URL; this isolate you from any URL change. Example from Velocity: {{code language="none"}}$services.webjars.url(...){{/code}}. |
| |
1.1 | 119 | |
| 120 | == API Breakages == | ||
| 121 | |||
| |
2.2 | 122 | The following APIs were modified since XWiki 8.0: |
| |
1.1 | 123 | |
| |
28.1 | 124 | {{backwardCompatiblityReport version="8.1-milestone-2"/}} |
