Wiki source code of Release Notes XWiki 7.4 Milestone 1
Version 27.2 by Marius Dumitru Florea 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 <version - 1>) = | ||
| 10 | |||
| 11 | [[Full list of issues fixed and Dashboard for <version>>>http://jira.xwiki.org/secure/Dashboard.jspa?selectPageId=<fill id here>]]. | ||
| 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 | |||
| 19 | * 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:((( | ||
| 20 | {{image reference="WatchList-Notifications.png"/}} | ||
| 21 | ))) | ||
| 22 | |||
| 23 | == Miscellaneous == | ||
| 24 | |||
| 25 | * Some [[bootswatch themes>>extensions:Extension.Bootswatch Themes for Flamingo]] have now a more accurate logo. | ||
| 26 | * When the search button on the top menu is clicked, it now closes all other menus. | ||
| 27 | * The Sandbox now uses the last XWiki 2.1 syntax. | ||
| 28 | * Non terminal pages are now exported with their corresponding ##WebPreferences## page | ||
| 29 | |||
| 30 | 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. | ||
| 31 | |||
| 32 | = For Developers = | ||
| 33 | |||
| 34 | == Tree Velocity Macros == | ||
| 35 | |||
| 36 | You are now able to "call" the Document Tree from Velocity using something like this: | ||
| 37 | |||
| 38 | {{code language="none"}} | ||
| 39 | #documentTree({ | ||
| 40 | 'class': 'location-tree', | ||
| 41 | 'finder': true, | ||
| 42 | 'showAttachments': false, | ||
| 43 | 'showRoot': $showRoot, | ||
| 44 | 'showTerminalDocuments': false, | ||
| 45 | 'showTranslations': false, | ||
| 46 | 'showWikis': $showWikis | ||
| 47 | }) | ||
| 48 | {{/code}} | ||
| 49 | |||
| 50 | The same is possible with the generic Tree Widget: | ||
| 51 | |||
| 52 | {{code language="none"}} | ||
| 53 | #tree({ | ||
| 54 | 'reference': 'XWiki.DocumentTree', | ||
| 55 | 'root': 'document:xwiki:Sandbox.WebHome', | ||
| 56 | 'openTo': 'document:xwiki:Sandbox.TestPage2' | ||
| 57 | }) | ||
| 58 | {{/code}} | ||
| 59 | |||
| 60 | All the parameters that are available for the wiki macros (##~{~{documentTree}}## and ##~{~{tree}}##) should be available also for the corresponding Velocity macro. | ||
| 61 | |||
| 62 | == Deprecated and Retired projects == | ||
| 63 | |||
| 64 | <description of deprecated and retired projects> | ||
| 65 | |||
| 66 | == Upgrades == | ||
| 67 | |||
| 68 | The following dependencies have been upgraded: | ||
| 69 | |||
| 70 | * [[slf4j 1.7.13>>http://jira.xwiki.org/browse/XCOMMONS-879]] | ||
| 71 | * [[Joda-Time 2.9.1>>http://jira.xwiki.org/browse/XWIKI-12816]] | ||
| 72 | * [[commons-collections 3.2.2>>http://jira.xwiki.org/browse/XCOMMONS-881]] | ||
| 73 | * [[Maven 3.3.9>>http://jira.xwiki.org/browse/XCOMMONS-883]] | ||
| 74 | * [[Guice 4.0>>http://jira.xwiki.org/browse/XCOMMONS-883]] | ||
| 75 | * [[commons-dbcp2 2.1.1>>http://jira.xwiki.org/browse/XCOMMONS-884]] | ||
| 76 | * [[jboss-logging 3.1.4>>http://jira.xwiki.org/browse/XCOMMONS-885]] | ||
| 77 | * [[Woodstox 4.4.1>>http://jira.xwiki.org/browse/XWIKI-12853]] | ||
| 78 | * [[commons-net 3.4>>http://jira.xwiki.org/browse/XCOMMONS-887]] | ||
| 79 | * [[commons-collections 4.1>>http://jira.xwiki.org/browse/XCOMMONS-889]] | ||
| 80 | |||
| 81 | == Miscellaneous == | ||
| 82 | |||
| 83 | * An extension point to add content inside the new "Notifications" menu has been added:((( | ||
| 84 | |=##[[org.xwiki.platform.notifications>>platform:ExtensionPoint.Notifications]]## | ||
| 85 | |{{image reference="NotificationsInside.png"/}} | ||
| 86 | ))) | ||
| 87 | * 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. | ||
| 88 | * 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.((( | ||
| 89 | {{code language="none"}} | ||
| 90 | $escapetool.css('a#b.c d[e=f]g{h:i;j}k') | ||
| 91 | ## Output: a\\#b\\.c\\ d\\[e\\=f\\]g\\{h\\:i\\;j\\}k | ||
| 92 | {{/code}} | ||
| 93 | ))) | ||
| 94 | * 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.((( | ||
| 95 | {{code language="none"}} | ||
| 96 | {{documentTree filterHiddenDocuments="false" /}} | ||
| 97 | {{/code}} | ||
| 98 | ))) | ||
| 99 | |||
| 100 | = Translations = | ||
| 101 | |||
| 102 | The following translations have been updated: | ||
| 103 | |||
| 104 | {{language codes="none, none"/}} | ||
| 105 | |||
| 106 | = Tested Browsers & Databases = | ||
| 107 | |||
| 108 | {{warning}} | ||
| 109 | The QA Tests are executed after the release has been done. Thus, they are being prepared now and will be published soon. | ||
| 110 | {{/warning}} | ||
| 111 | |||
| 112 | {{comment}} | ||
| 113 | TODO: uncomment and update with proper link when the report is ready. | ||
| 114 | {{include reference="TestReports.ManualTestReportTemplateSummary"/}} | ||
| 115 | {{/comment}} | ||
| 116 | |||
| 117 | = Performances tests compared to <last super stable version> = | ||
| 118 | |||
| 119 | <a summary of the comparison with latest super stable version> | ||
| 120 | |||
| 121 | More details on <link to the test report>. | ||
| 122 | |||
| 123 | = Known issues = | ||
| 124 | |||
| 125 | * [[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]] | ||
| 126 | |||
| 127 | = Backward Compatibility and Migration Notes = | ||
| 128 | |||
| 129 | == General Notes == | ||
| 130 | |||
| 131 | 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. | ||
| 132 | |||
| 133 | == Issues specific to XWiki 7.4 Milestone 1 == | ||
| 134 | |||
| 135 | * Better backward-compatibility for URLs has been added for the following 2 cases: | ||
| 136 | ** 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 | ||
| 137 | ** The ##view## action can be specified even when the wiki is configured to hide the ##view## action. | ||
| 138 | ** Note that this fixes [[some backward-compatibility issue introduced in XWiki 7.2>>ReleaseNotes.ReleaseNotesXWiki72||anchor="HURLs"]] | ||
| 139 | |||
| 140 | == API Breakages == | ||
| 141 | |||
| 142 | The following APIs were modified since <project> <version - 1>: | ||
| 143 | |||
| 144 | {{code language="none"}} | ||
| 145 | <clirr output here> | ||
| 146 | {{/code}} |
