Before we begin, it should be noted that the evision ecommerce Accelerator is built as an extension library, making it possible to use it in any .Net based website. We have chosen to use Umbraco as an example CMS platform, as this makes displaying the WebShop capabilities fairly simple, and Umbraco will help with the CMS part of the homepage, which is not part of the evision ecommerce Accelerator.
Also it should be noted, that this tutorial is based on a package for Umbraco7 which we only make available for partners. Do you need a package to begin your journey as an evision ecommerce frontend developer? Contact us.
To follow this tutorial, please meet the following prerequisites:
- Microsoft SQL Server 2016 (any full version will work - CE will NOT work)
- Visual Studio 2017 (any version should work, but make sure you have access to NuGet or a similar way to get Umbraco)
- Microsoft IIS (not required, but nice to have for testing publishing)
- The evision ecommerce Umbraco7 BackOffice package
The Umbraco7 BackOffice package is specifically developed to ease the install and management of the evision ecommerce accelerator when using Umbraco. If you are NOT planning on using Umbraco, please contact us for a guided setup of the evision ecommerce accelerator.
Some of the following steps will seem very basic to most developers, but will still inform you of which type of project is the base for this tutorial. If you know how to set up Umbraco, you can follow your own steps - just be careful to choose the correct type of database.
This guide will walk you through the following steps
- Installing Umbraco in Visual Studio 2017
- Installing the Umbraco database correctly
- Installing the evision Umbraco7 BackOffice (which installs the evision ecommerce Accelerator)
- Registering the License
- Add a Reference to the evision ecommerce Accelerator
1.1 In Visual Studio, open file, and choose "New project".
1.2 From the left menu, choose: Templates, Visual C#, Web.
1.3 Choose the ASP.NET Web Application (.NET Framework) template
1.4 Give your project a name and click OK
1.5 Choose the Empty template and click OK
1.6 Rightclick your project, and choose "Manage NuGet Packages"
1.7 Click "Browse", then type in "Umbracocms" in the search field, choose the first on the list, and click Install
- Wait for NuGet to gather all the dependencies -
1.8 Click "I Accept" to the License Acceptane of the list of dependent NuGet packages
1.9 When finished installing, Umbraco will show a readme.txt file
You now have a WebSite project with Umbraco cms ready to be installed in a database
2.1 Open Microsoft SQL Management Studio
2.2 Connect with your Microsoft SQL Server
2.3 Rightclick and Create a new database
2.3.1 Give your database a name and click "OK"
2.4 (Optional) Create a new user login and set it as dbo on the database*
2.4.1.Rightclick "Security" and choose "New" -> "Login..."
2.4.2 Add a Login Name, Choose "SQL Server authentication, remove checks to change password, password expiration and password policy, and add a password
2.4.3 Click User Mapping
2.4.4 Find and check your database
2.4.5 Click "db_owner" in the list of Database role memberships for your database
2.4.6 Click OK
2.5 Go back to your visual studio project
2.6 Run the website (which automatically builds)
2.7 Agree to modify Web.config for debugging
- Umbraco shows the install screen -
2.8 Enter a username, email and password (remember email and password for later)
2.9 IMPORTANT: Choose the "Customize" button, NOT the "Install"
2.10 Choose Microsoft SQL Server from the dropdown
2.11 Fill out your SQL Server name and name of the database you created
2.12 If you created a dbo user, enter the credentials you used. Otherwise just click "use integrated"
2.13 Click "Continue"
2.14 Accept generating a Machine Key by clicking "Continue"
2.15 Please do NOT install the starter website. The next tutorial "Developer's Guide" will walk through adding all the pages you need for a "template webshop".
- Wait for Umbraco to install the database
2.16 When the installation is done, Umbraco will show you their own walkthrough (please keep the backoffice open and running for the next part. you can close the tour)
*If you are working locally, you don't need to create a specific SQL user, as your local windows user should be SA (sysadmin) on the SQL Server when the SQL Server is installed locally. Windows Integrated Security runs differently depending on OS and domain settings, and will not be covered in this tutorial. If you run into problems with integrated security, please use a normal SQL user login.
With Umbraco installed, and the umbraco backoffice running we are ready to add our package
3.1 In the running Umbraco BackOffice, open the Developer tab, then click on "Packages".
3.2 In the top right corner, click "Install Local"
3.3 Drag your evision ecommerce Umbraco7 package to the install pane
3.4 Click Install
- Wait for the package to install
3.5 Click Finish
4.1 Open the new Evision tab
4.2 Open the Settings list, and click "License"
4.3 Click the "Begin Trial" button (if you are a partner, you can register your developer license here)
- The trial is installed and will run for 30 days for free.
5.1 Close the website
5.2 Stop debugging
5.3 Rightclick the project References and click "Add Reference"
5.4 Browse to your bin folder and choose the "evision.ecommerce.dll" and press "Add".
You can now use the evision ecommerce accelerator directly in your website application.