Anchor | ||||
---|---|---|---|---|
|
Info |
---|
See also Changelog per Version for information on issues resolved in each XperienCentral release. |
Click an XperienCentral version for specific upgrade information.
Expand | |||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| |||||||||||||||||||||||||||||
XperienCentral R33Release date: July 26, 2021
Check Configuration FilesSee Check Configuration Files. Google Sitemap Automatic UploadIn XperienCentral R33, a new setting for controlling whether XperienCentral automatically uploads generated sitemaps to Google has been introduced. The setting Because it is disabled by default, when upgrading from R32, the option must be enabled manually if XperienCentral should continue to automatically submit the sitemap to Google. Interactive Forms fragmentDiv.tag FileDue to changes in the way the Interactive Form panel works, an extra attribute is required in the CSRF SettingsTo better protect websites hosted by XperienCentral against CSRF attacks, a new mechanism has been introduced that uses a CSRF token that is stored in a cookie, and an SHA-256 hash of this token plus a random 16 character long nonce, postfixed with the used nonce, must be included in all non-GET requests to the server as a header or form field. This change could affect custom functionality in the following ways:
See also Security Guidelines for Developers for more information. formvalidationbindings.jsThe following changes have been made to the
Interactive Forms Upload ElementThe Upload element in Interactive Forms has been modified to allow multiple file uploads. You can also set a minimum and maximum number of allowed files in an Upload element. See Creating Forms for complete information. Interactive Forms Deprecated MethodsIn XperienCentral versions R33 and higher, the following form methods have been deprecated. FormScopeThe following method has been deprecated:
use the following method instead:
FormValuesMapThe following method has been deprecated:
use the following method instead:
UploadFragmentScopeAll methods have been deprecated. Use the following method instead:
|
Expand | ||||
---|---|---|---|---|
| ||||
XperienCentral R32Release date: May 12, 2021
Check Configuration FilesSee Check Configuration Files. Rebuild the Content IndexDue to a change in the Search functionality, you must rebuild the content index. To do so, manually remove the Check Google Sitemap Generator ScheduleIn R32, XperienCentral generates and uploads a Google Sitemap by default once per day. If you do not want to generate a sitemap, clear the field Changes to the XperienCentral APIRemoved MethodsThe following deprecated methods have been removed in R32:
Added MethodsThe methods
The purpose of the Lead field is to provide a short summary of the content item's content and can be used, for example, as a summary in a search function or in a Content Overview. One important difference is that, as designed, the Meta Description field is not meant to be visible to end users while the Lead Text is. The following methods have been moved from
Furthermore, the following methods have been added to
Default Content Language
GX WebManager JUnit wrapper BundleBeginning in XperienCentral version R31, the JUnit wrapper bundle is no longer deployed to XperienCentral by default. It is possible that plugins (including any reusables) built against older versions of XperienCentral still have an indirect dependency on this plugin which results in those dependent plugins not starting when XperienCentral is started. There are two ways to fix this issue:
|
Expand | ||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||
XperienCentral R31Release date: March 4, 2021
Check Configuration FilesSee Check Configuration Files. Default Content Language
New WYSIWYG Editor in Interactive FormsIn XperienCentral R31, a new WYSIWYG editor has been introduced in Interactive Forms. It generates HTML in a slightly different way than the old editor. The changes introduced by the new WYSIWYG editor are:
After ugrading to XperienCentral R31, HTML already stored in existing form elements remains unchanged. All new HTML produced after the upgrade will be generated in the new way. If you edit an existing WYSIWYG form element, it will be upgraded after saving. In some cases, extra whitespace may be introduced between elements. GX Software recommends that you check new or modified WYSIWYG form elements after upgrading to R31 in order to determine whether you need to tweak your CSS to accommodate the behavior of the new WYSIWYG editor. Connector Definition for AJP/1.3 ConnectionsIn Tomcat versions 8.5.51, 9.0.31 and later, the connector definition in the
getPersonalizationXMLDataThe getPersonalizationXMLData method in the PersonalizationXMLDataProvider API has been changed from
to
If you use this method, you must refactor your code to cope with the modification. getMediaItemVersionsIn version R31 of XperienCentral, the tag Replace all instances of the
to
See getMediaItemVersions and the Javadoc for Delete Cache Before to Logging in to an XperienCentral R31 Installation Running LocallyDue to a change to internal JavaScript files in this release, GX Software strongly recommends that you delete your browser cache if you run a local installation of XperienCentral R31 after upgrading but before logging in for the first time. This does not apply to XperienCentral running on an Apache web server. GX WebManager JUnit wrapper BundleBeginning in XperienCentral version R31, the JUnit wrapper bundle is no longer deployed to XperienCentral by default. It is possible that plugins (including any reusables) built against older versions of XperienCentral still have an indirect dependency on this plugin which results in those dependent plugins not starting when XperienCentral is started. There are two ways to fix this issue:
|
Expand | ||||
---|---|---|---|---|
| ||||
XperienCentral R30.1Release date: December 10, 2020
Check Configuration FilesSee Check Configuration Files. XSS Features
External Application Support
Uploaded File Handling
See also Linux Server Installation. xss_allowlist_siteworks_expressionsThe setting |
Expand | ||||
---|---|---|---|---|
| ||||
XperienCentral R29.3Release date: December 2, 2020
Check Configuration FilesSee Check Configuration Files. XSS Features
External Application Support
Uploaded File Handling
See also Linux Server Installation. xss_allowlist_siteworks_expressionsThe setting |
Expand | ||||
---|---|---|---|---|
| ||||
XperienCentral R30Release date: October 28, 2020
Check Configuration FilesSee Check Configuration Files. |
Expand | ||||
---|---|---|---|---|
| ||||
XperienCentral R29.2Release date: October 8, 2020
Check Configuration FilesSee Check Configuration Files. |
Expand | ||||
---|---|---|---|---|
| ||||
XperienCentral R29.1
Release date: September 7, 2020
Check Configuration FilesSee Check Configuration Files. Changes to the Interactive Forms Date ValidatorThe date validator in Interactive Forms now only accepts the Additionally, you need to check any post-processing code that further handles dates submitted in an Interactive Form. For example, if the date submitted in the form is used in an email handler or stored in a database, you need to evaluate how this change affects any further processing you do on data received in forms. |
Expand | |||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| |||||||||||||||
XperienCentral R29
Release date: July 21, 2020
Check Configuration FilesSee Check Configuration Files. New Method for Retrieving Media Items in Content OverviewsIn this release, the Dynamic Content Overview now supports an explicit fallback language selection. For this implementation, the API of
For example, in
must be replaced by:
New Mechanism for Generating Download LinksBeginning in version R29, SEO URLs are now available for downloads. If download elements are linked to downloads in the Content Repository, a small change is required to use these new SEO URLs. The change must be applied to each presentation of a download element (any presentation with scope
Beginning in R29, use the
New Security Protocol Setting for Frontend ServersIn XperienCentral R29, a new preview functionality was introduced. Among other things, this feature enables visitors who do not have permission to log in to the XperienCentral backend to nevertheless preview unpublished content. For this reason, the new setting
|
Expand | ||||
---|---|---|---|---|
| ||||
XperienCentral R28Release date: May 13, 2020
Check Configuration FilesSee Check Configuration Files. Performance Dashboard is RemovedThe Performance Dashboard has been removed from XperienCentral in R28. Use the Monitoring Dashboard to view statistics and metrics related to your XperienCentral deployment. See also Administrative Pages. While the upgrade scripts for XperienCentral should in principle remove all components related to the Performance Dashboard, in some circumstances it may not, therefore you need to manually remove any remnants. Follow these steps:
See also Plugins Management Console. Code ChangesThe
must be changed to:
JCR IndexBeginning in R28, XperienCentral uses an XperienCentral-optimized indexing solution to support queries on frontend nodes instead of the Apache Jackrabbit JCR. This solution generally improves performance and drastically reduces the amount of time it takes to bring a new frontend node online in cloud deployments when traffic demands increase. The new indexing solution will always be used in XperienCentral even if the old JCR index is not disabled. The old JCR index should be disabled on production environments if possible. See also the new JCR Index Settings that have been added to the Setup Tool. JCR Query ReplacementIf you use custom JCR queries in your deployment, they should be replaced in order to use the new API. The following shows a typical query replacement: Queries similar to this:
should be changed to something like this:
Disabling the Built-in Apache Jackrabbit JCR IndexTo disable the old Apache Jackrabbit JCR index, follow these steps:
Content API User CredentialsIn the Connector API, there are two locations in Configuration > Import/Export Configuration where user credentials define which user account executes import/export jobs: one on the Configuration tab and one on the Job tab. The Job tab previously contained the fields "Username", "Password" and "Use application key". The Cofiguration tab contained the same fields with an additional "Website" field. These fields have been replaced by a single "User" drop-down list. In R28 a new System user option has been introduced in the User Authorization panel. Only user accounts designated as system users can be authorized to execute automated export/import jobs. Re-add Users as System UsersAfter upgrading to R28, the existing username(s) will still be used by the Connector API. As soon as you open either of the panels, however, the user(s) might not be selectable anymore and if you re-save the configuration, the jobs might stop running. This is the intended behavior. The solution is to navigate to the Authorization panel, designate new system users and then designate them as the user accounts that run jobs on the Configuration and Job tabs in Import/Export Configuration. |
Expand | ||
---|---|---|
| ||
XperienCentral R27Release date: March 26, 2020 Check Configuration FilesSee Check Configuration Files. Language Version Support for Media ItemsBeginning in XperienCentral 10.27.0, each version of a media item has a specific language defined for it. During the upgrade R27 or higher, each media item is assigned the default editing language of the home page. A consequence of this is that media items might not be shown any longer if its language differs from that of the page on which it should be shown. This is also the case for (lead) images stored in the Content Repository. This can be solved in many cases by defining a fallback language for the languages on your channel. If the fallback language for Dutch is set to English, for example, and there is no Dutch media item to be shown on a Dutch page, then the English version will be shown. This is the case for all kinds of media items, images as well as articles, for example. Check the following to ensure that media items in your channel(s) are handled appropriately:
Modify your Solr ConfigurationIn this version of XperienCentral, the Lucene version has been upgraded to version 6.6.6, therefore you must make the following changes to Change the declaration
to
and add the following declaration to the
Deprecated MethodThe following method has been deprecated in the XperienCentral API in this release:
Removed Methods/InterfacesThe following methods and interfaces have been removed from the XperienCentral API in this release:
Update your Presentation JSPsYou need to update your presentation JSPs if they use the following methods:
Perform a global search in your presentation JSPs for the string " |
Expand | ||
---|---|---|
| ||
XperienCentral R26.1Release date: January 21, 2020 Check Configuration FilesSee Check Configuration Files. Solr SearchThe search functionality has been upgraded to Solr 6 in this version of XperienCentral. After upgrading, perform the following steps in order to prepare your deployment for Solr 6:
Realtime indexing If you use real-time indexing (the XperienCentral Realtime Indexing reusable):
No realtime indexing
|
Expand | ||
---|---|---|
| ||
XperienCentral R26Release date: December 11, 2019
|
Expand | ||
---|---|---|
| ||
XperienCentral R24.2Release date: November 19, 2019 Support for Flash films has been removed from XperienCentral in R24.2. All Flash content elements in your content items will be removed when you upgrade to this version of XperienCentral. The Flash files themselves will still be present in the Content Repository but they cannot be accessed.
|
Expand | ||||
---|---|---|---|---|
| ||||
XperienCentral R25Release date: October 9, 2019 Several changes/additions have been made to XperienCentral API interfaces. If you extend any of these interfaces and have developed your own implementations for them, you may experience failing project builds with XperienCentral R25. Some modifications may have to be implemented for newly added methods. If your custom code extends any of the interfaces listed below, you will have to add new methods to your implementations. See the XperienCentral Javadoc for complete information. The modified interfaces are:
|
Expand | ||
---|---|---|
| ||
XperienCentral R24.1Release date: July 2, 2019 Startup performance has been significantly improved. Bundles are now updated only if they have been modified. In XperienCentral R24.0 and earlier, all bundles were updated at startup, regardless of whether they had been modified. Beginning in XperienCentral R24.1, bundles are only updated if:
This means that if you update anything in the bundle but not these two properties, the bundle will not be updated. This applies to updating bundles in the WAR file, bundles copied to the |
Expand | ||
---|---|---|
| ||
XperienCentral R24Release date: June 5, 2019 Access to the Administrative Pages is no longer restricted to users who have the basic HTTP credentials for a page. When a user has the permission "Access debugging tools" in the category "System utilities" and the user is logged in, they no longer need to provide additional credentials in order to access the Administrative Pages. As a consequence however, the credentials dialog no longer appears automatically when access is requested. If the user is not logged in, they will need to first navigate to: Modular Content Plugin
Monitoring Framework Plugin
|
Expand | ||
---|---|---|
| ||
XperienCentral R23Release date: March 8, 2019
|
Expand | ||
---|---|---|
| ||
XperienCentral 10.22.1Release date: January 9, 2019
|
Expand | ||
---|---|---|
| ||
XperienCentral 10.22.0See also the XperienCentral 10.22 Changelog for information on the issues that have been fixed and other product improvements. DependencyManagerIn XperienCentral 10.22.0, the DependencyManager implementation has been changed. This has an impact for plugins that use the DependencyManager object in their Activator class with package name If the Compat library class For project plugins the refactoring should be straightforward when upgrading to XperienCentral 10.22 or higher. For plugins that must be deployed on all XperienCentral versions (reusables), a fix is available and implemented in the reusable Utility Services (version 1.6.2). You must refactor your plugins or reusables in the following cases: Project PluginsIf your Activator uses the DependencyManager object with package name Reusable PluginsThe same situation applies as above, except you need to add an extra subclass in the Activator class in order to be compatible with XperienCentral versions 10.22.0 higher. If the reusable already uses the Utility Services dependency, you can use the If your Activator class uses the If your Activator class does not use a
When refactoring is finished and XperienCentral has been upgraded to this version or higher, the DependencyManager Compat 3.0.0 bundle can be unstalled. Custom FacetsTwo facets for the keywords field have been added in this release. In order to be able to uniquely identify a facet, changes have been made that affect custom made facet components. The following changes must be made in your project code:
It will depend on your specific use case how your code should be changed. It may be the case, for example, that your custom code uses a Other Changes
|
Expand | ||
---|---|---|
| ||
XperienCentral 10.21.1A problem has been fixed that caused deleted elements to not be completely removed which resulted in excessive space being taken up in the database. After upgrading and starting up XperienCentral for the first time, a task is executed that removes these deleted elements — in some environments, this could take some time to complete. |
Expand | ||
---|---|---|
| ||
XperienCentral 10.18.0
|
Expand | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|