Wiki source code of Release Notes for XWiki 5.0 Milestone 1
Version 42.1 by Sorin Burjan on 2013/03/06
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 | |||
| |
38.2 | 7 | This release is the first release for the 5.x cycle with a new Release application and contains various Extension Manager and Distribution Wizard improvements. |
| |
1.1 | 8 | |
| 9 | = New and Noteworthy (since XWiki 4.5) = | ||
| 10 | |||
 |
36.1 | 11 | [[Full list of issues fixed and Dashboard for 5.0>>http://jira.xwiki.org/secure/Dashboard.jspa?selectPageId=11493]]. |
| 12 | |||
| |
25.1 | 13 | == Release Application == |
| |
1.1 | 14 | |
| |
26.2 | 15 | A new [[Release application>>extensions:Extension.Release Application]] is available to help you in releasing software projects. |
| |
1.1 | 16 | |
| |
25.1 | 17 | {{image reference="release1.png"/}} |
| 18 | |||
 |
33.1 | 19 | == Office Import using the Office Macro == |
| 20 | |||
| 21 | We added an option to the [[WYSIWYG Editor>>platform:Features.WysiwygEditor]]'s Import Office Document dialog to allow you to import an office file using the [[Office Macro>>extensions:Extension.Office Macro]]. This is useful if you don't plan to edit the content of the office file after the import or if you don't want to mix the content of the office file with the content of the wiki page. | ||
| 22 | |||
| 23 | {{image reference="xwe-importOfficeDocumentDialog.png"/}} | ||
| 24 | |||
| 25 | The generated wiki syntax looks like this: | ||
| 26 | |||
| 27 | {{code language="none"}} | ||
| 28 | {{office attachment="presentation.odp"/}} | ||
| |
33.2 | 29 | {{/code}} |
| |
33.1 | 30 | |
| 31 | Of course, you need to have the Office server connected in order to use this feature. | ||
| 32 | |||
| |
37.1 | 33 | == Extension Manager improvements == |
| 34 | |||
| 35 | We added more information to the Description section and we added the ability to retrieve the list of stable versions that are available in the configured extension repositories. | ||
| 36 | |||
| 37 | {{image reference="ReleaseNotesXWiki451@EM-extensionDescription.png" /}} | ||
| 38 | |||
| 39 | We also grouped the action buttons (e.g. Install and Install of farm) as you can see in the image above. This allowed us to move the Apply button that you had to click to confirm an extension action like install from the bottom of the Progress section to the extension actions section. The Install and Install of farm buttons are still available in the drop down menu to allow you recompute the install plan if you want to. | ||
| 40 | |||
| 41 | {{image reference="ReleaseNotesXWiki451@EM-continueInstall.png" /}} | ||
| 42 | |||
| 43 | See the [[Extension Manager Application documentation>>extensions:Extension.Extension Manager Application]] for more information. | ||
| 44 | |||
| 45 | == Distribution Wizard improvements == | ||
| 46 | |||
| 47 | We fixed an important bug in Distribution Wizard ({{jira url="http://jira.xwiki.org" style="enum"}}XWIKI-8749{{/jira}}) that was preventing you from properly upgrading the installed extensions in the second step. We now list extensions by the namespace (wiki) where they have been installed. For now you have to review and upgrade each extension individually. We hope to improve this soon by allowing you upgrade more extensions at once. | ||
| 48 | |||
| 49 | {{image reference="ReleaseNotesXWiki451@DW-upgradeExtensions.png"/}} | ||
| 50 | |||
| |
38.1 | 51 | == Miscellaneous == |
| 52 | |||
| 53 | * Ability to [[more easily create multiple FAQ spaces>>extensions:Extension.FAQ Application||anchor="HCreatemultipleFAQs"]]. | ||
| 54 | * Add support for Numbered Lists and Verbatim for the LaTex Renderer | ||
| 55 | * Increased [[Permgen requirements from recommended 128MB to 196MB>>platform:AdminGuide.Installation]] | ||
| 56 | * The Jetty distribution now uses Jetty 8.1.9.v20130131 | ||
| 57 | * The [[FAQ Application>>extensions:Extension.FAQ Application]] can now be translated into multiple languages + added translation for French. | ||
| 58 | |||
| 59 | 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. | ||
| 60 | |||
| 61 | = For Developers = | ||
| 62 | |||
| |
37.1 | 63 | == Button Group Widget == |
| 64 | |||
| 65 | We added a small widget to group form buttons. | ||
| 66 | |||
| 67 | {{image reference="ReleaseNotesXWiki451@buttonGroup.png"/}} | ||
| 68 | |||
| 69 | It can be used either with a static list of buttons, when you know beforehand that you have more than 1 button and you know the main one, or with a dynamic list of buttons, if you want the buttons to be grouped on the client side if there are more than one. | ||
| 70 | |||
| 71 | The static button group works even with JavaScript disabled (in a modern browser): | ||
| 72 | |||
| 73 | {{code language="html"}} | ||
| 74 | <p class="buttons"> | ||
| 75 | <span class="buttonwrapper button-group"> | ||
| 76 | <button>Action</button><a href="#foo" class="dropdown-toggle" tabindex="0"><span/></a> | ||
| 77 | <span id="foo" class="dropdown-menu"> | ||
| 78 | <button>First item</button> | ||
| 79 | <input type="submit" value="Second item" class="button" /> | ||
| 80 | <a href="#third">Third item</a> | ||
| 81 | </span> | ||
| 82 | </span> | ||
| 83 | </p> | ||
| 84 | {{/code}} | ||
| 85 | |||
| 86 | The dynamic group obviously requires JavaScript. The first button found in the group is considered the main one. The buttons are grouped only if there are more than one. If the main button is secondary then the button group is styled as a secondary button. | ||
| 87 | |||
| 88 | {{code language="html"}} | ||
| 89 | <span class="dynamic-button-group"> | ||
| 90 | <span class="buttonwrapper"> | ||
| 91 | <button>One</button> | ||
| 92 | </span> | ||
| 93 | <span class="buttonwrapper"> | ||
| 94 | <input type="submit" class="button secondary" value="Two" /> | ||
| 95 | </span> | ||
| 96 | <span class="buttonwrapper"> | ||
| 97 | <a href="#three" class="secondary">Three</a> | ||
| 98 | </span> | ||
| 99 | </span> | ||
| 100 | {{/code}} | ||
| 101 | |||
| 102 | In both cases you need to include the widget resources: | ||
| 103 | |||
| 104 | {{code language="none"}} | ||
| 105 | #set ($discard = $xwiki.ssfx.use('uicomponents/widgets/buttonGroup.css', true)) | ||
| 106 | #set ($discard = $xwiki.jsfx.use('uicomponents/widgets/buttonGroup.js')) | ||
| 107 | {{/code}} | ||
| 108 | |||
| |
1.1 | 109 | == Deprecated and Retired projects == |
| 110 | |||
| 111 | <description of deprecated and retired projects> | ||
| 112 | |||
| 113 | == Upgrades == | ||
| 114 | |||
| 115 | The following dependencies have been upgraded: | ||
| 116 | |||
| 117 | * [[XStream 1.4.4>>http://jira.xwiki.org/browse/XCOMMONS-338]] | ||
| |
2.1 | 118 | * [[Tika 1.3>>http://jira.xwiki.org/browse/XWIKI-8788]] |
| |
15.1 | 119 | * [[Groovy 2.1.1>>http://jira.xwiki.org/browse/XCOMMONS-331]] |
| |
4.1 | 120 | * [[httpclient 4.2.3>>http://jira.xwiki.org/browse/XCOMMONS-339]] |
| |
6.1 | 121 | * [[Apache Ivy 2.3.0>>http://jira.xwiki.org/browse/XCOMMONS-340]] |
| |
8.1 | 122 | * [[JGroups 3.2.7.Final>>http://jira.xwiki.org/browse/XWIKI-8790]] |
| |
9.1 | 123 | * [[Liquibase 2.0.5>>http://jira.xwiki.org/browse/XWIKI-8791]] |
| |
12.1 | 124 | * [[Pygments 1.6>>http://jira.xwiki.org/browse/XWIKI-8787]] |
| |
14.1 | 125 | * [[Jython 2.5.4-rc1>>http://jira.xwiki.org/browse/XWIKI-8812]] |
| |
21.1 | 126 | * [[GWT 2.5.0 and SmartGWT 3.1>>http://jira.xwiki.org/browse/XWIKI-8847]] |
| |
1.1 | 127 | |
| 128 | == Miscellaneous == | ||
| 129 | |||
| |
24.1 | 130 | * [[More API added to the Model Script Service>>extensions:Extension.Model Module]] |
| |
27.1 | 131 | * You can now specify a target user or an email address in the share page URL like this: |
| 132 | {{code language="none"}}/xwiki/bin/view/Space/Page?viewer=share&target=foo@bar.org&target=XWiki.mflorea{{/code}} | ||
| |
1.1 | 133 | |
| 134 | = Translations = | ||
| 135 | |||
| 136 | The following translations have been updated: | ||
| 137 | |||
| |
38.2 | 138 | {{language codes="de, fr, lv"/}} |
| |
1.1 | 139 | |
| 140 | = Tested Browsers & Databases = | ||
| 141 | |||
 |
42.1 | 142 | {{include reference="TestReports.ManualTestReportXWiki50M1Summary"/}} |
| |
1.1 | 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 | = Test Report = | ||
| 149 | |||
| 150 | 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. | ||
| 151 | |||
| 152 | = Backward Compatibility and Migration Notes = | ||
| 153 | |||
| 154 | == General Notes == | ||
| 155 | |||
| 156 | You may also want to [[import the default wiki XAR>>Main.Download]] in order to benefit from all the improvements listed above. | ||
| 157 | |||
| 158 | {{warning}} | ||
| 159 | 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. | ||
| 160 | {{/warning}} | ||
| 161 | |||
| |
18.1 | 162 | == Issues specific to XWiki 5.0 Milestone 1 == |
| |
1.1 | 163 | |
| |
18.1 | 164 | * the default resolver used by the model script service moved from ##currentmixed## to ##current##. In practice it means ##$services.model.resolveDocument('')## will now return a document reference with ##currentwiki:currentspace.currentdocument## instead of ##currentwiki:currentspace.WebHome##. See [[XWIKI-8834>>http://jira.xwiki.org/browse/XWIKI-8834]] for more details. |
| |
1.1 | 165 | |
| 166 | == API Breakages == | ||
| 167 | |||
| |
38.4 | 168 | The following APIs were modified since XWiki 4.5.1: |
| |
1.1 | 169 | |
| 170 | {{code language="none"}} | ||
| |
40.1 | 171 | org.xwiki.job.AbstractJob: Class org.xwiki.job.AbstractJob removed |
| |
41.1 | 172 | org.xwiki.rendering.block.MetaDataBlock: Return type of method 'public org.xwiki.rendering.block.Block clone()' has been changed to org.xwiki.rendering.block.MetaDataBlock |
| 173 | org.xwiki.rendering.block.MetaDataBlock: Return type of method 'public java.lang.Object clone()' has been changed to org.xwiki.rendering.block.Block | ||
| 174 | org.xwiki.rendering.block.XDOM: Return type of method 'public org.xwiki.rendering.block.Block clone()' has been changed to org.xwiki.rendering.block.MetaDataBlock | ||
| 175 | org.xwiki.rendering.block.XDOM: Return type of method 'public java.lang.Object clone()' has been changed to org.xwiki.rendering.block.Block | ||
| |
1.1 | 176 | {{/code}} |
