Wiki source code of Release Notes for XWiki 4.3 Milestone 1
Version 20.1 by Fabio Mancinelli on 2012/10/22
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 Platform, XWiki Enterprise and XWiki Enterprise Manager. They share the same release notes as they are released together and have the same version. | ||
| 6 | |||
| 7 | This is the first milestone of the XWiki 4.3 version ([[Roadmap>>xwiki:Main.Roadmap]]). This release brings absolutely nothing? really? Oh, it's not released yet... | ||
| 8 | |||
| 9 | = New and Noteworthy (since XWiki 4.2) = | ||
| 10 | |||
 |
3.2 | 11 | == Workspace Templates == |
| |
1.1 | 12 | |
| |
5.1 | 13 | Similar to what admins were doing with the [[Wiki Manager Application>>extensions:Extension.Wiki Manager Application]], we noticed the need for the [[Workspace Application>>extensions:Extension.Workspace Application]] to allow users to choose what type of workspace they want to create. |
| |
1.1 | 14 | |
 |
8.1 | 15 | {{image reference="workspaceTemplates.png"/}} |
| |
3.2 | 16 | |
| |
5.2 | 17 | Please see the current workaround for [[creating workspace templates>>http://jira.xwiki.org/browse/XWIKI-8285]] (as admin) until an easy UI becomes available. |
| 18 | |||
| |
6.1 | 19 | == Extension Manager improvements == |
| 20 | |||
 |
12.1 | 21 | === UI === |
| 22 | |||
| |
8.1 | 23 | When you click on "Show details" to get more information about an extension, the extension manager tries to resolve all the dependencies of that extension by making requests to the configured remote extension repositories. These requests slow down considerably the time needed to display the extension details. We fixed this by resolving only the local dependencies at first and then making consecutive AJAX requests to resolve the remote dependencies. |
| |
6.1 | 24 | |
| |
9.1 | 25 | {{image reference="EM-AsyncDependencyLoading.png"/}} |
| |
8.1 | 26 | |
| 27 | The install and uninstall plan is now progressively displayed while it is being created. This is especially useful for the Distribution Wizard since you don't have to wait anymore for the install plan to be created without getting any feedback about its progress. | ||
| 28 | |||
| 29 | {{image reference="EM-liveInstallPlan.png"/}} | ||
| 30 | |||
| 31 | As you can see in the previous image, we also limited the height of the progress tab and the extension job log is automatically scrolled to the end while the job is running. | ||
| 32 | |||
| |
12.1 | 33 | === Private repositories === |
| 34 | |||
| |
13.1 | 35 | Maven and XWiki repositories now support authentication. You can indicate a user and a password in ##xwiki.properties## file the following way: |
| |
12.1 | 36 | |
| 37 | {{code language="properties"}} | ||
| 38 | extension.repositories=privatemavenid:maven:http://host.com/private/maven/ | ||
| 39 | extension.repositories.privatemavenid.auth.user=someuser | ||
| 40 | extension.repositories.privatemavenid.auth.user=password | ||
| 41 | |||
| 42 | extension.repositories=extensions.xwiki.org:xwiki:http://extensions.xwiki.org/xwiki/rest/ | ||
| 43 | extension.repositories.extensions.xwiki.org.auth.user=someuser | ||
| 44 | extension.repositories.extensions.xwiki.org.auth.user=password | ||
| 45 | {{/code}} | ||
| 46 | |||
| |
11.1 | 47 | == Distribution Wizard improvements == |
| 48 | |||
| 49 | The welcome step now lists only the available steps. For instance, when you install XWiki for the first time you don't have any extensions to upgrade so the "Extensions" step is not available. | ||
| 50 | |||
| 51 | {{image reference="DistributionWizard-emptyDatabase.png"/}} | ||
| 52 | |||
| 53 | When a step is done we visually mark it. | ||
| 54 | |||
| 55 | {{image reference="DistributionWizard-stepDone.png"/}} | ||
| 56 | |||
 |
20.1 | 57 | == REST API improvements == |
| 58 | |||
| 59 | Some improvements have been done to the REST API in order to allow more powerful searches of the data stored in the wiki. | ||
| 60 | |||
| 61 | * Results can be ordered using the ##/wikis/{wikiName}/search## and ##/wikis/{wikiName}/spaces/{spaceName}/search## resources with the following parameters: | ||
| 62 | ** //orderField//: one of the XWiki document field, as specified in http://platform.xwiki.org/xwiki/bin/view/DevGuide/velocityHqlExamples#HXWikiDocument | ||
| 63 | ** //order//: ##asc## or ##desc##". By default ##asc## is used. | ||
| 64 | |||
| 65 | * Advanced search queries can be specified using ##/wikis/{wikiName}/query## resources with the following parameters: | ||
| 66 | ** //q//: the query to be executed (it depends on the query type) | ||
| 67 | ** //type//: ##hql##, ##xwql## or ##lucene##. Depending on the query type, the //q// parameter will contain a query matching the type | ||
| 68 | *** For ##hql## it's like a searchDocuments query, as shown in specified in http://platform.xwiki.org/xwiki/bin/view/DevGuide/velocityHqlExamples. | ||
| 69 | *** For ##xwql## the user is allowed to use XWQL syntax for short queries (http://dev.xwiki.org/xwiki/bin/view/Design/XWiki+Query+Language+Specification ) | ||
| 70 | *** For ##lucene## it's a standard Lucene query handled by the Lucene plugin (http://extensions.xwiki.org/xwiki/bin/view/Extension/Lucene+Plugin ) | ||
| 71 | ** Standard parameters like //start//, //number// can be specified to control the number of the results to be returned. | ||
| 72 | |||
| 73 | * Multi-wiki Lucene search using the ##/wikis/query## resource with the following parameters: | ||
| 74 | ** //q//: the Lucene query handled by the Lucene plugin (http://extensions.xwiki.org/xwiki/bin/view/Extension/Lucene+Plugin ) | ||
| 75 | ** //wikis//: a comma separated list of wikis where to perform the search. | ||
| 76 | |||
| |
2.1 | 77 | == Miscellaneous == |
| 78 | |||
| 79 | * XWiki's multiwiki feature (a.k.a "virtual mode") now works with the HSQLDB database | ||
| |
3.1 | 80 | * It's now possible to configure the LDAP timeout. See ##xwiki.authentication.ldap.timeout## property in xwiki.cfg file. |
| |
14.1 | 81 | * New available syntax: [[APT>>http://maven.apache.org/doxia/references/apt-format.html]] |
| |
15.1 | 82 | * Technical pages of the IRCBot Application are now hidden and the application now registers itself in the Application panel:((( |
| 83 | {{image reference="ircbotapp.png"/}} | ||
| 84 | ))) | ||
| |
2.1 | 85 | |
| |
1.1 | 86 | == Important Bug Fixes == |
| 87 | |||
| 88 | * Fixed failure to import Office documents when using Filesystem Attachments. | ||
| 89 | |||
| 90 | 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+%224.3-milestone-1%22&tempMax=1000]] fixed in this release. | ||
| 91 | |||
| 92 | = For Developers = | ||
| 93 | |||
| 94 | == <developer feature N> == | ||
| 95 | |||
| 96 | <description of developer feature N> | ||
| 97 | |||
| 98 | == Deprecated and Retired projects == | ||
| 99 | |||
| |
19.1 | 100 | * The ##userdirectorty## and ##usertools## plugins have been retired since they were unmaintained and mostly replaced by other features such as the Invitation module. |
| |
1.1 | 101 | |
| 102 | == Upgrades == | ||
| 103 | |||
| 104 | The following dependencies have been upgraded: | ||
| 105 | |||
| |
2.1 | 106 | * HSQLDB [[2.2.9>>http://hsqldb.org/doc/2.0/changelist_2_0.txt]] |
 |
17.2 | 107 | * mysql-connector-java [[5.1.21>>http://dev.mysql.com/doc/refman/5.1/en/cj-news-5-1-x.html]] |
| |
1.1 | 108 | |
| 109 | == Miscellaneous == | ||
| 110 | |||
| |
2.1 | 111 | * new ##org.xwiki.rendering.block.CompositeBlock## introduce to allow passing several Blocks as one Block |
| |
17.1 | 112 | * new ##$services.model.getEntityReferenceValue## method that returns the value configured for a specific entity type |
| |
1.1 | 113 | |
| 114 | == Translations == | ||
| 115 | |||
| 116 | The following translations have been updated: | ||
| 117 | |||
| 118 | {{language codes="code1, code2"/}} | ||
| 119 | |||
| 120 | = Tested Browsers = | ||
| 121 | |||
| 122 | Here's the list of browsers tested with this version (i.e. browsers that we've tested as working - Check the list of [[supported browsers>>dev:Community.BrowserSupportStrategy]]): | ||
| 123 | |||
| 124 | {{velocity}} | ||
| 125 | ## name = iexplorer, firefox, chrome, safari, opera | ||
| 126 | {{/velocity}} | ||
| 127 | |||
| 128 | {{browser name="browser" version="x.x"/}} | ||
| 129 | |||
| 130 | = Known issues = | ||
| 131 | |||
| 132 | * [[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]] | ||
| 133 | |||
| 134 | = Test Report = | ||
| 135 | |||
| 136 | You can check the [[manual test report>>TestReports.WebHome#<anchor to test report>]] to learn about what was tested and the results on various browsers. | ||
| 137 | |||
| 138 | = Backward Compatibility and Migration Notes = | ||
| 139 | |||
| 140 | == General Notes == | ||
| 141 | |||
| 142 | You may also want to [[import the default wiki XAR>>Main.Download]] in order to benefit from all the improvements listed above. | ||
| 143 | |||
| 144 | {{warning}} | ||
| 145 | 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. | ||
| 146 | {{/warning}} | ||
| 147 | |||
| 148 | == Issues specific to XWiki 4.3 Milestone 1 == | ||
| 149 | |||
| |
19.1 | 150 | * Since the ##userdirectorty## and ##usertools## have been retired you'll need to make sure that your ##xwiki.cfg## configuration files doesn't reference them anymore in the ##plugins## property. |
| |
1.1 | 151 | |
| 152 | == API Breakages == | ||
| 153 | |||
| 154 | The following APIs were modified since 4.2: | ||
| 155 | |||
| 156 | {{code language="none"}} | ||
| 157 | <clirr output here> | ||
| 158 | {{/code}} |
