Wiki source code of Release Notes for XWiki 5.2 Milestone 2
Version 22.2 by Vincent Massol on 2013/09/09
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 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 | <insert description of release here> | ||
| 8 | |||
| 9 | = New and Noteworthy (since XWiki 5.2 Milestone 1) = | ||
| 10 | |||
| 11 | [[Full list of issues fixed and Dashboard for 5.2>>http://jira.xwiki.org/secure/Dashboard.jspa?selectPageId=11602]]. | ||
| 12 | |||
| 13 | == <feature N> == | ||
| 14 | |||
| 15 | <description of feature N> | ||
| 16 | |||
| 17 | == SubWikis Management == | ||
| 18 | |||
| 19 | XWiki Enterprise comes now with the ability for users to create their own subwikis. There is no "workspace" anymore. | ||
| 20 | |||
| 21 | === SubWiki Creation Right === | ||
| 22 | |||
| 23 | The subwiki creation is now possible for users who has the "subwikicreation" right. This right is only available for the main wiki users, exactly like the Programming Right. | ||
| 24 | |||
| 25 | A new section is available in the administration of the main wiki to manage who has this right. | ||
| 26 | {{image reference="admin-subwikis.png"/}} | ||
| 27 | |||
| 28 | == Active Installs Tracking == | ||
| 29 | |||
| 30 | It' very important for the open source committers to understand how well or how badly they're faring when developing the XWiki open source project. So far we didn't know if the number of people using XWiki was increasing, decreasing or staying stable. This module allows us to know who's using XWiki. | ||
| 31 | |||
| 32 | It does the following: | ||
| 33 | |||
| 34 | * A client side JAR is bundled with XWiki and it sends a ping with data once per day | ||
| 35 | * A server side Application is installed on xwiki.org, allowing us to query the data sent and to display a counter of Active Installs of XWiki (i.e. installs for which we've received a ping in the last N days, for example at least one ping in the past month). | ||
| 36 | |||
| 37 | The data sent is anonymous and consists of the following: | ||
| 38 | |||
| 39 | * A unique id (UUID) representing the XWiki instance. Note that not even the IP is kept and there's no way to find who's having a give UUID (it's generated using Java's UUID implementation) | ||
| 40 | * The date of the ping | ||
| 41 | * The version of your XWiki distribution | ||
| 42 | * The technical ids and versions of extensions you have installed. | ||
| 43 | |||
| 44 | This will allow us to present the following data: | ||
| 45 | |||
| 46 | * Number of total installs of XWiki | ||
| 47 | * Number of Active Installs | ||
| 48 | * Most used extensions across versions of XWiki | ||
| 49 | * How frequently the XWiki user base upgrades to newer versions of XWiki | ||
| 50 | |||
| 51 | {{info}} | ||
| 52 | In the near future we'll offer a UI feature to opt-out (in the Administration pages) but at the moment if you wish to opt-out (please don't, we need your help, knowing who's using us and that it's growing is what keeps us motivated to continue developing XWiki!), then simply remove the ##WEB-INF/lib/xwiki-platform-activeinstalls*## JAR and restart. | ||
| 53 | {{/info}} | ||
| 54 | |||
| 55 | Reference documentation is [[available here>>extensions:Extension.Active Installs Module]]. | ||
| 56 | |||
| 57 | == Miscellaneous == | ||
| 58 | |||
| 59 | * The ##line## [[chart>>doc:extensions:Extension.Chart Macro]] type has two parameters, ##hideShapes## and ##hideLines##, to hide the shapes used to display the data points or to hide the interpolation lines that connect the data points.((( | ||
| 60 | {{image reference="lineWithoutShapes.png"/}} | ||
| 61 | ))) | ||
| 62 | * When creating or editing a [[template provider>>doc:extensions:Extension.Administration Application||anchor="HCreatethetemplateprovider"]] the template name field is now mandatory.((( | ||
| 63 | {{image reference="templateNameMandatory.png"/}} | ||
| 64 | ))) | ||
| 65 | * New [[Instance Module>>extensions:Extension.Instance Module]] used to compute a unique id for each XWiki instance (used by the [[Active Installs feature>>extensions:Extension.Active Installs Module]] | ||
| 66 | |||
| 67 | 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+%22<version>%22&tempMax=1000]] fixed in this release. | ||
| 68 | |||
| 69 | = For Developers = | ||
| 70 | |||
| 71 | == Forcing IE Compatibility mode == | ||
| 72 | |||
| 73 | Now, we force the Compatibility mode for Internet Explorer (IE) browsers to use the latest rendering mode. | ||
| 74 | Before, the IE browser displayed all intranet sites in compatibility mode by default. This means that even if the user was using IE9, he saw the content rendered with IE7 standards. Since we don't [[support>>dev:Community.BrowserSupportStrategy]] IE6/7 anymore this lead in displaying broken layout, scrollbars, etc. See [[XWIKI-8907>>http://jira.xwiki.org/browse/XWIKI-8907]]. | ||
| 75 | |||
| 76 | == Choosing which types of attachments can be displayed inline (Security) == | ||
| 77 | |||
| 78 | In order to prevent XSS via FileUpload, a new feature has been added : you can now specify in xwiki.properties which types of attachment can be displayed inline. | ||
| 79 | In the "Attachment" section of xwiki.properties, you can either precise a whitelist of mimetypes that can be displayed inline, or precise a blacklist of mimetypes that shouldn't be displayed inline (if you use this configuration, it is strongly advised to blacklist at least "text/html" and "text/javascript" mimetypes for security reasons). | ||
| 80 | Note that attachments provided by PR users won't be affected by these restrictions. | ||
| 81 | |||
| 82 | == Deprecated and Retired projects == | ||
| 83 | |||
| 84 | <description of deprecated and retired projects> | ||
| 85 | |||
| 86 | == Upgrades == | ||
| 87 | |||
| 88 | The following dependencies have been upgraded: | ||
| 89 | |||
| 90 | * [[HSQLDB 2.3.0>>http://jira.xwiki.org/browse/XE-1323]] | ||
| 91 | * [[Groovy 2.1.7>>http://jira.xwiki.org/browse/XCOMMONS-445]] | ||
| 92 | |||
| 93 | == Miscellaneous == | ||
| 94 | |||
| 95 | * Added support for custom facets in Solr search API | ||
| 96 | |||
| 97 | = Translations = | ||
| 98 | |||
| 99 | The following translations have been updated: | ||
| 100 | |||
| 101 | {{language codes="none, none"/}} | ||
| 102 | |||
| 103 | = Tested Browsers & Databases = | ||
| 104 | |||
| 105 | {{include reference="TestReports.ManualTestReportXWiki52M2Summary"/}} | ||
| 106 | |||
| 107 | = Known issues = | ||
| 108 | |||
| 109 | * [[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]] | ||
| 110 | |||
| 111 | = Backward Compatibility and Migration Notes = | ||
| 112 | |||
| 113 | == General Notes == | ||
| 114 | |||
| 115 | You may also want to [[import the default wiki XAR>>Main.Download]] in order to benefit from all the improvements listed above. | ||
| 116 | |||
| 117 | {{warning}} | ||
| 118 | 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. | ||
| 119 | {{/warning}} | ||
| 120 | |||
| 121 | == Issues specific to XWiki <version> == | ||
| 122 | |||
| 123 | <issues specific to the project> | ||
| 124 | |||
| 125 | == API Breakages == | ||
| 126 | |||
| 127 | The following APIs were modified since <project> <version - 1>: | ||
| 128 | |||
| 129 | {{code language="none"}} | ||
| 130 | <clirr output here> | ||
| 131 | {{/code}} |
