diff --git a/14/umbraco-commerce/README.md b/14/umbraco-commerce/README.md index 803576bd583..9af418e4dc4 100644 --- a/14/umbraco-commerce/README.md +++ b/14/umbraco-commerce/README.md @@ -11,9 +11,9 @@ Umbraco Commerce is the official Umbraco e-commerce addon for your Umbraco CMS w
Getting StartedFind all the information you need to get started using Umbraco Commerce with your Umbraco CMS implementation.introduction.mdcommerce-icon.png
How-to GuidesLooking to configure and implement something specific? Take a look through the How-to section where you might find a guide that fits your needs.overview.mdumbraco_free_way_01.png
Key ConceptsLooking to learn more about the different concepts and features of Umbraco Commerce? You can find detailed information about each of them in this section.overview.mdUmbraco_Brand_Guidelines_2020_28_Illustration blocks.png
- +
Umbraco Commerce PackagesChoose between a selection of verified packages to extend the Umbraco Commerce implementation for your website.https://docs.umbraco.com/umbraco-commerce-packages
Umbraco Commerce Payment ProvidersYou can integrate your Umbraco Commerce implementation with a series of different payment providers.https://docs.umbraco.com/umbraco-commerce-payment-providers/
Umbraco Commerce Shipping ProvidersYou can integrate your Umbraco Commerce implementation with a series of different shipping providers.https://docs.umbraco.com/umbraco-commerce-shipping-providers
## Quick links diff --git a/14/umbraco-commerce/getting-started/umbraco-configuration.md b/14/umbraco-commerce/getting-started/umbraco-configuration.md index b1274750016..008029a1ac8 100644 --- a/14/umbraco-commerce/getting-started/umbraco-configuration.md +++ b/14/umbraco-commerce/getting-started/umbraco-configuration.md @@ -21,17 +21,21 @@ To gain access to the **Commerce** section, it is advised to create a new User G 1. Navigate to the **User** section of the Umbraco backoffice. 2. Open the **User Groups** page. 3. Create a new User Group called **Commerce**. -4. Assign the relevant User accounts to that User Group. -5. Allow that User Group access to the **Commerce** section as a whole. +4. Allow that User Group access to the **Commerce** section as a whole. +5. Click **Save**. +6. Navigate to the **Users** section. +7. Click on the User. +8. Choose **Commerce** in the **Groups** field to assign the user access to the Commerce section. +9. Click **Save**. Creating a custom User Group provides a way of managing Users who have access to the **Commerce** section, rather than allowing individual Users access. Learn more about [Users and User Groups in the Umbraco CMS Documentation](https://docs.umbraco.com/umbraco-cms/fundamentals/data/users). -![Creating a Commerce User Group in Umbraco](../media/create\_commerce\_user\_group.png) +![Creating a Commerce User Group in Umbraco](../media/v14/creating-user-group.png) ## Accessing the Commerce Section Once created and assigned, you should be able to refresh the backoffice and see that we now have access to the new **Commerce** section. -![Commerce Section in Umbraco Navigation](../media/commerce\_section.png) +![Commerce Section in Umbraco Navigation](../media/v14/commerce-section.png) diff --git a/14/umbraco-commerce/installation/install.md b/14/umbraco-commerce/installation/install.md index 030b5a52da7..f0913d84042 100644 --- a/14/umbraco-commerce/installation/install.md +++ b/14/umbraco-commerce/installation/install.md @@ -5,18 +5,18 @@ description: >- # Installation -Learn how to install Umbraco Commerce into your Umbraco CMS implementation. +In this article, you will learn how to install Umbraco Commerce into your Umbraco CMS implementation. -You can also find information about how to upgrade and how to install and activate your Umbraco Commerce license. +You can also find information about how to upgrade, install, and activate your Umbraco Commerce license. ## NuGet Package Installation Umbraco Commerce is available via [NuGet.Org](https://www.nuget.org/packages/Umbraco.Commerce/). -To install Umbraco Commerce via NuGet you can run the following command directly in the NuGet Manager Console window: +To install Umbraco Commerce via NuGet, run the following command directly in the NuGet Manager Console window: ```bash -PM> dotnet add package Umbraco.Commerce +dotnet add package Umbraco.Commerce ``` Alternatively, you can also find and install the NuGet package via the NuGet Package Manager in Visual Studio. You will see a number of packages available, however, you will want to install the main **Umbraco Commerce** package. @@ -96,6 +96,10 @@ For most sites using a single solution, the above will be all you need to instal +{% hint style="info" %} +If you encounter an SQLite error after installing Umbraco Commerce, you may need to enable SQLite support. For more information, see the [Configure SQLite support](../how-to-guides/configure-sqlite-support.md) article. +{% endhint %} + ## Installing a License See the [Licensing page](the-licensing-model.md#installing-your-license) for details on how to install a license. diff --git a/14/umbraco-commerce/media/v14/commerce-section.png b/14/umbraco-commerce/media/v14/commerce-section.png new file mode 100644 index 00000000000..7a78617f1a2 Binary files /dev/null and b/14/umbraco-commerce/media/v14/commerce-section.png differ diff --git a/14/umbraco-commerce/media/v14/creating-user-group.png b/14/umbraco-commerce/media/v14/creating-user-group.png new file mode 100644 index 00000000000..8b29a269fd1 Binary files /dev/null and b/14/umbraco-commerce/media/v14/creating-user-group.png differ diff --git a/14/umbraco-commerce/reference/shipping/dynamic-rate-shipping.md b/14/umbraco-commerce/reference/shipping/dynamic-rate-shipping.md index c340ee90702..eabd108cf80 100644 --- a/14/umbraco-commerce/reference/shipping/dynamic-rate-shipping.md +++ b/14/umbraco-commerce/reference/shipping/dynamic-rate-shipping.md @@ -8,35 +8,35 @@ Dynamic rate shipping in Umbraco Commerce allows you to define a series of range ## Configuration -* Go to `Settings > Commerce > Stores > {Your Store} > Shipping Methods` +1. Go to **Settings** > **Stores** > {Your Store} > **Shipping Methods**. -![Shipping Methods](../../media/v14/shipping-methods-list-view.png) + ![Shipping Methods](../../media/v14/shipping-methods-list-view.png) -* Click `Create Shipping Method` -* Choose the `Basic` shipping provider +2. Click **Create Shipping Method**. +3. Choose **Basic** as the shipping provider. -![Choose Shipping Provider](../../media/v14/shipping-provider-modal.png) + ![Choose Shipping Provider](../../media/v14/shipping-provider-modal.png) -* Chose the `Dynamic` calculation mode option +4. Choose **Dynamic** as the calculation mode option. -![Choose Shipping Calculation Mode](../../media/v14/shipping-provider-config-modal.png) + ![Choose Shipping Calculation Mode](../../media/v14/shipping-provider-config-modal.png) -* Populate the shipping method name, alias, sku and optional tax rate +5. Enter the **Shipping Method Name**, **Alias**, **SKU**, and optional **Tax Rate**. -![Shipping Method Details](../../media/v14/shipping-method-general-settings.png) + ![Shipping Method Details](../../media/v14/shipping-method-general-settings.png) -* Choose the range unit to base the rates upon -* Click `Add Range` to define each range +6. Choose the range unit to base the rates upon. +7. Click **Add Range** to define each range. + ![Shipping Method Rates](../../media/v14/shipping-method-dynamic-rates.png) -![Shipping Method Rates](../../media/v14/shipping-method-dynamic-rates.png) +8. Enter the **From** and **To** value of the range. +9. Enter the rate details from the available rate options leaving blank any option you do not wish to apply. -* Populate the from and to value of the range -* Populate the rate details from the available rate options, leaving blank any option you don't wish to apply + ![Shipping Method Rate](../../media/v14/shipping-method-dynamic-rate-editor.png) -![Shipping Method Rate](../../media/v14/shipping-method-dynamic-rate-editor.png) +10. Select the countries in this shipping method should be allowed in. -* Configure the countries in this shipping method should be allowed in + ![Shipping Method Allowed Countries](../../media/v14/shipping-method-countries.png) - -![Shipping Method Allowed Countries](../../media/v14/shipping-method-countries.png) \ No newline at end of file +11. Click **Save**. diff --git a/14/umbraco-commerce/reference/shipping/fixed-rate-shipping.md b/14/umbraco-commerce/reference/shipping/fixed-rate-shipping.md index 77675dcd462..9801b016105 100644 --- a/14/umbraco-commerce/reference/shipping/fixed-rate-shipping.md +++ b/14/umbraco-commerce/reference/shipping/fixed-rate-shipping.md @@ -8,28 +8,29 @@ Fixed rate shipping in Umbraco Commerce allows you to define a single, fixed shi ## Configuration -* Go to `Settings > Commerce > Stores > {Your Store} > Shipping Methods` +1. Go to **Settings** > **Stores** > {Your Store} > **Shipping Methods**. -![Shipping Methods](../../media/v14/shipping-methods-list-view.png) + ![Shipping Methods](../../media/v14/shipping-methods-list-view.png) -* Click `Create Shipping Method` -* Choose the `Basic` shipping provider +2. Click **Create Shipping Method**. +3. Choose **Basic** as the shipping provider. -![Choose Shipping Provider](../../media/v14/shipping-provider-modal.png) + ![Choose Shipping Provider](../../media/v14/shipping-provider-modal.png) -* Chose the `Fixed` calculation mode option +4. Choose **Fixed** as the calculation mode option. -![Choose Shipping Calculation Mode](../../media/v14/shipping-provider-config-modal.png) + ![Choose Shipping Calculation Mode](../../media/v14/shipping-provider-config-modal.png) -* Populate the shipping method name, alias, sku and optional tax rate -* Enter a fixed rate for the shipping method +5. Enter the **Shipping Method Name**, **Alias**, **SKU**, and optional **Tax Rate**. +6. Enter a fixed rate for the shipping method. -![Shipping Method Details](../../media/v14/shipping-method-fixed-rate-general-settings.png) + ![Shipping Method Details](../../media/v14/shipping-method-fixed-rate-general-settings.png) -* Configure the countries this shipping method should be allowed in +7. Select the countries this shipping method should be allowed in. -![Shipping Method Allowed Countries](../../media/v14/shipping-method-fixed-rate-countries.png) + ![Shipping Method Allowed Countries](../../media/v14/shipping-method-fixed-rate-countries.png) -* Optionally define a country specific fixed rate should you wish to have different rates per country +8. Optionally, define a country's specific fixed rate should you wish to have different rates per country. -![Shipping Method Country Specific Rates](../../media/v14/shipping-method-fixed-rate-country-prices.png) \ No newline at end of file + ![Shipping Method Country Specific Rates](../../media/v14/shipping-method-fixed-rate-country-prices.png) +9. Click **Save**. diff --git a/14/umbraco-commerce/reference/shipping/realtime-rate-shipping.md b/14/umbraco-commerce/reference/shipping/realtime-rate-shipping.md index b72694d5634..38fc5616403 100644 --- a/14/umbraco-commerce/reference/shipping/realtime-rate-shipping.md +++ b/14/umbraco-commerce/reference/shipping/realtime-rate-shipping.md @@ -10,37 +10,34 @@ Realtime rate shipping in Umbraco Commerce allows you to define real-time, up-to To configure Realtime Rate Shipping, follow these steps: -1. Go to **Settings**. -2. Open the **Commerce** folder in the **Commerce** section. -3. Select your store from the **Stores** dropdown. -4. Go to **Shipping Methods**. +1. Go to **Settings** > **Stores** > {Your Store} > **Shipping Methods**. -![Shipping Methods](../../media/v14/shipping-methods-list-view.png) + ![Shipping Methods](../../media/v14/shipping-methods-list-view.png) -5. Click **Create Shipping Method**. -6. Choose the shipping provider for the shipping operator you wish to use. +2. Click **Create Shipping Method**. +3. Choose the shipping provider for the shipping operator you wish to use. -![Choose Shipping Provider](../../media/v14/shipping-provider-modal.png) + ![Choose Shipping Provider](../../media/v14/shipping-provider-modal.png) -7. Choose **Realtime** in the calculation mode option. +4. Choose **Realtime** as the calculation mode option. -![Choose Shipping Calculation Mode](../../media/v14/shipping-provider-config-modal.png) + ![Choose Shipping Calculation Mode](../../media/v14/shipping-provider-config-modal.png) -8. Enter the **Shipping Method Name**, **Alias**, and **SKU**. -9. Select the tax class from the **Tax Class** dropdown list. +5. Enter the **Shipping Method Name**, **Alias**, and **SKU**. +6. Select the tax class from the **Tax Class** dropdown list. -![Shipping Method Details](../../media/v14/shipping-method-general-settings.png) + ![Shipping Method Details](../../media/v14/shipping-method-general-settings.png) -11. Enter the shipping provider's API credentials required to connect to the shipping operator's API. +7. Enter the shipping provider's API credentials required to connect to the shipping operator's API. -![Shipping Method Settings](../../media/v14/shipping-method-realtime-settings.png) + ![Shipping Method Settings](../../media/v14/shipping-method-realtime-settings.png) -12. Configure any additional charges for this shipping method. +8. Configure any additional charges for this shipping method. -![Shipping Method Options](../../media/v14/shipping-method-realtime-options.png) + ![Shipping Method Options](../../media/v14/shipping-method-realtime-options.png) -13. Select the countries this shipping method should be allowed in. +9. Select the countries this shipping method should be allowed in. -![Shipping Method Allowed Countries](../../media/v14/shipping-method-countries.png) + ![Shipping Method Allowed Countries](../../media/v14/shipping-method-countries.png) -14. Click **Save**. +10. Click **Save**.