Wiki source code of Release Notes for XWiki 8.2-rc-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 | |||
| 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 | |||
 |
39.1 | 7 | This release integrates CKEditor as the default WYSIWYG content editor and adds a //tour// on the home page to describe the XWiki user interface to newcomers. |
| |
1.1 | 8 | |
| |
42.2 | 9 | = New and Noteworthy (since XWiki 8.2 Milestone 2) = |
| |
1.1 | 10 | |
| |
45.1 | 11 | [[Full list of issues fixed and Dashboard for 8.2>>https://jira.xwiki.org/secure/Dashboard.jspa?selectPageId=13615]]. |
| |
1.1 | 12 | |
 |
11.2 | 13 | == Tour for Homepage == |
| |
1.1 | 14 | |
 |
18.1 | 15 | A [[tour>>extensions:Extension.Tour Application]] has been created to present the existing UI elements from the home page. Every user will be guided through this tour in order to become familiar with XWiki. |
| |
1.1 | 16 | |
| |
11.2 | 17 | {{image reference="step4.png" width="600px;"/}} |
| 18 | |||
| |
32.1 | 19 | == CKEditor Becomes the Default WYSIWYG Editor == |
| 20 | |||
| |
35.1 | 21 | Starting with this version we have a new WYSIWYG editor: the [[CKEditor>>extensions:Extension.CKEditor Integration]]. The integration with CKEditor was already available as an extension and now this extension is bundled with the standard XWiki distribution. |
| |
32.1 | 22 | |
| |
37.1 | 23 | {{image reference="ckeditor.png" width="600"/}} |
| |
35.1 | 24 | |
| 25 | The old WYSIWYG editor is still available and if you want to switch back to it you can do it from the "Edit Mode Settings" section in the wiki administration. | ||
| 26 | |||
| |
37.1 | 27 | {{image reference="defaultWysiwygEditorConfig.png" width="600"/}} |
| |
32.1 | 28 | |
| |
1.1 | 29 | == Miscellaneous == |
| 30 | |||
 |
25.3 | 31 | * Removed ##Main.Welcome## page from the Dashboard since we now have a new Homepage that contains the welcome messages |
| 32 | * In the TemplateProviderClass, 2 new properties have been added: //description// and //icon//, in order to display additional information in template providers list.((( | ||
| |
22.1 | 33 | {{gallery}} |
| 34 | image:templates.png | ||
| 35 | image:templateView.png | ||
| 36 | image:templateEdit.png | ||
| |
26.1 | 37 | {{/gallery}} |
| |
25.3 | 38 | ))) |
| |
30.1 | 39 | * events produced during Filter conversion job are now folded by default. This essentially means that they won't appear in Activity Stream anymore. |
| |
22.1 | 40 | |
| |
45.1 | 41 | 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%29+and+status+%3D+Closed+and+resolution+%3D+Fixed+and+fixVersion+%3D+%228.2-rc-1%22&tempMax=1000]] fixed in this release. |
| |
1.1 | 42 | |
| 43 | = For Developers = | ||
| 44 | |||
| |
38.1 | 45 | == Associate Editors to Data Types == |
| 46 | |||
| 47 | This version introduces a new module that provides APIs to associate editors to data types. For instance you can associate a date picker to ##java.util.Date##, or a WYSIWYG editor to ##org.xwiki.rendering.block.XDOM##. There can be multiple editors available for a specific data type and the user or the administrator can configure the preferred one. Checkout the [[Edit Module>>extensions:Extension.Edit Module]] documentation for more details. This new API has been used to embed CKEditor as the default WYSIWYG editor. | ||
| 48 | |||
| |
28.1 | 49 | == Instance Filter improvements == |
| |
27.1 | 50 | |
| |
29.1 | 51 | * Instance Output Filter now support missing begin/end event on document locale and revision so input filter for which those two concept don't make sense don't have to send them anymore. |
| 52 | * Instance Output Filter now use the context locale as default locale (used to be empty locale). | ||
| |
27.1 | 53 | |
| |
1.1 | 54 | == Deprecated and Retired projects == |
| 55 | |||
| |
3.1 | 56 | === MediaWiki parser === |
| |
1.1 | 57 | |
| |
20.1 | 58 | ##xwiki-rendering-syntax-mediawiki## has been deprecated and moved to https://github.com/xwiki-contrib/syntax-mediawiki-1.0. |
| |
3.1 | 59 | |
| |
5.1 | 60 | It's now recommended to use [[MediaWiki Syntax extension>>extensions:Extension.MediaWiki.MediaWiki Syntax]] instead. |
| |
3.1 | 61 | |
| |
1.1 | 62 | == Upgrades == |
| 63 | |||
| 64 | The following dependencies have been upgraded: | ||
| 65 | |||
| |
45.1 | 66 | * [[Guice 4.1.0>>https://jira.xwiki.org/browse/XCOMMONS-1004]] |
| 67 | * [[Commons Compress 1.12>>https://jira.xwiki.org/browse/XCOMMONS-1005]] | ||
| 68 | * [[httpasyncclient 4.1.2>>https://jira.xwiki.org/browse/XCOMMONS-1009]] | ||
| 69 | * [[JGroups 3.6.10>>https://jira.xwiki.org/browse/XWIKI-13532]] | ||
| 70 | * [[Less4j 1.17.2>>https://jira.xwiki.org/browse/XWIKI-13119]] | ||
| 71 | * [[Infinispan 8.2.3>>https://jira.xwiki.org/browse/XWIKI-13561]] | ||
| |
1.1 | 72 | |
| 73 | == Miscellaneous == | ||
| 74 | |||
| |
7.1 | 75 | * new ##org.xwiki.rendering.listener.SectionGeneratorListener## to generate section events from headers events |
| |
14.1 | 76 | * Instance Output filter now indicate the target syntax for Input filters producing rendering events |
| |
15.1 | 77 | * The same relative file path supported for ##source## filter properties parameter is now supported for any InputSource filter properties parameter in the Filter test framework |
| |
31.2 | 78 | * ##$regextool## [[Velocity Tool>>extensions:Extension.Velocity Module||anchor="HVelocityTools"]] has a new method to quote the replacement string in ##String#replaceAll()##. Here's how you can use it:((( |
| |
31.1 | 79 | {{code language="none"}} |
| 80 | #set ($out = $out.replaceAll(" (id|for)=('|"")$regextool.quote($oldId)", | ||
| 81 | " ${escapetool.d}1=${escapetool.d}2$regextool.quoteReplacement($newId)")) | ||
| 82 | {{/code}} | ||
| 83 | ))) | ||
| |
1.1 | 84 | |
| 85 | = Translations = | ||
| 86 | |||
| 87 | The following translations have been updated: | ||
| 88 | |||
| |
40.1 | 89 | {{language codes="fr, nl"/}} |
| |
1.1 | 90 | |
| 91 | = Tested Browsers & Databases = | ||
| 92 | |||
 |
43.1 | 93 | {{include reference="TestReports.ManualTestReportSummaryXWiki82RC1"/}} |
| |
1.1 | 94 | |
| 95 | = Known issues = | ||
| 96 | |||
| |
45.1 | 97 | * [[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 | 98 | |
| 99 | = Backward Compatibility and Migration Notes = | ||
| 100 | |||
| 101 | == General Notes == | ||
| 102 | |||
| 103 | 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. | ||
| 104 | |||
| |
39.2 | 105 | == Issues specific to XWiki 8.2RC1 == |
| |
1.1 | 106 | |
| |
39.2 | 107 | We refactored the way in which the editors are loaded for page content and TextArea properties. We're now using the new [[Edit API>>extensions:Extension.Edit Module]]. The following breaking changes have been done: |
| |
44.1 | 108 | |
| |
39.2 | 109 | * ##textarea_text.vm## and ##textarea_wysiwyg.vm## Velocity templates have been removed. In case you have customized these templates you can port the changes to the new editor templates available in ##/templates/editors/xdom*.vm## |
| 110 | * ##$xcontext.getEditorWysiwyg()## has been deprecated and is now returning ##null## all the time (which translates into "no TextArea fields that need a WYSIWYG editor"). If you were using this method to customize the WYSIWYG editor then you can do the same from the new editor templates available in ##/templates/editors/xdom*.vm## | ||
| |
1.1 | 111 | |
| |
39.2 | 112 | A side effect of this refactoring is that the Object and Class editors are now using the configured preferred editor, unless it is overwritten using the "editor" meta property. |
| |
44.1 | 113 | |
| |
39.2 | 114 | * If you have a TextArea property that doesn't support wiki syntax then best is to configure the xclass to use the //PureText// editor for this property. |
| 115 | * If the TextArea property supports wiki syntax but it's mostly code (e.g. Velocity, HTML) then best is to configure the Text editor. | ||
| 116 | * Finally, if the TextArea property supports wiki syntax and it's mostly free text then best is to configure the WYSIWYG editor. | ||
| 117 | |||
| |
1.1 | 118 | == API Breakages == |
| 119 | |||
| |
39.2 | 120 | The following APIs were modified since XWiki 8.1: |
| |
1.1 | 121 | |
| |
41.1 | 122 | {{backwardCompatiblityReport version="8.2-rc-1"/}} |
| |
42.1 | 123 | |
| 124 | = Credits = | ||
| 125 | |||
| 126 | The following people have contributed code to this release (sorted alphabetically): | ||
| 127 | |||
| 128 | * Alexandru Cotiuga | ||
| 129 | * Anca Luca | ||
| 130 | * Ecaterina Moraru (Valica) | ||
| 131 | * Eduard Moraru | ||
| 132 | * Guillaume Delhumeau | ||
| 133 | * Marius Dumitru Florea | ||
| 134 | * Raluca Stavro | ||
| 135 | * Thomas Mortagne | ||
| 136 | * Vincent Massol |
