NUGET_README.md

Method4.UmbracoMigrator.Source

Import Migration Snapshots created using the Method4.UmbracoMigrator.Source package.

Features

Generates the Migration Snapshot (.zip) files that will be imported into your new Umbraco v10+ site using the Target package.

Method4.UmbracoMigrator.Target

Imports the migration snapshots and runs mappers to transform the data.

Please view the Method4.UmbracoMigrator.Target repo to find out about all of the available features, which include:

• Repeatable imports
  • Subsequent migration imports will simply update the previously migrated nodes, rather than creating new nodes, when imported.
• Custom Mappings
  • Define custom mapping logic by implementing our IDocTypeMapping/IMediaTypeMapping interfaces.
• Default Mappings
  • The package ships with built-in default mappers that perform "lazy" mappings, e.g. if an old Node's DocType matches one of our new DocTypes it will attempt to map it, and if any of its properties have identical aliases, then their raw values be copied across.
• Automatically convert Media Picker formats
  • MediaPicker (legacy) can be converted to the new MediPicker 3's format automatically

Installation & Umbraco Version Support

The Package's major versions will match the minimum compatible Umbraco version.
Whilst this does go against semantic versioning, it should make it easier to figure out which version will work for you.
We'll try to keep breaking changes out of minor versions, but they may happen if we need them.

Umbraco Version	Package Version
v7	v7.x
v8	v8.x
v10	v10.x
v13	v13.x

Links

• Repo: https://github.com/Method4Ltd/Method4.UmbracoMigrator.Source
• Docs: https://github.com/Method4Ltd/Method4.UmbracoMigrator.Source/blob/v8/main/docs/README.md

Roadmap

Please see the roadmap for a list of outstanding features and TODOs.

License

Copyright © Method4.

All source code is licensed under the Mozilla Public License.