Detailed steps on how to migrate the Checkout package from Vendr to Umbraco Commerce.
Throughout the following steps, we will migrate the Checkout package from Vendr to Umbraco Commerce.
Make a backup of any custom templates and Vendr UI configuration files.
Make a note of all configuration values on the Vendr.Checkout Checkout node.
Delete Vendr.Checkout generated checkout nodes.
Checkout
Customer Information
Shipping Method
Payment Method
Review Order
Process Payment
Order Confirmation
Delete all Vendr.Checkout generated Document Types.
[Vendr Checkout] Page
[Vendr Checkout] Checkout Page
[Vendr Checkout] Checkout Step Page
Delete all Vendr.Checkout generated Data Types.
[Vendr Checkout] Step Picker
[Vendr Checkout] Theme Color Picker
Uninstall the Vendr.Checkout Nuget package:
Delete any remaining files and folders in the ~/App_Plugins/VendrCheckout
directory.
Install the Umbraco.Commerce.Checkout package:
Locate the Umbraco Commerce Checkout dashboard in the Settings section
Click the "Install" button to reinstall the Checkout components in the previous location.
Copy any custom configuration files back into the solution.
Copy any custom Views into the ~/Views/UmbracoCommerceCheckout/
folder.
Learn how to migrate a Vendr solution to Umbraco Commerce.
This guide provides a step-by-step approach to migrating a default Vendr solution to Umbraco Commerce.
Upgrade to the latest version of Vendr before continuing with the migration.
You can upgrade your installation by installation the on top of the existing one.
You can find details on migrating the Checkout package as well as custom Payment Providers in the of this article.
Before outlining the exact steps, there are a few key changes to be aware of.
These changes will dictate the steps to take in the process of migrating to Umbraco Commerce.
In this first step, we will be replacing all existing Vendr dependencies with Umbraco Commerce dependencies.
Remove any installed Vendr packages (including Payment Providers):
Take a backup of any Vendr-specific templates and config files you will want to reuse:
Delete the Vendr App_Plugins
folder:
Install Umbraco.Commerce
:
Install Umbraco Commerce packages including any payment providers previously removed.
Reapply any backed-up config files in their new App_Plugins
location.
Move any backed-up templates into the ~/Views/UmbracoCommerce/Templates/
folder.
Compile your project against .NET 7.0.
In this step, we will cover updating the database for Umbraco Commerce.
Backup your database
Rename database tables using the following query:
Swap Vendr property editors for Umbraco Commerce property editors:
Swap the Vendr variants editor for the Umbraco Commerce variants editor in the block list data entry:
Swap Vendr price/amount adjustments to Umbraco Commerce price/amount adjustments:
Update template paths:
Update the migrations log:
Update the activity logs:
Delete any obj/bin folders in your projects to ensure a clean build.
Recompile all projects and ensure all dependencies are restored correctly
Delete the existing Vendr license files in the umbraco\Licenses
folder.
Add your new Umbraco.Commerce license key to the appSettings.json
file:
Update any payment gateways that use a global webhook:
Run the project.
It is highly recommended to ensure everything works as expected, before moving on to migrating packages and custom payment providers.
If you have been using the Vendr Checkout package, you will need to follow some additional steps to migrate this package to Umbraco Commerce. Follow the link below for a complete guide:
Any custom payment providers used with Vendr also need to be migrated to Umbraco Commerce. Follow the link below to find detailed steps on how to perform this migration:
Follow the steps outlined below to migrate your custom payment providers to Umbraco Commerce.
Throughout the following steps, we will migrate custom payment providers used for Umbraco Commerce into Umbraco Commerce.
Remove any installed Umbraco Commerce packages
Install the Umbraco.Commerce
packages for the payment providers.
Update any namespace references.
Update project framework to net7.0
.
The final step in the migration is to update all abstract async methods exposed by the base class. It needs to be updated to accept an additional CancellationToken cancellationToken = default
parameter as the final method argument. Your Integrated Development Environment (IDE) should provide feedback on all the methods that have been updated.
Rename any config files with a .json
file extension rather than .
Based on the outlined above update all Vendr references to the new Umbraco Commerce alternatives. Ensure you update any Views/Partials that also reference these.
Vendr.Common
Umbraco.Commerce.Common
Vendr.Core
Umbraco.Commerce.Core
Vendr.Infrastructure
Umbraco.Commerce.Infrastructure
Vendr.Persistence
Umbraco.Commerce.Persistence
Vendr.Persistence.Sqlite
Umbraco.Commerce.Persistence.Sqlite
Vendr.Persistence.SqlServer
Umbraco.Commerce.Persistence.SqlServer
Vendr.Umbraco
Umbraco.Commerce.Cms
Vendr.Umbraco.Web
Umbraco.Commerce.Cms.Web
Vendr.Web
Umbraco.Commerce.Web
Vendr.Web.UI
Umbraco.Commerce.Web.StaticAssets
Vendr.Umbraco.Startup
Umbraco.Commerce.Cms.Startup
Vendr
Umbraco.Commerce