Wiki source code of Release Notes for XWiki 7.2 Release Candidate 1
Last modified by Thomas Mortagne on 2023/10/13
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 | This release candidate brings many Flamingo skin improvements to better present Nested Documents on top of the Nested Spaces concept. Similar improvements were made in applications like Solr Search, AWM, FAQ, Activity Stream and the Skin editor in order to be compatible with Nested Spaces. On the developers side, a new Select widget and a document picker were added to allow richer UIs to be created. Last but not least, 41 bugs were fixed in this release on the road towards the coming final 7.2 release. | ||
| 8 | |||
| 9 | = New and Noteworthy (since XWiki 7.2M3) = | ||
| 10 | |||
| 11 | [[Full list of issues fixed and Dashboard for 7.2>>https://jira.xwiki.org/secure/Dashboard.jspa?selectPageId=13390]]. | ||
| 12 | |||
| 13 | == Flamingo == | ||
| 14 | |||
| 15 | Following the introduction of the Nested Documents feature, we have made some modifications to the Flamingo skin: | ||
| 16 | |||
| 17 | * The welcome message from the main wiki home page has been updated. | ||
| 18 | * The "Spaces" widget from the wiki dashboard has been replaced with "Pages" which shows the hierarchy of nested pages from that wiki. | ||
| 19 | * For non terminal documents, we have introduced a "Page Administration", where you will find settings that concern the document and its children (it's actually the old space administration behind the scene). But we have also introduced 2 sections for setting rights on these pages: | ||
| 20 | ** a section to set rights for the document only. | ||
| 21 | ** a section to set rights for the document and its children. | ||
| 22 | * For terminal documents, nothing changes, you can change the access rights of the page in the "edit" menu. The only addition is a "Administer Parent" link in the "More actions" menu to administer the parent page (which again is the space administration behind the scene). | ||
| 23 | * The create action has been relooked (with the introduction of the "page type" field) and proposes to import an office document. | ||
| 24 | * A new "children" viewer is now accessible in the "more actions" menu, along with the other viewers. | ||
| 25 | * For Terminal Pages, a new "siblings" viewer is present, which replaces the old "space index" feature. | ||
| 26 | |||
| 27 | {{gallery}} | ||
| 28 | image:flamingo.png | ||
| 29 | image:AdministerPageMenu.png | ||
| 30 | image:AdminPageAndChildrenRights.png | ||
| 31 | image:AdminPageRights.png | ||
| 32 | image:AdministerParentMenu.png | ||
| 33 | image:create.png | ||
| 34 | image:CreatePopUp.png | ||
| 35 | image:menu-children.png | ||
| 36 | image:menu-siblings.png | ||
| 37 | {{/gallery}} | ||
| 38 | |||
| 39 | == Solr Search == | ||
| 40 | |||
| 41 | You can now search for nested documents using the [[Solr Search Application>>extensions:Extension.Solr Search Application]]. The display of the search result location has been updated to support nested documents. | ||
| 42 | |||
| 43 | {{image reference="searchResultLocation.png"/}} | ||
| 44 | |||
| 45 | The "Space" facet has been replaced with a "Location" facet that supports nested documents. This allows you to search in a specific location in the page hierarchy. | ||
| 46 | |||
| 47 | {{image reference="searchLocationFacet.png"/}} | ||
| 48 | |||
| 49 | The "Page" facet has been removed by default because it doesn't bring value in the context of the nested documents: all non-terminal documents have the same name 'WebHome'. The "Wiki" facet is displayed by default only on the main wiki and only if you have multiple wikis. | ||
| 50 | |||
| 51 | == Miscellaneous == | ||
| 52 | |||
| 53 | * When [[creating, copying or renaming a page>>Documentation.UserGuide.Features.DocumentLifecycle]] you can now select a top level location from the tree picker (e.g. copy as top level page) even if you have a single wiki (i.e. only the main wiki). You do this by selecting the root of the tree (i.e. the wiki node). | ||
| 54 | * The [[Document Tree Macro>>extensions:Extension.Document Tree Macro]] is now displaying a message when the tree is empty.((( | ||
| 55 | {{image reference="emptyDocTree.png"/}} | ||
| 56 | |||
| 57 | With the new ##showRoot## parameter you can force the document tree to show the actual root node (either the one specified by the ##root## parameter or the default root node). | ||
| 58 | ))) | ||
| 59 | * A couple of bugs in the [[App Within Minutes Application>>extensions:Extension.App Within Minutes Application]], that were caused by the introduction of the Nested Documents feature, have been fixed. | ||
| 60 | * It's now possible create new FAQs in Nested Spaces. | ||
| 61 | * When using the XWiki Jetty distribution, a memory dump is automatically created in XWiki's ##data/## folder when an ##Out Of Memory## error occurs. | ||
| 62 | * The Activity Stream now also displays activity for Nested Spaces. | ||
| 63 | * Skin editor now properly works for a nested skin document | ||
| 64 | |||
| 65 | 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.2-rc-1%22&tempMax=1000]] fixed in this release. | ||
| 66 | |||
| 67 | = For Developers = | ||
| 68 | |||
| 69 | == XWiki Select Widget == | ||
| 70 | |||
| 71 | A [[new widget has been introduced>>Documentation.DevGuide.XWikiSelect]], to have a rich select box: | ||
| 72 | |||
| 73 | {{image reference="xwiki-select.png"/}} | ||
| 74 | |||
| 75 | == Document Picker == | ||
| 76 | |||
| 77 | Two new Velocity macros has been added to allow selecting a document from a tree picker and to display the path (breadcrumbs) to the selected document. | ||
| 78 | |||
| 79 | {{image reference="locationPicker.png"/}} | ||
| 80 | |||
| 81 | Check the [[Document Picker documentation>>extensions:Extension.Document Picker]] for more details. | ||
| 82 | |||
| 83 | == Deprecated and Retired projects == | ||
| 84 | |||
| 85 | <description of deprecated and retired projects> | ||
| 86 | |||
| 87 | == Upgrades == | ||
| 88 | |||
| 89 | The following dependencies have been upgraded: | ||
| 90 | |||
| 91 | * [[JGroups 3.6.6>>https://jira.xwiki.org/browse/XWIKI-12507]] | ||
| 92 | * [[httpcore 4.4.3>>https://jira.xwiki.org/browse/XCOMMONS-845]] | ||
| 93 | * [[Infinispan 7.2.5>>https://jira.xwiki.org/browse/XWIKI-12557]] | ||
| 94 | |||
| 95 | == Miscellaneous == | ||
| 96 | |||
| 97 | * The URL parameters ##?viewer=children## and ##?viewer=backlinks## have been added. | ||
| 98 | * A new "siblings" viewer has been added, accessible both with ##?viewer=siblings## and ##?xpage=siblings##. | ||
| 99 | * For ##?viewer=children##, ##?xpage=children##, ##?viewer=siblings## and ##?xpage=siblings## a new ##displayHidden## parameter has been added. By default, the hidden documents are not displayed unless the user's configuration overwrites this. | ||
| 100 | |||
| 101 | = Tested Browsers & Databases = | ||
| 102 | |||
| 103 | {{include reference="TestReports.ManualTestReportSummaryXWiki72RC1"/}} | ||
| 104 | |||
| 105 | = Known issues = | ||
| 106 | |||
| 107 | * [[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]] | ||
| 108 | |||
| 109 | = Backward Compatibility and Migration Notes = | ||
| 110 | |||
| 111 | == General Notes == | ||
| 112 | |||
| 113 | 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. | ||
| 114 | |||
| 115 | == API Breakages == | ||
| 116 | |||
| 117 | The following APIs were modified since XWiki 7.1.2: | ||
| 118 | |||
| 119 | * New configuration option to change the size of the Job statuses cache:((( | ||
| 120 | {{code language="none"}} | ||
| 121 | org.xwiki.job.JobManagerConfiguration: Method 'public int getJobStatusCacheSize()' has been added to an interface | ||
| 122 | {{/code}} | ||
| 123 | ))) | ||
| 124 | |||
| 125 | * Added missing methods to the ##DocumentModelBridge## class, which are already implemented by XWikiDocument:((( | ||
| 126 | {{code language="none"}} | ||
| 127 | org.xwiki.bridge.DocumentModelBridge: Method 'public org.xwiki.model.reference.DocumentReference getContentAuthorReference()' has been added to an interface | ||
| 128 | {{/code}} | ||
| 129 | ))) | ||
| 130 | |||
| 131 | * AbstractWrappingObject, AbstractSafeObject and ScriptSafeProvider have been moved to xwiki-commons-script:((( | ||
| 132 | {{code language="none"}} | ||
| 133 | org.xwiki.extension.wrap.WrappingIterableResult: Removed org.xwiki.extension.internal.safe.AbstractSafeObject from the list of superclasses | ||
| 134 | org.xwiki.extension.wrap.WrappingIterableResult: Removed org.xwiki.extension.wrap.AbstractWrappingObject from the list of superclasses | ||
| 135 | org.xwiki.extension.wrap.WrappingIterableResult: Parameter 2 of 'public WrappingIterableResult(org.xwiki.extension.repository.result.IterableResult, org.xwiki.extension.internal.safe.ScriptSafeProvider)' has changed its type to org.xwiki.script.internal.safe.ScriptSafeProvider | ||
| 136 | org.xwiki.filter.script.AbstractFilterScriptService: Changed type of field scriptProvider from org.xwiki.extension.internal.safe.ScriptSafeProvider to org.xwiki.script.internal.safe.ScriptSafeProvider | ||
| 137 | org.xwiki.extension.script.AbstractExtensionScriptService: Changed type of field scriptProvider from org.xwiki.extension.internal.safe.ScriptSafeProvider to org.xwiki.script.internal.safe.ScriptSafeProvider | ||
| 138 | {{/code}} | ||
| 139 | ))) | ||
| 140 | |||
| 141 | * com.xpn.xwiki.XWiki#localStringEntityReferenceSerializer now exists in oldcore, we do not need it in the aspect anymore:((( | ||
| 142 | {{code language="none"}} | ||
| 143 | com.xpn.xwiki.XWikiCompatibilityAspect: Method 'public org.xwiki.model.reference.EntityReferenceSerializer ajc$interFieldGetDispatch$com_xpn_xwiki_XWikiCompatibilityAspect$com_xpn_xwiki_XWiki$localStringEntityReferenceSerializer(com.xpn.xwiki.XWiki)' has been removed | ||
| 144 | com.xpn.xwiki.XWikiCompatibilityAspect: Method 'public void ajc$interFieldInit$com_xpn_xwiki_XWikiCompatibilityAspect$com_xpn_xwiki_XWiki$localStringEntityReferenceSerializer(com.xpn.xwiki.XWiki)' has been removed | ||
| 145 | com.xpn.xwiki.XWikiCompatibilityAspect: Method 'public void ajc$interFieldSetDispatch$com_xpn_xwiki_XWikiCompatibilityAspect$com_xpn_xwiki_XWiki$localStringEntityReferenceSerializer(com.xpn.xwiki.XWiki, org.xwiki.model.reference.EntityReferenceSerializer)' has been removed | ||
| 146 | {{/code}} | ||
| 147 | ))) | ||
| 148 | |||
| 149 | * Not a breakage. The legacy method was not in the right place (which mean that it was not available so it actually fix a breakage):((( | ||
| 150 | {{code language="none"}} | ||
| 151 | com.xpn.xwiki.XWikiCompatibilityAspect: Method 'public java.lang.Object getRenderingEngine()' has been removed | ||
| 152 | {{/code}} | ||
| 153 | ))) | ||
| 154 | |||
| 155 | * Young API. ExportURLFactoryContext been renamed to FilesystemExportContext and moved to the Filesystem URL scheme module | ||
| 156 | {{comment}}Eduard @ 7.2RC1: | ||
| 157 | I have found 3 differences in xwiki-platform that have not generated a clirr error, maybe they are leftovers or the clirr report did not catch them for some reason. See https://github.com/xwiki/xwiki-platform/blob/master/xwiki-platform-core/pom.xml#L493:L510{{/comment}} |
