Documentation

Ucommerce includes full API reference documentation and lots of helpful articles to help you build your e-commerce site as effortlessly as possible.

Topics Payment Providers
v7.18

Install Ucommerce on Umbraco as a Service

This article will explain how you can get started with Ucommerce on Umbraco as a Service. It is assumed that you already have setup your Umbraco as a Service environments. If you are interested in how to setup Umbraco as a Service, you can find more information here.

image

When you have finished the installation, you will have all the benefits from Umbraco as a Service on Ucommerce, like below e.g.

image

Ucommerce on a local Umbraco as a Service Environment

When you are going to install Ucommerce there is some manually steps that you have to follow before the installation is succeed and you can start using Ucommerce.

Add a new connection

When you are on your local environment, your Umbraco as a Service use a SQL CE database, which Ucommerce doesn't support.

The first thing that you need to do is to setup an empty SQL Express/Enterprise Database, which is going to be your local Ucommerce database. After you have created the database, you need to add a connection string for that database in the web.config.

    
    <connectionStrings>
    	<remove name="umbracoDbDSN" />
    	<!--Connection string for Umbraco SQL CE database-->
    	<add name="umbracoDbDSN" connectionString="Data Source=|DataDirectory|\Umbraco.sdf" providerName="System.Data.SqlServerCe.4.0" />
    	<!-- Important: If you're upgrading Umbraco, do not clear the connection string / provider name during your web.config merge. -->
    	<!--Connection string for your empty Ucommerce Database-->
    	<add name="uCommerce" connectionString="server=YOUR_SERVER;database=YOUR_DATABASE;user id=YOUR_USER;password=YOUR_PASSWORD" providerName="System.Data.SqlClient" />
    </connectionStrings>
    

When you install Ucommerce, Ucommerce looks for a connection string with a name equal to "uCommerce". Therefore, is it important that you use Ucommerce as value for the name of the connection string.

Install Ucommerce

The next thing to do is install Ucommerce through the Umbraco back-office as you normally do.

After the installation is succeed and you see the following screen:

image

Ucommerce is now installed on your site and all Ucommerce tables are added to your Ucommerce database.

FAQ

If you are have any problems or feedback, don’t hesitate to let us know. Just create a post on Eureka.