In this section, we have summarized the changes to Checkout package for Umbraco Commerce released in each version. Each version is presented with a link to the Umbraco Commerce Checkout issue tracker showing a list of issues resolved in the release. We also link to the individual issues themselves from the detail.

If there are any breaking changes or other issues to be aware of when upgrading they are also noted here.

Release History

In this section, you can find the release notes for each version of Checkout package for Umbraco Commerce. For each major version, you can find the details about each release.

Umbraco Commerce Deploy is a free and open-source add-on package for Umbraco Commerce. It provides Umbraco Deploy and Umbraco Cloud support, allowing the transfer of Umbraco Commerce settings between environments.

In this section, we will guide you through the key steps necessary to get you started with the Deploy package for Umbraco Commerce.

It is assumed that you already have one of the following setups:

• A Umbraco Cloud site with Umbraco Commerce installed and configured.

• A Umbraco CMS site configured with Umbraco Deploy and Umbraco Commerce installed and configured.

If you are not at this stage yet, please read the core Umbraco Commerce documentation to learn how to get started.

Useful links

As well as the content in these docs, the following links may prove useful when using this package:

• Umbraco Commerce Deploy source code

• Umbraco Commerce Deploy issue tracker

Umbraco Commerce Checkout is a free and open-source add-on package for Umbraco Commerce. It provides a no-code solution for creating an instant checkout flow in your Umbraco Commerce stores.

Umbraco Commerce Checkout allows you to set up your checkout flow with minimal configuration.

In this section, we will guide you through the key steps necessary to get you started with the Checkout package for Umbraco Commerce.

It is assumed that before we begin that you already have an Umbraco website configured and Umbraco Commerce installed and a store set up. If you are not at this stage yet, please read the core Umbraco Commerce documentation to learn how to get started.

Useful links

As well as the content in these docs, here are a few useful links to learn more about the Umbraco Commerce Checkout package itself.

• Umbraco Commerce Checkout source code

• Umbraco Commerce Checkout issue tracker

After installing the Checkout package, a series of content nodes will be created for you on your site. These will control the checkout flow.

On the root of these nodes, you can configure a series of options to customize the checkout flow to your needs.

Step 1: Configuring the Checkout flow

In addition to these root node settings, each checkout step page also has a number of configurable options:

Linking to the Checkout

With the checkout setup and configured the final step is to configure your cart page to link through to the checkout flow. How you do this is up to you:

• Link to the URL /checkout or

• Use a Content Picker to select the checkout node to link to.

After installing Umbraco Commerce Deploy, it will automatically serialize any changes made in the Umbraco Commerce settings section to disk. They will be added to the data\revision folder alongside Umbraco's own serialized content.

These files should be committed to your repository. Umbraco Deploy will then monitor these files and automatically deploy changes between environments for you.

Learn more about how the deployment process works in the .

In this section, we have summarized the changes to Deploy package for Umbraco Commerce released in each version. Each version is presented with a link to the showing a list of issues resolved in the release. We also link to the individual issues themselves from the detail.

If there are any breaking changes or other issues to be aware of when upgrading they are also noted here.

Release History

In this section, you can find the release notes for each version of Deploy package for Umbraco Commerce. For each major version, you can find the details about each release.

Check out the screenshots below to see what you get with Umbraco Commerce Checkout straight out of the box.

In this article, you can find an example of extending the plugin by adding a custom property value extractor.

Add a custom property value extractor

When a default property value extractor does not suit your need, you can create your own extractor to extract the property value yourself.

For example, when a product's stock value is 0, Google Merchant Feed desired value is out_of_stock. In that case, we have DefaultGoogleAvailabilityValueExtractor.cs to do the conversion from 0 to out_of_stock.

You can often create a new implementation of ISingleValuePropertyExtractor or rarely IMultipleValuePropertyExtractor.

This plugin uses Collection Builder pattern which is commonly used in Umbraco. You can use these two extension methods during application initialization to add your value extractors.

// IUmbracoBuilder builder;
builder.SingleValuePropertyExtractors()
    .Append<DefaultSingleValuePropertyExtractor>()
    .Append<DefaultGoogleAvailabilityValueExtractor>()
    .Append<DefaultMediaPickerPropertyValueExtractor>();

builder.MultipleValuePropertyExtractors()
    .Append<DefaultMultipleMediaPickerPropertyValueExtractor>();

Afterwards, your extractor name should show up in the dropdown under Property And Node Mapping section.

The Product Feeds package can be installed directly into your project's code base using NuGet packages.

Getting started

Below you can find some steps on installing the package using NuGet and getting started with implementing the Product Feeds into your Umbraco Commerce store.

1. Install the package from NuGet

2. Locate where you register the dependencies IUmbracoBuilder.AddUmbracoCommerce() and add a call to IUmbracoCommerceBuilder.AddCommerceProductFeeds() to add this plugin to your website.

   Copy

    umbracoBuilder.AddUmbracoCommerce(ucBuilder => {
        ucBuilder.AddCommerceProductFeeds(); // add this line
    }

3. Open your store's setting page in the backoffice.

4. Click on Product Feed section.

1. Click on Create Product Feed button and fill in the feed settings. Mandatory fields are marked with a red asterisk (*). You can add more product data by adding new mappings in Property And Node Mapping section.

1. After saving the feed setting, a link to access the feed will show up under Feed URL Segment field and at the bottom of the page.

Google Merchant Center Feed sample:

Upgrading

The Product Feeds package uses a database migration for both installs and upgrades. Upgrading is generally a case of installing the latest version via NuGet over the existing package and restarting the website.

The Umbraco Commerce Deploy package can be installed directly into your project's code base using our NuGet packages.

NuGet Package Installation

To install the Umbraco Commerce Deploy package via NuGet run the following command directly in the NuGet Manager Console window using Visual Studio:

PM> Install-Package Umbraco.Commerce.Deploy

Alternatively, you can also find and install the NuGet package via the NuGet Package Manager.

Upgrading

Umbraco Commerce Deploy does not consist of any UI files or database changes. It is generally ok to install the upgrade on top of a previous install.

The Checkout package can be installed directly into your project's code base using NuGet packages.

NuGet Package Installation

To install the Umbraco Commerce Checkout package via NuGet run the following command directly in the NuGet Manager Console window in Visual Studio:

PM> Install-Package Umbraco.Commerce.Checkout

Alternatively, you can also find and install the NuGet package via the NuGet Package Manager.

Content Installation

When the Checkout package is installed, all relevant database configurations automatically occur via Umbraco Migrations. There are a series of content creation steps that need to be triggered manually as these types of migrations are not supported by Umbraco.

To install the relevant Checkout content follow these steps:

1. Access the Umbraco CMS backoffice.

2. Navigate to the Settings section.

3. Locate the Checkout Dashboard.

1. Click the Install button.

2. Select your site's root node which is configured with a Umbraco Commerce store.

3. Click Install.

During this install, Umbraco Commerce checkout will perform the following tasks:

• Create the Umbraco Commerce Checkout Data Types (Colour picker and checkout step picker).

• Create the Umbraco Commerce Checkout Document Types (Checkout page and checkout step page).

• Create the Umbraco Commerce Checkout content nodes beneath the select site root node (unpublished).

• Configure the Umbraco Commerce store with custom Umbraco Commerce Checkout email templates and required payment providers.

Upgrading

The Checkout package 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 existing package and running through the installation steps.

Below is an overview of the different add-ons that you can install into your Umbraco Commerce implementation. All add-ons are meant to extend the features and functionality already available in the core product.

Using These Docs

These docs are aimed at developers and users who have at least a basic understanding of Umbraco, as well as Umbraco backoffice principles.

As there is no code involved with using Umbraco Commerce Deploy, the docs are purely a series of articles covering how installing and configuring Deploy.

After building up your commerce website, you can expand your product reach and show your products to a larger audience with product feeds. Umbraco Commerce Product Feed is a free and open-source add-on for Umbraco Commerce that helps you generate the XML files that are used in services like Google Merchant Center.

Umbraco Commerce Product Feeds package is an XML feed generator plugin that simplifies the creation of structured XML files. It automatically extracts product data from Umbraco nodes, organizes it according to standards and also allows you to add more information to the feed.

Current supported feed template:

• Google Merchant Center feed template.

In this section, we will guide you through the key steps necessary to get you started with the Product Feeds package for Umbraco Commerce.

It is assumed that before we begin you already have an Umbraco website configured and Umbraco Commerce installed and a store set up. If you are not at this stage yet, please read the to learn how to get started.

Useful links