[Documentation] How migrate from manualCrop / Focal Point D7 to MediaContextualCrop Collection

Created on 19 January 2024, 6 months ago
Updated 2 April 2024, 3 months ago

Problem/Motivation

Following work and reflexion made with @candelas about how to migration D7-crop (manual_crop or focal_point) into a D10 stack with Media Contextual Crop, I think it can be a good idea to write a documentation about this subject.

Maybe after this, may work on some "services"/"helper" to make easier some steps.

Proposed resolution

I thinking use this issue and the "first comment" of the issue in order to make a "big draft" of this documentation.

🌱 Plan
Status

Active

Version

2.1

Component

Documentation

Created by

πŸ‡«πŸ‡·France DrDam

Live updates comments and jobs are added and updated live.
Sign in to follow issues

Comments & Activities

  • Issue created by @DrDam
  • πŸ‡«πŸ‡·France DrDam

    [change log]

    - 19th Jan : init

    [How migrate Crop from D7 to D10 with media_contextual_crop collection]

    Modules needed :

    - image_field_to_media
    - media_library_media_modify
    - Crop (by dependencies)
    - media_contextual_crop & media_contextual_crop References

    from focal_point :
    - media_contextual_crop Focal Point Adapter
    - D10 version of focal_point

    from manual_crop :
    - media_contextual_crop Image Widget Crop Adapter
    - Image Widget Crop

    Image Style Migration

    Field Migration

    On of steps are to change the "image field" (legacy) to a "Media with contextual modifications" .
    This opΓ©ration can be made by hand in 2 stages :
    - The module image_field_to_media provide a new action in fields of content_type, "cloning" an image field to a "entity_reference to media" field and migrate image to a media (for not loosing data).
    - The module media_library_media_modify provide a drush command to migrate an "entity_reference" field to a "Media with contextual modifications" field.

    Applying this two operation will adapte content fields to the new use.

    Configuration correction

    - fix content "new field" view mode formater
    - fix media image form mode widget & view mode formater

    Data migration

    [TO DO]

  • πŸ‡«πŸ‡·France DrDam

    Sources :

    Migration of manualCrop : https://www.drupal.org/project/manualcrop/issues/3383416 πŸ“Œ Migration Needs review

  • πŸ‡«πŸ‡·France DrDam
Production build 0.69.0 2024