4.7 Breaking Changes Guide

When upgrading to 4.7, there are some breaking changes that need to be accounted for.

This feature can be found under Global → RTE cluster → Text CSS Class Groups field.

This field had been previously deprecated, but was removed entirely in 4.7.

Confirm population of field on production

The first step is to verify if this field is used on production.

To confirm this, you will either need production CMS access or will need to request this information from somebody who does.

Resolution

To resolve this, you will need to create a new extension of RichTextElement to replicate the feature.

When creating these new RichTextElement classes, make sure to override getTag() with the correct tag value and also ensure to set this on the rich text annotation as well.

@RichTextElement.Tag(
  value = MyRichTextEl.TAG_NAME,
  htmlBody = true,
  block = true,
  ...
)
public class MyRichTextEl extends RichTextElement {

  public static final String TAG_NAME = "{tag-name}"
  
  @Override
  protected String getTag() {
      return TAG_NAME;
  }
}

After you've implemented the new rich text element, ensure that you create any ViewModels or Handlebars templates so that it can be rendered on the frontend.

If you bump to 4.7, have GO version of 1.x and run into Could not find com.psddev:watch, the solution is to remove api 'com.psddev:watch' from build.gradle(core). However, removing this dependency might throw another error related to incompatible IntegrationHeadScripts and IntegrationExtraBodyItems . The exact error is:

error: types IntegrationHeadScripts and IntegrationExtraBodyItems are incompatible;
public class GoogleTagManager extends Record implements IntegrationHeadScripts,
       ^
  class GoogleTagManager inherits unrelated defaults for isDisabled() from types IntegrationHeadScripts and IntegrationExtraBodyItems

Resolution

To resolve this, override the isDisabled method in GoogleTagManager like this:

@Override
public boolean isDisabled() {
    return this.as(IntegrationItemsData.class).isDisabled();
}