There are currently two ways to install the Vendr Checkout package for Vendr into your solution. Using the Umbraco package distribution, installed via the Umbraco back-office, or using our NuGet packages, installed directly into your projects code base via the NuGet Package Manager.
Umbraco Package Installation
To install the Vendr Checkout Umbraco package, you will need to download the package file manually from the Vendr package page on the Umbraco Developer Portal. On this page, scroll down to the Package Files section and locate the Vendr Checkout package, clicking it to initiate a download.
Once downloaded you should manually install the package by uploading it to the local package installer located in your back-office Packages > Install Local section. Once uploaded, follow the on-screen instructions provided to complete the install.
NuGet Package Installation
To install the Vendr Checkout package via NuGet you can run the following command directly in the NuGet Manager Console window:
PM> Install-Package Vendr.Checkout
Alternatively, you can also find and install the NuGet package via the NuGet Package Manager GUI.
When Vendr Checkout is installed, all relevant database configurations automatically occur via Umbraco Migrations, however there are a series of content creation steps that need to be triggered manually as these types of migrations are not supported by the Umbraco migrations system.
To install the relevant Vendr Checkout content (mainly the checkout content doc types + pages and updates to the Vendr store configuration) navigate to the Settings section and locate the Vendr Checkout dashboard in the root of the section.
On this dashboard, click the Install button then in the dialog select your site root node which is configured with a Vendr store picker linked to a Vendr store and then click Install
During this install, Vendr checkout will perform the following tasks:
- Create the Vendr Checkout Data Types (Colour picker and checkout step picker)
- Create the Vendr Checkout Document Types (Checkout page and checkout step page)
- Create the Vendr Checkout content nodes beneath the select site root node (unpublished)
- Configure the Vendr store with custom Vendr Checkout email templates and required payment providers
Before upgrading, it is always advisable to take a complete backup of your site/database. Every effort has been made to ensure that Vendr Checkout will upgrade gracefully, but there is always a risk that something may not install as expected.
Vendr Checkout uses a combination of database migrations and a manual install dashboard for both installs and upgrades. Upgrading is generally a case of installing the latest version over the top of the existing package and running through the installation steps again.