Wiki source code of Release Notes for XWiki 5.1 Milestone 1
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 | |||
 |
35.1 | 5 | {{warning}} |
 |
38.1 | 6 | We have found an important regression in this release: the //Add > Page// and //Add > Page from Office// menu entries are not visible in some cases for simple users (with no administration rights). See [[XWIKI-9183>>https://jira.xwiki.org/browse/XWIKI-9183]] for more details. The problem is going to be fixed in 5.1 Milestone 2. We are very sorry for the inconvenience. |
| |
35.1 | 7 | {{/warning}} |
| |
33.1 | 8 | |
| |
1.1 | 9 | This is the release notes for XWiki Platform, XWiki Enterprise and XWiki Enterprise Manager. They share the same release notes as they are released together and have the same version. |
| 10 | |||
| |
24.1 | 11 | This is the first milestone for the 5.1 release. It brings an improved Solr search UI with faceted search and a couple of bug fixes and other small improvements. |
| |
1.1 | 12 | |
| 13 | = New and Noteworthy (since XWiki 5.0) = | ||
| 14 | |||
| |
38.1 | 15 | [[Full list of issues fixed and Dashboard for 5.1>>https://jira.xwiki.org/secure/Dashboard.jspa?selectPageId=11595]]. |
| |
1.1 | 16 | |
| |
18.1 | 17 | == Solr search UI overhaul == |
| |
1.1 | 18 | |
| |
23.1 | 19 | We have redesigned the Solr search page to include faceted search and we improved the display of the advanced search options and the search results. Solr search is still not enabled by default because you still have to manually trigger the index from the administration, but we're working on this and we are confident that 5.1 final will have automatic Solr indexing and Solr enabled by default. See the documentation for the [[Solr Search Application>>doc:extensions:Extension.Solr Search Application]] for more details. |
| |
1.1 | 20 | |
| |
23.1 | 21 | {{image reference="solr-search.png" width="400px"/}} |
| 22 | |||
| |
1.1 | 23 | == Miscellaneous == |
| 24 | |||
 |
17.2 | 25 | * Moved the User Directory feature [[to an application on its own>>extensions:Extension.User Directory Application]]. |
| |
18.2 | 26 | * Moved the XWiki Syntax Help feature [[to an application on its own>>extensions:Extension.Help Application]]. |
 |
30.1 | 27 | * When an user wants to change his password, he now has to enter his current password for more security. Live validation of his new password validity (length) has also been added. |
 |
32.1 | 28 | {{image reference="ChangeOwnPassword .png"/}} |
| |
35.1 | 29 | * The attachment upload input now remains visible after uplading one or more files:((( |
| 30 | {{image reference="attachmentUpload.png"/}} | ||
| 31 | ))) | ||
| |
15.1 | 32 | * The "Send to" input from the [[Share page>>doc:platform:Features.DocumentLifecycle||anchor="HSharePagebyEmail"]] dialog displays a scope toggle when you are in a subwiki (or an workspace) that allows you to control whether the suggested users are local or global.((( |
| |
32.3 | 33 | {{image reference="sharePage-scopeToggle.png"/}} |
| |
15.1 | 34 | ))) |
| |
1.1 | 35 | |
| |
38.1 | 36 | 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%2C+XEM%29+and+status+%3D+Closed+and+resolution+%3D+Fixed+and+fixVersion+%3D+%225.0-milestone-1%22&tempMax=1000]] fixed in this release. |
| |
1.1 | 37 | |
| 38 | = For Developers = | ||
| 39 | |||
| 40 | == Upgrades == | ||
| 41 | |||
| 42 | The following dependencies have been upgraded: | ||
| 43 | |||
| |
7.1 | 44 | * logback 1.0.13 |
| 45 | * commons-compress 1.5 | ||
| 46 | * commons-codec 1.8 | ||
| 47 | * httpclient 4.2.5 | ||
| |
8.1 | 48 | * diffutils 1.3 |
| |
9.1 | 49 | * Doxia 1.4 |
| |
10.1 | 50 | * JGroups 3.3 |
| |
16.1 | 51 | * HTMLCleaner 2.5 |
| |
37.1 | 52 | * Lucene and Solr 4.3 |
| |
1.1 | 53 | |
| 54 | == Miscellaneous == | ||
| 55 | |||
| |
21.1 | 56 | * All REST responses now specify the version of XWiki running on the server in the ##XWiki-Version## HTTP header, and the current user in the ##XWiki-User## header. |
| 57 | * You can now provide a version summary (comment) when updating a page using REST. You can retrieve the version summary either by getting the page or by getting the page history, in which case you get the summary for each page revision. | ||
| |
21.2 | 58 | * We added a new [[special CSS class name>>doc:platform:DevGuide.SpecialCSSClasses]], ##useTitleAsTip##, that, combined with ##withTip##, will allow you to have a tip (place-holder) different than the initial value of the text input. |
| |
4.1 | 59 | * A new URL parameter has been added to reference non aggregated JavaScript files: ##?minify=false##. See the [[Debugging Guide>>dev:Community.Debugging||anchor="HDebuggingJavaScript"]]. |
| |
5.1 | 60 | * Added API to easily create a DocumentReference from a LocalDocumentReference |
| |
6.1 | 61 | {{code language="java"}}DocumentReference documentReference = new DocumentReference(localReference, wikiReference);{{/code}} |
| |
1.1 | 62 | |
| 63 | = Translations = | ||
| 64 | |||
| 65 | The following translations have been updated: | ||
| 66 | |||
| |
25.1 | 67 | {{language codes="da, de, fr, lv, pt_BR, ru, sv"/}} |
| |
1.1 | 68 | |
| 69 | = Tested Browsers & Databases = | ||
| 70 | |||
 |
13.2 | 71 | {{include reference="TestReports.ManualTestReportXWiki51M1Summary"/}} |
| |
1.1 | 72 | |
| 73 | = Known issues = | ||
| 74 | |||
| |
38.1 | 75 | * [[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 | 76 | |
| 77 | = Backward Compatibility and Migration Notes = | ||
| 78 | |||
| 79 | == General Notes == | ||
| 80 | |||
| 81 | You may also want to [[import the default wiki XAR>>Main.Download]] in order to benefit from all the improvements listed above. | ||
| 82 | |||
| 83 | {{warning}} | ||
| 84 | 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. | ||
| 85 | {{/warning}} | ||
| 86 | |||
| |
2.1 | 87 | == Issues specific to XWiki 5.1 Milestone 1 == |
| |
1.1 | 88 | |
| |
2.1 | 89 | * The data type of the 'email' property from the user profile has changed from ##String## to ##Email##, a specialized type [[introduced in 4.2>>ReleaseNotes.ReleaseNotesXWiki42||anchor="HNewfieldtypesforemailandlistofpages"]]. Unfortunately this change doesn't apply automatically when you upgrade from an older version so you have to do it your self:((( |
| 90 | 1. edit ##XWiki.XWikiUsers## with the class editor | ||
| 91 | 1. delete the 'email' property | ||
| 92 | 1. add a new property of type ##Email## named 'email' with 'e-Mail' as pretty name | ||
| 93 | 1. save | ||
| 94 | )))The values of both ##String## and ##Email## data types are stored in the same database table so there souldn't be any migration issues for existing users. | ||
| |
1.1 | 95 | |
| 96 | == API Breakages == | ||
| 97 | |||
| |
36.1 | 98 | The following APIs were modified since XWiki 5.0.2: |
| |
1.1 | 99 | |
| |
36.1 | 100 | * Young API: New method to separate job setup from job start to put real jobs in queue. |
| 101 | |||
| |
1.1 | 102 | {{code language="none"}} |
| |
36.1 | 103 | org.xwiki.job.Job: Method 'public void initialize(org.xwiki.job.Request)' has been added to an interface |
| |
1.1 | 104 | {{/code}} |
| |
36.1 | 105 | |
| 106 | * Young API: The URL module has never been finished and we started working on it again. | ||
| 107 | |||
| 108 | {{code language="none"}} | ||
| 109 | org.xwiki.url.InvalidURLException: Class org.xwiki.url.InvalidURLException removed | ||
| 110 | {{/code}} |
