Wiki source code of ReleaseNotesXWiki72M2
Version 22.1 by Thomas Mortagne on 2015/08/04
Show last authors
| author | version | line-number | content |
|---|---|---|---|
| 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 <version - 1>) = | ||
| 10 | |||
| 11 | [[Full list of issues fixed and Dashboard for <version>>>http://jira.xwiki.org/secure/Dashboard.jspa?selectPageId=<fill id here>]]. | ||
| 12 | |||
| 13 | == Script Right == | ||
| 14 | |||
| 15 | The Script Right is now set to DENY by default, meaning that if you do not have it explicitly, you will not be able to execute the scripts that you write with your user account. | ||
| 16 | |||
| 17 | However, for backwards compatibility reasons, the standard XWiki Enterprise distribution comes with the Script Right being allowed for all users at the main wiki level so that, unless you (as an admin) explicitly revoke the right for some users or explicitly deny it, they will be able to execute the scripts they wrote, just like before. | ||
| 18 | |||
| 19 | {{image reference="scriptRightsExplicitlyAllowedInXWikiPreferences.png"/}} | ||
| 20 | |||
| 21 | == <feature N> == | ||
| 22 | |||
| 23 | <description of feature N> | ||
| 24 | |||
| 25 | == Miscellaneous == | ||
| 26 | |||
| 27 | * Import UI move to new standard tree | ||
| 28 | {{image reference="import.png"/}} | ||
| 29 | |||
| 30 | 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+%22<version>%22&tempMax=1000]] fixed in this release. | ||
| 31 | |||
| 32 | = For Developers = | ||
| 33 | |||
| 34 | == New Space/XWikiSpace table == | ||
| 35 | |||
| 36 | A new tables dedicated to spaces has been introduced. See [[platform:DevGuide.DatabaseSchema]] for more details. | ||
| 37 | |||
| 38 | == Queries improvement == | ||
| 39 | |||
| 40 | === Allow executing complete SELECT queries === | ||
| 41 | |||
| 42 | In HQL and XWQL it's now possible to execute complete ##SELECT## queries without programming right as long as you follow some rules currently defined in ##com.xpn.xwiki.internal.store.hibernate.query.HqlQueryUtils## which is a list of database field allowed in the SELECT clause: | ||
| 43 | |||
| 44 | * ##Document##/##XWikiDocument## table: ##fullName##, ##name##, ##space##, ##language##, ##defaultLanguage##, ##translation##, ##hidden## | ||
| 45 | * ##Space##/##XWikiSpace## table: ##reference##, ##name##, ##parent##, ##hidden## | ||
| 46 | |||
| 47 | This is also true for the named queries located in ##queries.hbm.xml## file. | ||
| 48 | |||
| 49 | === New SecureQuery === | ||
| 50 | |||
| 51 | The right to execute or not some query is now controlled by each ##org.xwiki.query.QueryExecutor##. | ||
| 52 | |||
| 53 | Anyone can ask the executor to check or ignore right through the new ##org.xwiki.query.SecureQuery## extending ##org.xwiki.query.Query##: | ||
| 54 | |||
| 55 | * checkCurrentAuthor: indicate if the current author right should be checked | ||
| 56 | * checkCurrentUser: indicate if the result should be filtered based on current user right (only implemented by SOLR right now) | ||
| 57 | |||
| 58 | == JS API Improvements == | ||
| 59 | |||
| 60 | * It's now possible to create a Nested Spaces Reference using XWik'is Javascript API. For example:((( | ||
| 61 | {{code language="javascript"}} | ||
| 62 | // Construct a Nested Space reference | ||
| 63 | var reference = new XWiki.SpaceReference('wiki', ['space1', 'space2']); | ||
| 64 | expect(XWiki.Model.serialize(reference)).toEqual('wiki:space1.space2'); | ||
| 65 | reference = new XWiki.DocumentReference('wiki', ['space1', 'space2'], 'page'); | ||
| 66 | expect(XWiki.Model.serialize(reference)).toEqual('wiki:space1.space2.page'); | ||
| 67 | // Construct a non-Nested Space reference | ||
| 68 | reference = new XWiki.SpaceReference('wiki', 'space'); | ||
| 69 | expect(XWiki.Model.serialize(reference)).toEqual('wiki:space'); | ||
| 70 | // Try passing non-valid space parameters | ||
| 71 | expect(function() {new XWiki.SpaceReference('wiki', [])}).toThrow('Missing mandatory space name or invalid type for: []'); | ||
| 72 | expect(function() {new XWiki.SpaceReference('wiki', 12)}).toThrow('Missing mandatory space name or invalid type for: [12]'); | ||
| 73 | {{/code}} | ||
| 74 | ))) | ||
| 75 | * A new ##XWiki.EntityReference.equals()## method has been added. For example:((( | ||
| 76 | {{code language="javascript"}} | ||
| 77 | var reference1 = new XWiki.DocumentReference('wiki', ['space1', 'space2'], 'page'); | ||
| 78 | var reference2 = new XWiki.DocumentReference('wiki', ['space1', 'space2'], 'page'); | ||
| 79 | var reference3 = new XWiki.DocumentReference('wiki2', ['space1', 'space2'], 'page'); | ||
| 80 | expect(reference1.equals(reference2)).toBe(true); | ||
| 81 | expect(reference1.equals(reference3)).toBe(false); | ||
| 82 | {{/code}} | ||
| 83 | ))) | ||
| 84 | * A new ##XWiki.EntityReference.fromJSONObject(obejct)## has been added to create a Javascript ##XWiki.EntityReference## from a Java ##EntityReference## directly serialized as JSON:((( | ||
| 85 | {{code language="javascript"}} | ||
| 86 | var reference = XWiki.EntityReference.fromJSONObject(jsonText.evalJSON()); | ||
| 87 | {{/code}} | ||
| 88 | ))) | ||
| 89 | * A new ##XWiki.EntityReferenceTree## class which partially mimic Java ##EntityReferenceTree## on Javascript side. There is not much yet, it was mostly introduced to make easier to manipulate a serailized Java ##EntityReferenceTree## | ||
| 90 | |||
| 91 | == Deprecated and Retired projects == | ||
| 92 | |||
| 93 | * [[OSCache based cache extension>>extensions:Extension.Cache OSCache]] moved to https://github.com/xwiki-contrib/xwiki-platform-cache-oscache | ||
| 94 | |||
| 95 | == Upgrades == | ||
| 96 | |||
| 97 | The following dependencies have been upgraded: | ||
| 98 | |||
| 99 | * [[Groovy 2.4.4>>http://jira.xwiki.org/browse/XCOMMONS-831]] | ||
| 100 | * [[Tika 1.9>>http://jira.xwiki.org/browse/XWIKI-12274]] | ||
| 101 | * [[JRuby 1.7.21>>http://jira.xwiki.org/browse/XWIKI-12344]] | ||
| 102 | * [[Jackson 2.6.0>>http://jira.xwiki.org/browse/XCOMMONS-833]] | ||
| 103 | * [[Hibernate Validator 4.3.2>>http://jira.xwiki.org/browse/XWIKI-12365]] | ||
| 104 | |||
| 105 | == Miscellaneous == | ||
| 106 | |||
| 107 | * Custom displayers are now executed with the rights of the user who wrote them (i.e. author of the class document or content author of the displayer document), and not the rights of the user who wrote the script that uses them (i.e. current context document's content author). See [[XWIKI-12306>>http://jira.xwiki.org/browse/XWIKI-12306]] for more details. | ||
| 108 | * In the [[Active Install Extension>>extensions:Extension.Active Installs Server Application]], a new Velocity Macro has been introduced to compute the number of Active Installs having a specific Extension. Example usage:((( | ||
| 109 | {{code language="none"}} | ||
| 110 | {{include reference="ActiveInstalls.ExtensionCount"/}} | ||
| 111 | |||
| 112 | {{velocity}} | ||
| 113 | #set ($extensionIds = [ | ||
| 114 | 'org.xwiki.contrib:xwiki-totem-application', | ||
| 115 | 'jsimard:event-reporter-application', | ||
| 116 | 'mouhb:likeapplication' | ||
| 117 | ]) | ||
| 118 | |=Extension Id|=Count | ||
| 119 | #foreach($extensionId in $extensionIds) | ||
| 120 | #countActiveInstallsUsingExtension($extensionId $count) | ||
| 121 | |$extensionId|$count | ||
| 122 | #end | ||
| 123 | {{/velocity}} | ||
| 124 | {{/code}} | ||
| 125 | ))) | ||
| 126 | * Better support of non-DOCUMENT ##EntityReferences## in ##DocumentReferenceConverter##. It now behaves like ##XWiki#getDocument(EntityReference)## | ||
| 127 | |||
| 128 | = Translations = | ||
| 129 | |||
| 130 | The following translations have been updated: | ||
| 131 | |||
| 132 | {{language codes="none, none"/}} | ||
| 133 | |||
| 134 | = Tested Browsers & Databases = | ||
| 135 | |||
| 136 | {{include reference="TestReports.ManualTestReportTemplateSummary"/}} | ||
| 137 | |||
| 138 | = Performances tests compared to <last super stable version> = | ||
| 139 | |||
| 140 | <a summary of the comparison with latest super stable version> | ||
| 141 | |||
| 142 | More details on <link to the test report>. | ||
| 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 | |||
| 154 | == Issues specific to XWiki <version> == | ||
| 155 | |||
| 156 | <issues specific to the project> | ||
| 157 | |||
| 158 | == API Breakages == | ||
| 159 | |||
| 160 | The following APIs were modified since <project> <version - 1>: | ||
| 161 | |||
| 162 | {{code language="none"}} | ||
| 163 | <clirr output here> | ||
| 164 | {{/code}} |
