Wiki source code of Release Notes XWiki 7.4 Milestone 1
Version 28.1 by Vincent Massol on 2015/11/30
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 7.3) = | ||
| 10 | |||
| 11 | [[Full list of issues fixed and Dashboard for 7.4>>http://jira.xwiki.org/secure/Dashboard.jspa?selectPageId=13590]]. | ||
| 12 | |||
| 13 | == Notifications & Watchlist == | ||
| 14 | |||
| 15 | * A new menu has been added to the top bar, on the right: the "notifications" menu (represented by a bell). In the future, it will be the place where you can find notifications about some events happening on the wiki (personal message, a page has been modified, etc...).((( | ||
| 16 | {{image reference="Notifications.png"/}} | ||
| 17 | ))) | ||
| 18 | * In this menu, we have moved the Watchlist icons (watch this page, watch this wiki, etc...). These actions can be triggered with the new switch buttons((( | ||
| 19 | {{image reference="WatchList-Notifications.png"/}} | ||
| 20 | ))) | ||
| 21 | |||
| 22 | == Miscellaneous == | ||
| 23 | |||
| 24 | * Some [[bootswatch themes>>extensions:Extension.Bootswatch Themes for Flamingo]] have now a more accurate logo. | ||
| 25 | * When the search button on the top menu is clicked, it now closes all other menus. | ||
| 26 | * The Sandbox now uses the last XWiki 2.1 syntax. | ||
| 27 | * Non terminal pages are now exported with their corresponding ##WebPreferences## page | ||
| 28 | |||
| 29 | 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+%227.4-milestone-1%22&tempMax=1000]] fixed in this release. | ||
| 30 | |||
| 31 | = For Developers = | ||
| 32 | |||
| 33 | == Tree Velocity Macros == | ||
| 34 | |||
| 35 | You are now able to "call" the Document Tree from Velocity using something like this: | ||
| 36 | |||
| 37 | {{code language="none"}} | ||
| 38 | #documentTree({ | ||
| 39 | 'class': 'location-tree', | ||
| 40 | 'finder': true, | ||
| 41 | 'showAttachments': false, | ||
| 42 | 'showRoot': $showRoot, | ||
| 43 | 'showTerminalDocuments': false, | ||
| 44 | 'showTranslations': false, | ||
| 45 | 'showWikis': $showWikis | ||
| 46 | }) | ||
| 47 | {{/code}} | ||
| 48 | |||
| 49 | The same is possible with the generic Tree Widget: | ||
| 50 | |||
| 51 | {{code language="none"}} | ||
| 52 | #tree({ | ||
| 53 | 'reference': 'XWiki.DocumentTree', | ||
| 54 | 'root': 'document:xwiki:Sandbox.WebHome', | ||
| 55 | 'openTo': 'document:xwiki:Sandbox.TestPage2' | ||
| 56 | }) | ||
| 57 | {{/code}} | ||
| 58 | |||
| 59 | All the parameters that are available for the wiki macros (##~{~{documentTree}}## and ##~{~{tree}}##) should be available also for the corresponding Velocity macro. | ||
| 60 | |||
| 61 | == Miscellaneous == | ||
| 62 | |||
| 63 | * An extension point to add content inside the new "Notifications" menu has been added:((( | ||
| 64 | |=##[[org.xwiki.platform.notifications>>platform:ExtensionPoint.Notifications]]## | ||
| 65 | |{{image reference="NotificationsInside.png"/}} | ||
| 66 | ))) | ||
| 67 | * A new ##extractFirstReference(EntityType)## API has been added to ##EntityReference##: Extract the first entity of the given type from this one by traversing the current entity to the root. This differentiates it from ##extractReference(EntityType)## which extracts the last entity of the given type. | ||
| 68 | * The escape Velocity tool has a new method to escape CSS identifiers. This is similar to ##CSS.escape()## available in JavaScript, and is useful if you want to create CSS selectors dynamicaly using untrusted input.((( | ||
| 69 | {{code language="none"}} | ||
| 70 | $escapetool.css('a#b.c d[e=f]g{h:i;j}k') | ||
| 71 | ## Output: a\\#b\\.c\\ d\\[e\\=f\\]g\\{h\\:i\\;j\\}k | ||
| 72 | {{/code}} | ||
| 73 | ))) | ||
| 74 | * The Document Tree Macro has a new parameter to control whether the hidden documents are filtered or not. Set to false to force the display of the hidden documents in the tree.((( | ||
| 75 | {{code language="none"}} | ||
| 76 | {{documentTree filterHiddenDocuments="false" /}} | ||
| 77 | {{/code}} | ||
| 78 | ))) | ||
| 79 | |||
| 80 | == Upgrades == | ||
| 81 | |||
| 82 | The following dependencies have been upgraded: | ||
| 83 | |||
| 84 | * [[slf4j 1.7.13>>http://jira.xwiki.org/browse/XCOMMONS-879]] | ||
| 85 | * [[Joda-Time 2.9.1>>http://jira.xwiki.org/browse/XWIKI-12816]] | ||
| 86 | * [[commons-collections 3.2.2>>http://jira.xwiki.org/browse/XCOMMONS-881]] | ||
| 87 | * [[Maven 3.3.9>>http://jira.xwiki.org/browse/XCOMMONS-883]] | ||
| 88 | * [[Guice 4.0>>http://jira.xwiki.org/browse/XCOMMONS-883]] | ||
| 89 | * [[commons-dbcp2 2.1.1>>http://jira.xwiki.org/browse/XCOMMONS-884]] | ||
| 90 | * [[jboss-logging 3.1.4>>http://jira.xwiki.org/browse/XCOMMONS-885]] | ||
| 91 | * [[Woodstox 4.4.1>>http://jira.xwiki.org/browse/XWIKI-12853]] | ||
| 92 | * [[commons-net 3.4>>http://jira.xwiki.org/browse/XCOMMONS-887]] | ||
| 93 | * [[commons-collections 4.1>>http://jira.xwiki.org/browse/XCOMMONS-889]] | ||
| 94 | |||
| 95 | = Translations = | ||
| 96 | |||
| 97 | The following translations have been updated: | ||
| 98 | |||
| 99 | {{language codes="none, none"/}} | ||
| 100 | |||
| 101 | = Tested Browsers & Databases = | ||
| 102 | |||
| 103 | {{warning}} | ||
| 104 | The QA Tests are executed after the release has been done. Thus, they are being prepared now and will be published soon. | ||
| 105 | {{/warning}} | ||
| 106 | |||
| 107 | {{comment}} | ||
| 108 | TODO: uncomment and update with proper link when the report is ready. | ||
| 109 | {{include reference="TestReports.ManualTestReportTemplateSummary"/}} | ||
| 110 | {{/comment}} | ||
| 111 | |||
| 112 | = Known issues = | ||
| 113 | |||
| 114 | * [[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]] | ||
| 115 | |||
| 116 | = Backward Compatibility and Migration Notes = | ||
| 117 | |||
| 118 | == General Notes == | ||
| 119 | |||
| 120 | 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. | ||
| 121 | |||
| 122 | == Issues specific to XWiki 7.4 Milestone 1 == | ||
| 123 | |||
| 124 | * Better backward-compatibility for URLs has been added for the following 2 cases: | ||
| 125 | ** If the ##view## action is omitted in the URL and the first space name doesn't match an action name, then the "view" action is implied | ||
| 126 | ** The ##view## action can be specified even when the wiki is configured to hide the ##view## action. | ||
| 127 | ** Note that this fixes [[some backward-compatibility issue introduced in XWiki 7.2>>ReleaseNotes.ReleaseNotesXWiki72||anchor="HURLs"]] | ||
| 128 | |||
| 129 | == API Breakages == | ||
| 130 | |||
| 131 | The following APIs were modified since XWiki 7.3: | ||
| 132 | |||
| 133 | {{code language="none"}} | ||
| 134 | <clirr output here> | ||
| 135 | {{/code}} |
