Migrate
Migrating from the version 1.x to 2.x
In case you migrate from the version 1.x to 2.x, please follow the following steps.
Image variations
-
Move the config folder to dam-focal-common module.
-
Rename the sub-folder variationSets into variations.
-
Remove the sub-folder dam and move its contents directly under variations.
-
optional Set the description properties.
1.xdam-images-responsive:
config:
variationSets:
dam:
750by1334:
minHeight: 75
minWidth: 133
ratio: 750/1334
768by1024:
minHeight: 77
minWidth: 102
ratio: 768/1024
4by3:
minHeight: 120
minWidth: 90
ratio: 4/3
16by9:
minHeight: 160
minWidth: 90
ratio: 16/92.xdam-focal-common:
config:
variations:
Cinema:
description: Cinema
minHeight: 120
minWidth: 213
ratio: 16/9
Wide:
description: Cinema wide
minHeight: 120
minWidth: 280
ratio: 21/9
Square:
description: Square
minHeight: 120
minWidth: 120
ratio: 1/1
PhonePortrait:
description: Phone portrait
minHeight: 240
minWidth: 120
ratio: 9/18Focal area URL
Just rename the imaging operation from focalpoint to focalarea.
- Example
-
Old:
/magnolia/.imaging/focalpoint/1600x900/dam/jcr:aa26dabe-cdfc-4f4d-9f4a-6e1e1327806e/magazine.pngNew:/magnolia/.imaging/focalarea/1600x900/dam/jcr:aa26dabe-cdfc-4f4d-9f4a-6e1e1327806e/magazine.png
DAM JCR Workspace
For every DAM asset, move the existing focal areas nodes under a contentNode named focalAreas.
1.xBanner:
Cinema:
x: 0
y: 0
height: 624
width: 1457
Square:
x: 778
y: 0
height: 624
width: 6242.xBanner:
focalAreas:
Cinema:
x: 0
y: 0
height: 624
width: 1457
Square:
x: 778
y: 0
height: 624
width: 624Migrating from the version 2.0 to 2.1
Image variations
Move the image variations defined in the node /modules/dam-focal-common/config to the yaml decoration file
/your_module/decorations/dam-focal-common/config.yaml as following:
variations: !override (1)
Cinema:
description: Cinema (2)
minHeight: 120 (3)
minWidth: 213 (4)
ratio: 16/9 (5)
Wide:
description: Cinema wide
minHeight: 120
minWidth: 280
ratio: 21/9
Square:
description: Square
minHeight: 120
minWidth: 120
ratio: 1/1