Wiki source code of Release Notes for XWiki 8.0 Milestone 2
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 | |||
16.5 | 7 | This milestone improves some performance and caching issues of the LESS module and continues improving and fixing usability aspects of Nested Pages. | |
1.1 | 8 | ||
15.8 | 9 | = New and Noteworthy (since XWiki 8.0 Milestone 1) = | |
1.1 | 10 | ||
19.1 | 11 | [[Full list of issues fixed and Dashboard for 8.0>>https://jira.xwiki.org/secure/Dashboard.jspa?selectPageId=13593]]. | |
1.1 | 12 | ||
12.1 | 13 | == LESS Module == | |
14 | |||
15 | * For performances reasons, we have set a limit for the number of LESS CSS compilations that can be done simultaneously. | ||
16 | * For the same reason, the LESS cache is not cleared anymore at XWiki launch. | ||
16.1 | 17 | ||
12.1 | 18 | For more informations about this, please see [[extensions:Extension.LESS Module||anchor="Cache"]]. | |
19 | |||
1.1 | 20 | == Miscellaneous == | |
21 | |||
8.1 | 22 | * The "Create Page" Panel now supports creating Nested Spaces (i.e. you can use references in the Space input field and you now need to escape special characters if you wish to have a space containing '.' or ':' characters for example). | |
9.1 | 23 | * The [[Active Installs>>extensions:Extension.Active Installs Server Application]] Dashboard now displays the Java versions in an aggregated format, displaying only major + minor (e.g. "1.7", "1.8"). This makes it simpler to analyze the versions of Java used for XWiki. | |
9.5 | 24 | * When deleting a non-terminal page and the only child of that page is the 'WebPreferences' terminal page, the 'Affect children' checkbox will be checked by default. Normally, it would be unchecked, but in this case we`ve noticed that it`s very easy to forget about that document (since it's hidden and automatically created when going into 'Page Administration') and your deleted page might still show up in some places because of that leftover. You can still uncheck it if you know what you are doing. | |
20.1 | 25 | * The [[Link Label Generator>>Documentation.AdminGuide.Configuration||anchor="HLinkLabelGeneration"]] nows supports Nested Pages by default and several new configuration formats have been introduced: | |
14.1 | 26 | ** ##%s## now uses the full space name (e.g. space1.space2). Note: Prior to 7.4.2/8.0M2 this was only displaying the last space name | |
27 | ** New ##%ls## option: displays the last space name. | ||
28 | ** New ##%np## option: displays the nested page name (i.e. will display the space name for Nested Pages). | ||
29 | ** New ##%NP## option: displays the nested page name with spaces between camel case words, i.e. "My Page" if the page name is "MyPage". | ||
9.2 | 30 | ||
19.1 | 31 | 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.0-milestone-2%22&tempMax=1000]] fixed in this release. | |
1.1 | 32 | ||
33 | = For Developers = | ||
34 | |||
35 | == Upgrades == | ||
36 | |||
37 | The following dependencies have been upgraded: | ||
38 | |||
19.1 | 39 | * [[slf4j 1.7.16>>https://jira.xwiki.org/browse/XCOMMONS-915]] | |
40 | * [[Logback 1.1.5>>https://jira.xwiki.org/browse/XCOMMONS-915]] | ||
41 | * [[Doxia 1.17>>https://jira.xwiki.org/browse/XRENDERING-431]] | ||
42 | * [[Aether 1.1.0>>https://jira.xwiki.org/browse/XCOMMONS-913]] | ||
43 | * [[Less4j 1.16.0>>https://jira.xwiki.org/browse/XWIKI-13119]] | ||
1.1 | 44 | ||
45 | == Miscellaneous == | ||
46 | |||
7.1 | 47 | * Added [[new binding>>extensions:Extension.Watchlist Application||anchor="HAdministrators:CustomizingtheWatchListemailtemplate"]] in the WatchList email template: subscriberReference. For example, this can be used to create a URL to the subscriber (i.e. user receiving the message) profile, where the notifications can be disabled:((( | |
4.2 | 48 | {{code}} | |
49 | $xwiki.getURL($subscriberReference, 'view', 'category=notification') | ||
50 | {{/code}} | ||
4.4 | 51 | ))) | |
16.1 | 52 | * It's now possible to directly compare a ##org.xwiki.extension.version.Version## (at least its default implementation) to a String. Makes a lot easier to manipulate versions in Velocity for example. For example, before 8.0M2 you had to write:((( | |
53 | {{code}} | ||
54 | #set ($supportsNS = $services.extension.core.getCoreExtension('org.xwiki.platform:xwiki-platform-model').id.version.compareTo($services.extension.parseVersion('7.2')) >= 0) | ||
55 | {{/code}} | ||
1.1 | 56 | ||
16.1 | 57 | You can now write: | |
58 | |||
59 | {{code}} | ||
60 | #set ($supportsNS = $services.extension.core.getCoreExtension('org.xwiki.platform:xwiki-platform-model').id.version.compareTo('7.2') >= 0) | ||
61 | {{/code}} | ||
62 | ))) | ||
63 | |||
1.1 | 64 | = Translations = | |
65 | |||
66 | The following translations have been updated: | ||
67 | |||
15.6 | 68 | {{language codes="pt_BR"/}} | |
1.1 | 69 | ||
70 | = Tested Browsers & Databases = | ||
71 | |||
17.1 | 72 | {{include reference="TestReports.ManualTestReportSummaryXWiki80M2"/}} | |
1.1 | 73 | ||
15.7 | 74 | {{comment}} | |
1.1 | 75 | = Performances tests compared to <last super stable version> = | |
76 | |||
77 | <a summary of the comparison with latest super stable version> | ||
78 | |||
79 | More details on <link to the test report>. | ||
15.7 | 80 | {{/comment}} | |
1.1 | 81 | ||
82 | = Known issues = | ||
83 | |||
19.1 | 84 | * [[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 | 85 | ||
86 | = Backward Compatibility and Migration Notes = | ||
87 | |||
88 | == General Notes == | ||
89 | |||
90 | 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. | ||
91 | |||
8.1 | 92 | == Issues specific to XWiki 8.0 Milestone 2 == | |
1.1 | 93 | ||
8.1 | 94 | * If you wish to use '.' or ':' characters in the "Create Page" Panel you'll now need to escape them. For example: ##My\.Space\:name## | |
9.4 | 95 | * If, in your application/custom code, you were using ##XWiki.EntityReferenceTree## in the JavaScript API, you will need to update your code to the new structure of the ##children## property of an ##XWiki.EntityReferenceTreeNode##. Previously, the ##children## property was a map of ##<nameString, XWiki.EntityReferenceTreeNode>##. Now, it was changed to a map of ##<nameString, <XWiki.EntityType, XWiki.EntityReferenceTreeNode>>## because, at each level, you can have both a ##XWiki.EntityType.DOCUMENT## and a ##XWiki.EntityType.SPACE## node with the same name (i.e. siblings) and the old implementation did not consider this case, thus creating a bug. Using the new structure, the bug is fixed, but old code had/has to be updated. | |
1.1 | 96 | ||
97 | == API Breakages == | ||
98 | |||
16.2 | 99 | The following APIs were modified since XWiki 7.4.1: | |
1.1 | 100 | ||
16.2 | 101 | * Allow associating a version different from the extension version to the features and allow indicating namespace constraint in an extension((( | |
1.1 | 102 | {{code language="none"}} | |
16.2 | 103 | org.xwiki.extension.Extension: Method 'public java.util.Collection getAllowedNamespaces()' has been added to an interface | |
104 | org.xwiki.extension.Extension: Method 'public org.xwiki.extension.ExtensionId getExtensionFeature(java.lang.String)' has been added to an interface | ||
105 | org.xwiki.extension.Extension: Method 'public java.util.Collection getExtensionFeatures()' has been added to an interface | ||
1.1 | 106 | {{/code}} | |
16.2 | 107 | ))) | |
108 | |||
109 | * Deprecating this class in favor of the standard library class with the same name((( | ||
110 | {{code language="none"}} | ||
111 | org.xwiki.velocity.introspection.AbstractChainableUberspector: Removed field inner | ||
112 | org.xwiki.velocity.introspection.DeprecatedCheckUberspector: Removed org.xwiki.velocity.introspection.ChainableUberspector from the set of implemented interface | ||
113 | org.xwiki.velocity.introspection.DeprecatedCheckUberspector: Removed org.xwiki.velocity.introspection.AbstractChainableUberspector from the list of superclasse | ||
114 | org.xwiki.velocity.introspection.MethodArgumentsUberspector: Removed org.xwiki.velocity.introspection.ChainableUberspector from the set of implemented interface | ||
115 | org.xwiki.velocity.introspection.MethodArgumentsUberspector: Removed org.xwiki.velocity.introspection.AbstractChainableUberspector from the list of superclasse | ||
116 | {{/code}} | ||
117 | ))) |