Wiki source code of Release Notes XWiki 7.4 Milestone 1
Last modified by Thomas Mortagne on 2023/10/13
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 | |||
 |
41.1 | 7 | This is our last stabilization branch for the XWiki 7.x Cycle. It brings polishing and stabilization for the Nested Pages feature and the changes in UI that resulted from it, especially for the Watchlist. |
| |
1.1 | 8 | |
 |
28.1 | 9 | = New and Noteworthy (since XWiki 7.3) = |
| |
1.1 | 10 | |
| |
42.1 | 11 | [[Full list of issues fixed and Dashboard for 7.4>>https://jira.xwiki.org/secure/Dashboard.jspa?selectPageId=13590]]. |
| |
1.1 | 12 | |
 |
5.1 | 13 | == Notifications & Watchlist == |
| |
1.1 | 14 | |
| |
5.1 | 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...).((( |
| |
28.1 | 16 | {{image reference="Notifications.png"/}} |
| |
5.1 | 17 | ))) |
| |
28.1 | 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"/}} | ||
| |
5.1 | 20 | ))) |
| 21 | |||
 |
36.1 | 22 | == App Within Minutes == |
| 23 | |||
| 24 | The application Code and Data pages are now being created. The Code page lists the application code pages. | ||
| 25 | |||
 |
39.1 | 26 | {{image reference="awmCodeHomePage.png"/}} |
| |
36.1 | 27 | |
| 28 | The application Data page shows a live table with the application entries. The application home page has been modified to include the Data page. | ||
| 29 | |||
| |
39.1 | 30 | {{image reference="awmDataHomePage.png"/}} |
| |
36.1 | 31 | |
| 32 | The application entries (custom) live table results page is not generated any more because it was used only to load the translations on demand and now they are loaded on the wiki or user scope, based on the user rights. | ||
| 33 | |||
| |
1.1 | 34 | == Miscellaneous == |
| 35 | |||
| |
2.1 | 36 | * Some [[bootswatch themes>>extensions:Extension.Bootswatch Themes for Flamingo]] have now a more accurate logo. |
| |
11.1 | 37 | * When the search button on the top menu is clicked, it now closes all other menus. |
| |
32.2 | 38 | * The Sandbox now uses XWiki Syntax 2.1. |
| |
19.1 | 39 | * Non terminal pages are now exported with their corresponding ##WebPreferences## page |
| |
1.1 | 40 | |
| |
42.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+%227.4-milestone-1%22&tempMax=1000]] fixed in this release. |
| |
1.1 | 42 | |
| 43 | = For Developers = | ||
| 44 | |||
| |
33.1 | 45 | == Flamingo == |
| 46 | |||
| 47 | An extension point to add content inside the new "Notifications" menu has been added: | ||
| 48 | |||
| |
43.1 | 49 | |=##[[org.xwiki.platform.notifications>>Documentation.DevGuide.ExtensionPoint.Notifications]]## |
| |
33.1 | 50 | |{{image reference="NotificationsInside.png"/}} |
| 51 | |||
| |
27.1 | 52 | == Tree Velocity Macros == |
| |
1.1 | 53 | |
| |
27.1 | 54 | You are now able to "call" the Document Tree from Velocity using something like this: |
| |
1.1 | 55 | |
| |
27.1 | 56 | {{code language="none"}} |
| 57 | #documentTree({ | ||
| 58 | 'class': 'location-tree', | ||
| 59 | 'finder': true, | ||
| 60 | 'showAttachments': false, | ||
| 61 | 'showRoot': $showRoot, | ||
| 62 | 'showTerminalDocuments': false, | ||
| 63 | 'showTranslations': false, | ||
| 64 | 'showWikis': $showWikis | ||
| 65 | }) | ||
| 66 | {{/code}} | ||
| 67 | |||
| 68 | The same is possible with the generic Tree Widget: | ||
| 69 | |||
| 70 | {{code language="none"}} | ||
| 71 | #tree({ | ||
| 72 | 'reference': 'XWiki.DocumentTree', | ||
| 73 | 'root': 'document:xwiki:Sandbox.WebHome', | ||
| 74 | 'openTo': 'document:xwiki:Sandbox.TestPage2' | ||
| 75 | }) | ||
| 76 | {{/code}} | ||
| 77 | |||
| |
27.2 | 78 | All the parameters that are available for the wiki macros (##~{~{documentTree}}## and ##~{~{tree}}##) should be available also for the corresponding Velocity macro. |
| |
27.1 | 79 | |
| |
31.1 | 80 | == New public Abstract job == |
| |
30.1 | 81 | |
| |
31.1 | 82 | A public ##org.xwiki.job.AbstractJob## (and corresponding ##AbstractJobStatus##) is now provided to help implementing a Job. An ##AbstractJob## class already existed since a long time but it was in an internal package. |
| |
30.1 | 83 | |
| |
1.1 | 84 | == Miscellaneous == |
| 85 | |||
| |
18.1 | 86 | * 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. |
| |
25.1 | 87 | * 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.((( |
| 88 | {{code language="none"}} | ||
| 89 | $escapetool.css('a#b.c d[e=f]g{h:i;j}k') | ||
| 90 | ## Output: a\\#b\\.c\\ d\\[e\\=f\\]g\\{h\\:i\\;j\\}k | ||
| 91 | {{/code}} | ||
| 92 | ))) | ||
| |
26.1 | 93 | * 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.((( |
| 94 | {{code language="none"}} | ||
| 95 | {{documentTree filterHiddenDocuments="false" /}} | ||
| 96 | {{/code}} | ||
| 97 | ))) | ||
 |
40.1 | 98 | * Temporary resources can now be forced to be downloaded by using the ##force-download=1## URL parameter |
| |
7.1 | 99 | |
| |
28.1 | 100 | == Upgrades == |
| 101 | |||
| 102 | The following dependencies have been upgraded: | ||
| 103 | |||
| |
42.1 | 104 | * [[slf4j 1.7.13>>https://jira.xwiki.org/browse/XCOMMONS-879]] |
| 105 | * [[Joda-Time 2.9.1>>https://jira.xwiki.org/browse/XWIKI-12816]] | ||
| 106 | * [[commons-collections 3.2.2>>https://jira.xwiki.org/browse/XCOMMONS-881]] | ||
| 107 | * [[Maven 3.3.9>>https://jira.xwiki.org/browse/XCOMMONS-883]] | ||
| 108 | * [[Guice 4.0>>https://jira.xwiki.org/browse/XCOMMONS-883]] | ||
| 109 | * [[commons-dbcp2 2.1.1>>https://jira.xwiki.org/browse/XCOMMONS-884]] | ||
| 110 | * [[jboss-logging 3.1.4>>https://jira.xwiki.org/browse/XCOMMONS-885]] | ||
| 111 | * [[Woodstox 4.4.1>>https://jira.xwiki.org/browse/XWIKI-12853]] | ||
| 112 | * [[commons-net 3.4>>https://jira.xwiki.org/browse/XCOMMONS-887]] | ||
| 113 | * [[commons-collections 4.1>>https://jira.xwiki.org/browse/XCOMMONS-889]] | ||
| |
28.1 | 114 | |
| |
1.1 | 115 | = Translations = |
| 116 | |||
| 117 | The following translations have been updated: | ||
| 118 | |||
| 119 | {{language codes="none, none"/}} | ||
| 120 | |||
| 121 | = Tested Browsers & Databases = | ||
| 122 | |||
| |
39.1 | 123 | {{include reference="TestReports.ManualTestReportSummaryXWiki74M1"/}} |
| |
1.1 | 124 | |
| 125 | = Known issues = | ||
| 126 | |||
| |
42.1 | 127 | * [[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 | 128 | |
| 129 | = Backward Compatibility and Migration Notes = | ||
| 130 | |||
| 131 | == General Notes == | ||
| 132 | |||
| 133 | 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. | ||
| 134 | |||
| |
17.1 | 135 | == Issues specific to XWiki 7.4 Milestone 1 == |
| |
1.1 | 136 | |
| |
17.1 | 137 | * Better backward-compatibility for URLs has been added for the following 2 cases: |
| 138 | ** 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 | ||
| 139 | ** The ##view## action can be specified even when the wiki is configured to hide the ##view## action. | ||
| 140 | ** Note that this fixes [[some backward-compatibility issue introduced in XWiki 7.2>>ReleaseNotes.ReleaseNotesXWiki72||anchor="HURLs"]] | ||
| |
1.1 | 141 | |
| 142 | == API Breakages == | ||
| 143 | |||
| |
28.1 | 144 | The following APIs were modified since XWiki 7.3: |
| |
1.1 | 145 | |
| |
32.1 | 146 | * Was wrongly extending internal class:((( |
| |
1.1 | 147 | {{code language="none"}} |
| |
32.1 | 148 | org.xwiki.extension.job.history.ReplayJobStatus: Removed org.xwiki.job.internal.AbstractJobStatus from the list of superclasse |
| 149 | org.xwiki.extension.job.history.ReplayJobStatus: Removed org.xwiki.job.internal.DefaultJobStatus from the list of superclasse | ||
| 150 | org.xwiki.extension.xar.job.diff.DiffXarJobStatus: Removed org.xwiki.job.internal.AbstractJobStatus from the list of superclasse | ||
| 151 | org.xwiki.extension.xar.job.diff.DiffXarJobStatus: Removed org.xwiki.job.internal.DefaultJobStatus from the list of superclasse | ||
| 152 | org.xwiki.refactoring.job.EntityJobStatus: Removed org.xwiki.job.internal.AbstractJobStatus from the list of superclasse | ||
| 153 | org.xwiki.refactoring.job.EntityJobStatus: Removed org.xwiki.job.internal.DefaultJobStatus from the list of superclasse | ||
| |
1.1 | 154 | {{/code}} |
| |
32.1 | 155 | ))) |
