Wiki source code of Release Notes for XWiki 8.0 Release Candidate 1
Version 28.1 by Manuel Smeria on 2016/03/14
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 | |||
 |
26.1 | 7 | This release candidate brings a couple of improvements, notably the ability to register a user from the Distribution Wizard and to auto-generate the main wiki descriptor at start up. The Chart Macro comes with new parameters and the UI for page rename/copy has better labels. On the technical side, this release brings the first, experimental, version of the minimalistic XWiki distribution. |
| |
1.1 | 8 | |
| 9 | = New and Noteworthy (since XWiki 8.0 Milestone 2) = | ||
| 10 | |||
| 11 | [[Full list of issues fixed and Dashboard for 8.0>>http://jira.xwiki.org/secure/Dashboard.jspa?selectPageId=13593]]. | ||
| 12 | |||
 |
18.1 | 13 | == New XWiki distribution == |
| 14 | |||
| |
23.2 | 15 | The work on a new as small as possible distribution of XWiki has started. The key goal is to try to have a WAR as small as possible on which you install one of the Flavors automatically found in the registered repositories (meaning http://extensions.xwiki.org/ for now). |
| |
18.1 | 16 | |
| 17 | The size is still not very far from XE (188M compared to the 219M XE), one important limitation is that we kept some old plugins because they are hard to install as extensions (you need to modify xwiki.cfg and restart). We need to convert them to proper components so that we can move them to contrib as "pure" extensions. | ||
| 18 | |||
 |
27.1 | 19 | There is still two important known limitation in that version that we hope to have in 8.0 final or 8.1 at worst: |
| |
22.1 | 20 | |
| |
23.3 | 21 | * make flavors search in the Distribution Wizard asynchronous, the step is blocked for a long time right now which is not very nice |
| |
18.1 | 22 | * support upgrade of invalid flavor (search for a valid replacement in that case) |
| 23 | |||
| |
23.3 | 24 | It's still experimental and should be avoided in production but the move has started and we are very excited by the new opportunity this will bring! |
| |
18.1 | 25 | |
| 26 | == Custom admin user to replace standard Admin user == | ||
| 27 | |||
| |
23.4 | 28 | Since XWiki exists you got a user ##Admin## with password ##admin## in the default XAR. This time is now gone and you are now asked to register your own user which will be the owner of the wiki (meaning whatever you do you can't loose admin right on it, unless you change the owner) when you install XWiki from scratch. We kept a standard ##Admin## user for the all in one jetty/hsqldb package so the change won't be visible in this one. |
| |
18.1 | 29 | |
| |
22.1 | 30 | {{image reference="newwelcome.png"/}} |
| 31 | |||
| |
18.1 | 32 | {{image reference="customuser.png"/}} |
| 33 | |||
| |
19.1 | 34 | == Automatically generated main wiki descriptor == |
| |
18.1 | 35 | |
| 36 | The XE XAR does not contain any descriptor for the main wiki anymore. This descriptor is now automatically created/updated at start and associated to the domain name found in the URL that was used to access the wiki the first time. | ||
| 37 | |||
| |
14.1 | 38 | == Chart Macro Additions == |
| |
1.1 | 39 | |
| |
14.1 | 40 | There are several new parameters that can now be set when using the [[Chart Macro>>extensions:Extension.Chart Macro]]: |
| |
1.1 | 41 | |
| |
14.1 | 42 | |=Parameter name|=Default value|=Description |
| 43 | |##backgroundColor##|Grey background|Background color of the non-chart area, specified using an hexadecimal notation, e.g. ##FFAACC## (first 2 letters are for Red, following 2 are for Green and last 2 are for Blue). | ||
| 44 | |##plotBackgroundColor##|White|Background color of the plot area, specified using an hexadecimal notation (see ##backgroundColor##). | ||
| 45 | |##plotBorderColor##|Black|Color of the plot border, specified using an hexadecimal notation (see ##backgroundColor##). | ||
| 46 | |##borderColor##|Black|Color of the outer graph border, specified using an hexadecimal notation (see ##backgroundColor##). | ||
| 47 | |##legendBackgroundColor##|White|Background color of the legend box, specified using an hexadecimal notation (see ##backgroundColor##). | ||
| 48 | |##plotBorderVisible##|true|Whether the border for the plot area is visible or not. Valid values are ##true## and ##false##. | ||
| 49 | |##legendVisible##|true|Whether the legend is displayed or not. Valid values are ##true## and ##false##. | ||
| |
1.1 | 50 | |
| |
14.1 | 51 | Examples: |
| 52 | |||
| 53 | * Pie chart with no legend displayed, no border, no title and white background:((( | ||
| 54 | {{code}} | ||
| 55 | {{chart type="pie" source="inline" params="range:B2-D5;series:columns;backgroundColor:FFFFFF;plotBackgroundColor:FFFFFF;plotBorderVisible:false;legendVisible:false" width="320" height="240"}} | ||
| 56 | |=|=X|=Y|=Z | ||
| 57 | |Q1|1.2|3.4|1.3 | ||
| 58 | |Q2|4.5|3.4|2.3 | ||
| 59 | |Q3|1.2|4.5|9.0 | ||
| 60 | |Q4|3.4|1.2|1.2 | ||
| 61 | {{/chart}} | ||
| 62 | {{/code}} | ||
| 63 | |||
| 64 | {{image reference="pieChartWhite.png"/}} | ||
| 65 | ))) | ||
| 66 | * Colored background:((( | ||
| |
16.2 | 67 | {{code}} |
| |
14.1 | 68 | {{chart type="pie" source="inline" params="range:B2-D5;series:columns;backgroundColor:FFFF11;plotBackgroundColor:11FFFF" title="Chart Test" width="320" height="240"}} |
| 69 | |=|=X|=Y|=Z | ||
| 70 | |Q1|1.2|3.4|1.3 | ||
| 71 | |Q2|4.5|3.4|2.3 | ||
| 72 | |Q3|1.2|4.5|9.0 | ||
| 73 | |Q4|3.4|1.2|1.2 | ||
| 74 | {{/chart}} | ||
| |
16.2 | 75 | {{/code}} |
| |
14.1 | 76 | |
| 77 | {{image reference="pieChartColor.png"/}} | ||
| 78 | ))) | ||
| 79 | |||
| |
17.2 | 80 | In addition, it's now possible to perform [[advanced customization of the generated chart>>extensions:Extension.Chart Macro||anchor="HAdvancedCustomization"]]. |
| |
17.1 | 81 | |
| |
14.1 | 82 | == Rename and Copy UI == |
| 83 | |||
 |
12.5 | 84 | * Updated the rename page UI's field labels and descriptions to mention that the update links also updates the relative links inside the renamed page and not just the backlinks. Also moved the count displays from the field label to the field's description, where applicable, in both the rename and the copy UI, for better UI consistency.((( |
| |
12.2 | 85 | {{image reference="renameRewording-Step1.png"/}} |
| |
13.2 | 86 | |
| |
12.5 | 87 | {{image reference="copyRewording-Step1.png"/}} |
| |
12.2 | 88 | ))) |
| |
13.3 | 89 | * The copy and rename UI now have the children and links options checked by default. We believe it`s better to preserve data consistency by default, even with the cost o having to go through lengthy operations (like when renaming a document with many children). |
| |
12.2 | 90 | |
| |
14.1 | 91 | == Miscellaneous == |
| 92 | |||
| |
23.1 | 93 | * main wiki owner now have programming rights and not only admin rights |
| |
1.1 | 94 | |
| |
1.2 | 95 | 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+%228.0-rc-1%22&tempMax=1000]] fixed in this release. |
| |
1.1 | 96 | |
| 97 | = For Developers = | ||
| 98 | |||
| 99 | == Upgrades == | ||
| 100 | |||
| 101 | The following dependencies have been upgraded: | ||
| 102 | |||
| |
3.1 | 103 | * [[Pygments 2.1.1>>http://jira.xwiki.org/browse/XWIKI-13019]] |
| |
4.1 | 104 | * [[org.eclipse.sisu.plexus 0.3.3>>https://jira.xwiki.org/browse/XCOMMONS-920]] |
| |
5.1 | 105 | * [[Tika 1.12>>http://jira.xwiki.org/browse/XWIKI-13104]] |
| |
6.2 | 106 | * [[Groovy 2.4.6>>http://jira.xwiki.org/browse/XCOMMONS-918]] |
| |
7.1 | 107 | * [[JGroups 3.6.8>>http://jira.xwiki.org/browse/XWIKI-13146]] |
| |
8.1 | 108 | * [[httpclient 4.5.2>>http://jira.xwiki.org/browse/XCOMMONS-924]] |
| |
9.1 | 109 | * [[slf4j 1.7.18>>http://jira.xwiki.org/browse/XCOMMONS-925]] |
| |
10.1 | 110 | * [[Jackson 2.7.2>>http://jira.xwiki.org/browse/XCOMMONS-926]] |
| |
11.1 | 111 | * [[logback 1.1.6>>http://jira.xwiki.org/browse/XCOMMONS-927]] |
| |
1.1 | 112 | |
| 113 | == Miscellaneous == | ||
| 114 | |||
 |
2.1 | 115 | * Developers can now enable the [[CSS Source Maps feature in the LESS Module>>extensions:Extension.LESS Module||anchor="HDebuggingLESSfileswithCSSSourceMaps"]], to help the CSS debugging. |
| |
1.1 | 116 | |
| 117 | = Translations = | ||
| 118 | |||
| 119 | The following translations have been updated: | ||
| 120 | |||
| |
24.1 | 121 | {{language codes="da, fr, lv, pl, pt_BR, sk"/}} |
| |
1.1 | 122 | |
| 123 | = Tested Browsers & Databases = | ||
| 124 | |||
| 125 | {{warning}} | ||
| 126 | The QA Tests are executed after the release has been done. Thus, they are being prepared now and will be published soon. | ||
| 127 | {{/warning}} | ||
| 128 | |||
| 129 | {{comment}} | ||
| 130 | TODO: uncomment and update with proper link when the report is ready. | ||
 |
28.1 | 131 | {{include reference="TestReports.ManualTestReportSummaryXWiki80RC1"/}} |
| |
1.1 | 132 | {{/comment}} |
| 133 | |||
| 134 | = Known issues = | ||
| 135 | |||
| 136 | * [[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]] | ||
| 137 | |||
| 138 | = Backward Compatibility and Migration Notes = | ||
| 139 | |||
| 140 | == General Notes == | ||
| 141 | |||
| 142 | 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. | ||
| 143 | |||
| 144 | == API Breakages == | ||
| 145 | |||
| |
23.5 | 146 | The following APIs were modified since XWiki 7.4.2: |
| |
1.1 | 147 | |
| |
25.1 | 148 | * Allow associating a version different from the extension version to the features and allow indicating namespace constraint in an extension((( |
| |
1.1 | 149 | {{code language="none"}} |
| |
25.1 | 150 | org.xwiki.extension.Extension: Method 'public java.util.Collection getAllowedNamespaces()' has been added to an interface |
| 151 | org.xwiki.extension.Extension: Method 'public org.xwiki.extension.ExtensionId getExtensionFeature(java.lang.String)' has been added to an interface | ||
| 152 | org.xwiki.extension.Extension: Method 'public java.util.Collection getExtensionFeatures()' has been added to an interface | ||
| |
1.1 | 153 | {{/code}} |
| |
25.1 | 154 | ))) |
| 155 | |||
| 156 | * Deprecating this class in favor of the standard library class with the same name((( | ||
| 157 | {{code language="none"}} | ||
| 158 | org.xwiki.velocity.introspection.AbstractChainableUberspector: Removed field inner | ||
| 159 | org.xwiki.velocity.introspection.DeprecatedCheckUberspector: Removed org.xwiki.velocity.introspection.ChainableUberspector from the set of implemented interface | ||
| 160 | org.xwiki.velocity.introspection.DeprecatedCheckUberspector: Removed org.xwiki.velocity.introspection.AbstractChainableUberspector from the list of superclasse | ||
| 161 | org.xwiki.velocity.introspection.MethodArgumentsUberspector: Removed org.xwiki.velocity.introspection.ChainableUberspector from the set of implemented interface | ||
| 162 | org.xwiki.velocity.introspection.MethodArgumentsUberspector: Removed org.xwiki.velocity.introspection.AbstractChainableUberspector from the list of superclasse | ||
| 163 | {{/code}} | ||
| 164 | ))) | ||
| 165 | |||
| 166 | * Young API. Better name((( | ||
| 167 | {{code language="none"}} | ||
| 168 | org.xwiki.platform.flavor.FlavorManager: Method 'public org.xwiki.extension.repository.result.IterableResult searchFlavors(org.xwiki.platform.flavor.FlavorQuery)' has been added to an interface | ||
| 169 | {{/code}} | ||
| 170 | ))) | ||
| 171 | |||
| 172 | * Not really a breackage. Just moved to its own module.((( | ||
| 173 | {{code language="none"}} | ||
| 174 | com.xpn.xwiki.plugin.diff.DiffPlugin: Class com.xpn.xwiki.plugin.diff.DiffPlugin removed | ||
| 175 | com.xpn.xwiki.plugin.diff.DiffPluginApi: Class com.xpn.xwiki.plugin.diff.DiffPluginApi removed | ||
| 176 | {{/code}} | ||
| 177 | ))) | ||
| 178 | |||
| 179 | * Removed constant that shouldn't have been there((( | ||
| 180 | {{code language="none"}} | ||
| 181 | org.xwiki.chart.ChartGenerator: Field COLORS_PARAM has been removed, but it was previously a constant | ||
| 182 | {{/code}} | ||
| 183 | ))) |
