uCommerce includes full API reference documentation and lots of helpful articles to help you build your e-commerce site as effortlessly as possible.
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.
When you have finished the installation, you will have all the benefits from Umbraco as a Service on uCommerce, like below e.g.
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.
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.
If you want Umbraco to use the same database as uCommerce, just let the connectionStrings section be empty and remove the value from umbracoConfigurationStatus in appSettings.
<appSettings> <!-- Umbraco web.config configuration documentation can be found here: http://our.umbraco.org/documentation/using-umbraco/config-files/#webconfig --> <add key="umbracoConfigurationStatus" value="" /> ... </appSettings> <connectionStrings> </connectionStrings>
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:
uCommerce is now installed on your site and all uCommerce tables are added to your uCommerce database.
If you are have any problems or feedback, don’t hesitate to let us know. Just create a post on Eureka.