Installation

Detailed instructions on how to install and configure Portal into your Umbraco Commerce implementation.

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

NuGet Package Installation

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

PM> Install-Package Umbraco.Commerce.Portal

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

Installing Umbraco Commerce Portal via the NuGet Package Manager.

Content Installation

When the Portal 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 Portal content follow these steps:

1. Access the Umbraco CMS backoffice.

2. Navigate to the Settings section.

3. Locate the Portal Dashboard.

The Portal Dashboard in the Settings section of the Umbraco backoffice.

1. Click the Install button.

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

3. Click Install.

The dialog that appears when installing content through the Portal dashboard.

The selected root node configured with a Umbraco Commerce store.

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

• Configure the Umbraco Commerce store with custom Umbraco Commerce Portal email templates for confirming portal account and reset password.

• Create the Umbraco Commerce Portal Member Group (Commerce Portal), Member Type (Umbraco Commerce Portal Member), and Data Type (Umbraco Commerce Portal Country Picker).

• Create the Umbraco Commerce Portal Document Types:

  • Portal Container

    • Login, Register and Reset Password pages

    • Portal Management pages:

      • My Account

      • Order History

      • Order Details

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

• Configure the Umbraco Commerce Portal Management Pages public access for members part of the Commerce Portal group.

Upgrading

Before upgrading, it is always advisable to take a complete backup of your site/database.

The Portal package uses a combination of database migrations and a manual install dashboard for both installs and upgrades. To upgrade, install the latest version over the existing package and complete the installation steps.