0 votes

Converge

Compare, convert and merge content between different instances of an Umbraco website. Easily control how you move content between development, staging and live sites. You can compare and merge the following entity types:

  • Content
  • Media
  • Content Templates
  • Document Types
  • Media Types
  • Data Types
  • Templates
  • Dictionary Items
  • Macros

Versions

Converge is currently a beta test version and will only work with version 7 of Umbraco (v7.7.0 onwards). Please back up your code and database before using. I would really appreciate your feedback (both good and bad!).

I have lots of updates planned, not least an implementation that works with Umbraco 8. The eventual intention is to be able to transfer content from an Umbraco 7 site to its Umbraco 8 equivalent, thus being able to use Converge to help migrate between those two versions.

How to Use

  • Install Converge on both instances of the sites that you want to move content between.
  • Log into the back-office of Umbraco on the site that is to be updated.
  • Select the Converge section and then select "Merge from Remote".
  • Enter the URL and login details of the site that you want to retrieve the content from, and then push the "Compare" button.
  • Converge will then connect with the remote site, retrieve the content information and compare it with the current site, and then display the comparison in a table.
  • You can expand any one of the entities to see a comparison of its properties.
  • Use the dropdowns to determine which entities you wish to update on the current site.
  • Push the "Merge" button and the content will be updated as specified.

Converters

Converge has been designed to allow the transfer of content between different versions of Umbraco. A number of built-in data type converters are supplied to transform legacy data types to their updated versions before the comparison is made, so that the content is upgraded during the process. For example, from Umbraco version 7.12.0 onwards Tags can be stored as JSON rather than CSV. A built-in converter will convert the CSV Tags to JSON during the comparison and merge.

You can also add your own data type converters by creating a C# class that implements the IDataTypeConverter interface. The class can be added to Converge using the following function call in an ApplicationStarted event.

ConvergeConverters.AddDataTypeConverter(new MyDataTypeConverter());

I hope to create some more detailed documentation soon!

Package owner

Stuart Mullinger

Stuart Mullinger

Stuart has 72 karma points

Package Compatibility

This package is compatible with the following versions as reported by community members who have downloaded this package:
Untested or doesn't work on Umbraco Cloud
Version 8.6.x (untested)
Version 8.5.x (untested)
Version 8.4.x (untested)
Version 8.3.x (untested)
Version 8.2.x (untested)
Version 8.1.x (untested)
Version 8.0.x (untested)
Version 7.15.x (untested)
Version 7.14.x (untested)
Version 7.13.x (untested)
Version 7.12.x (untested)
Version 7.11.x (untested)
Version 7.10.x (untested)
Version 7.9.x (untested)
Version 7.8.x (untested)
Version 7.7.x (untested)
Version 7.6.x (untested)
Version 7.5.x (untested)
Version 7.4.x (untested)
Version 7.3.x (untested)
Version 7.2.x (untested)
Version 7.1.x (untested)
Version 7.0.x (untested)
Version 6.2.x (untested)

You must login before you can report on package compatibility.

Package Information

  • Package owner: Stuart Mullinger
  • Created: 22/06/2020
  • Current version 0.1.1
  • .NET version 4.5.2
  • License MIT
  • Downloads on Our: 6