# Uccelerate

Welcome to the documentation for Uccelerate.

{% hint style="info" %}
**Uccelerate is based on Igloo theme**, for more information about content widgets and general setup see the [Igloo Theme Documentation ](https://docs.iglootheme.com)
{% endhint %}

{% content-ref url="/pages/-MR\_g11XiQ-tj7\_RnHbe" %}
[Installation](/getting-started/installation)
{% endcontent-ref %}

{% content-ref url="/pages/-MR\_iwFUvw13VGKc1i\_g" %}
[General setup](/getting-started/general-setup)
{% endcontent-ref %}


# FAQ

### Can i update **Uccelerate** to the latest version?

We do not have support for updating Uccelerate to the latest version since updates would delete any possible modifications made to the theme. You can however do a merge of the files from the latest package into your own solution to the newest version. There might however be breaking changes in between versions, so do this at your own risk.

### **Checkout stuck on loading / 500 error from the checkout API**

This is most likely due to Uccelerate not being able to find a shipping or payment method from Ucommerce or not having the right security level set. Make sure everything is set up correctly in Ucommerce under settings.


# Changelog

## Uccelerate 2.1

### Fixed

* Max limit of 300 products on category
* Umbraco Forms dependencies updated towards latest Umbraco Forms
* Null exception on Accardion widget
* Null exception on Search page when there is no container width set
* Removed console errors
* Related products used id:s instead of Guids and would break
* Theme Alt Contrast would not update

### New

* Member logout path added
* Hide/Show in sub header depending on login state
* Ucommerce 9.4 support


# Installation

## **Step 1**

To install Uccelerate, you first need to have a working Ucommerce installed. To do this, follow the instructions on [**Ucommerce For Umbraco**](https://docs.ucommerce.net/ucommerce/v9.3/umbraco/install-ucommerce-on-Umbraco.html). We recommend that you make a local installation from NuGet.

## Step 2

{% hint style="info" %}
**If you intend to use Umbraco Forms** in your project make sure to install that before installing Uccelerate.
{% endhint %}

When you have a running Ucommerce installation you can install the package provided to you on purchase. The installation is a standard Umbraco package installation. Follow the steps below.<br>

1. Log in to your Umbraco site and go to the Developer section.
2. Click on Packages
3. Click on Install local
4. Drag in the Uccelerate package
5. Accept terms of use and click Install Package

### Installation on Umbraco Cloud

If you intend to host the solution on Umbraco Cloud we recommend that you run the installation locally first and then push it to Cloud to ensure that all files and changes from the installation are committed to Git.

## **Step 3**

After installation, you need to install the license provided to you on purchase. You do this the same way you install the Ucommerce license. You simply add the **Uccelerate.key** to your root folder and restart the site.

## After installtion

1. Go to the Content section and right click the site node than choose ”Publish”. Check both checkboxes and press the ”Publish” button.
2. Add SMTP credentials in Web.config &#x20;
3. Connect to Order-confirm E-mail Template node in Ucommerce under Settings > E-mail > Profiles > Default > OrderConfirmation&#x20;
4. Add Shipping Method
5. Add Payment Method


# General setup

### **Product Index**

In Uccelerate we have provided you with an example definition for an index. It can be found in your App\_Code folder, too hook it up you can simply add this to your Custom.config in Ucommerce:

```markup
  <component
    id="ProductsIndexDefinition"
    service="Ucommerce.Search.IIndexDefinition`1[[Ucommerce.Search.Models.Product, Ucommerce.Search]], Ucommerce.Search"
    type="UccelerateProductIndexDefinition" />
```

For more info about index definitions please visit the Ucommerce documentation <https://docs.ucommerce.net/ucommerce/v9.0/Search-and-indexing/IndexDefinitions.html>.

### **Product Definition**

In Uccelerate we have prepared a few features that are optional and you need to add some fields to your product definition to be able to use them.

| Field Name    | Field Type                |
| ------------- | ------------------------- |
| ExtraImages   | Image Picker Multi Select |
| Stock         | Number                    |
| GlobalContent | Content                   |

**ExtraImages**

ExtraImages will show more images on the product pag&#x65;**.**

**Stock**

Here you can add how many products you have in stock or just use 1 or 0 to toggle out of stock message on the product.

**GlobalContent**

With this you can point toward a GlobalContent block so you can show content widgets on your productpages.


# Product Detail

Coming soon.


# Search

## Product Search

Uccelerate includes a basic product search, this includes a searchbar in the header and a searchpage that is added on install in form of a search node in Umbraco. The search page comes with a few display options that you can set on the search node.

![](/files/-MWd3l-Xl7zoji-wyNtl)


# Checkout

Coming soon.


# Product List

The product list widget displays a list of selected products. You can change things like background color, product width and container with. You can also choose to add a buy button in the grid by going to the `Settings > Shop` node in Umbraco and activating `Show Buy Button in Lists`

## Widget

![List Type: Grid](/files/-MR_mlziKv6VXfWOPGAR)

![List Type: Slider](/files/-MR_mrnT-yG1qhqx-Byk)

## Settings

![](/files/-MR_nBL2UQP-RaTCjegU)

* Products
* Heading
* Container Width
* Product Width
* List Type
* Background Color
* Text Color


# Product Category

The product category widget displays products from one or multiple Ucommerce categories.&#x20;

## Widget

## Settings

![](/files/-MRaPZ5OwKvEUXTF1G9a)

* Alias
* Category
* Pin Filter
* Sticky Pinned Filter
* Hide Filter
* Hide Breadcrumbs
* Hide Sorting
* Products Per Page
* Container Width
* Product Width


# Order Confirmation

The Order confirm widget display a success message alongside some information about the order.\
Create a normal Page and then add the widget. Make sure to hide the page from search engines and site navigation in the Page settings. Connect the page by setting the **`AcceptUrl`**  in Ucommerce under your payment method.

## Widget

![](/files/-MR_lgHm_q2TbwvlceJ_)

![](/files/-MR_lsyNeDztfDJcUtRC)

* Heading
* Text


