Upgrade Crafter CMS

Crafter CMS 2.5.14 to 2.5.15

1. Crafter Studio

1.1. Config Changes

Important changes in configuration has been made for Crafter CMS 2.5.15 and onwards. The bean definitions used for dependency overrides are no longer supported and instead should be setup in the TOMCAT/shared/classes/crafter/cstudio/extension/server-config.properties configuration file.

Users upgrading to Crafter CMS 2.5.15 and on from a previous version and who uses the bean definitions described below for dependency overrides should follow these instructions when upgrading their Crafter CMS:

In your TOMCAT/shared/classes/crafter/cstudio/extension/services-context.xml, if you have the following bean definitions, comment them out:

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
    <bean id="studioDeplymentDependencyRule" class="org.craftercms.studio.impl.v1.service.dependency.DeploymentDependencyRule">
       <property name="dmDependencyService" ref="cstudioDmDependencyService"/>
       <property name="objectStateService" ref="cstudioObjectStateService"/>
       <property name="contentSpecificDependencies">
       <list>
          <value>/site/components/.*</value>
          <value>/static-assets/.*</value>
       </list>
       </property>
    </bean>

    <bean id="studioSubmitToApproveDependencyRule" class="org.craftercms.studio.impl.v1.service.dependency.SubmitToApproveDependencyRule">
       <property name="dmDependencyService" ref="cstudioDmDependencyService"/>
       <property name="objectStateService" ref="cstudioObjectStateService"/>
       <property name="contentService" ref="cstudioContentService"/>
       <property name="contentSpecificDependencies">
       <list>
          <value>/site/components/.*</value>
          <value>/static-assets/.*</value>
       </list>
       </property>
    </bean>

To replicate the behavior (dependency overrides) in the beans we commented out, we now use a configuration instead. In your TOMCAT/shared/classes/crafter/cstudio/extension/server-config.properties, add the following line:

# Regex patterns for paths of item specific dependencies
crafter.studio.dependency.itemSpecificPattern=/site/components/page/.*,/static-assets/page/.*

Crafter CMS 2.5.2 to 2.5.6

Crafter CMS 2.5.1 to 2.5.2

1. Crafter Engine

1.1. Config Changes

Node

1.1. API Changes

1.1.1. Item Filters

The interface for Item Filters has been updated to provide more control to filters. Item Filter now passes lists of included and excluded items for reference by the current filter.

Who is Impacted Any Java or Groovy code that implements org.craftercms.core.service.ItemFilter
Action Required You will need to update your extension to meet the updated interface

1.1.2. Targeting Properties

The org.craftercms.engine.util.config.TargetingProperties class has been moved to org.craftercms.engine.SiteProperties and now includes more site specific properties.

Who is Impacted Any Java or Groovy code that implements org.craftercms.engine.util.config.TargetingProperties
Action Required You will need to update your extension to meet the updated class