Connecting your Store #
The first step of installing Clerk.io, is connecting your store with your Clerk.io account.
After following these simple steps you will be able to see your Demo Store, which gives you a personal overview of how Clerk.io will work on your webshop, before setting up the rest of the system.
1. Add Store #
After logging in to my.clerk.io, the first thing you need to do is add your store:
Write the Name and Domain of your webshop
Choose WooCommerce as the Platform and choose your Currency.
Click Add Store.
2. Install and configure plugin #
From the main menu of the Setup Guide, click Install Extension:
The next page shows what you need to do, to install and configure the WooCommerce plugin.
Follow the steps to enable the plugin:
3. Sync your store #
After configuring the plugin, you simply need to synchronise your store.
Go back to the Setup Guide and click Sync Your Data:
Write in your stores details and click Start Sync:
Clerk.io will now import your products, categories and sales.
When its done, your store is connected. Good job!
Full installation example #
In this video you can get a complete overview of what it takes to set up Clerk.io on a WooCommerce webshop.
It will guide you through the following steps:
Adding a Store in my.clerk.io #
Each Store in Clerk.io is an isolated environment with its own data, API keys and Dashboard. The first thing you will need to do when setting up your Clerk.io account, is to create your first Store:
Installing the plugin #
You can download the latest plugin Source code (zip) from here:
https://github.com/clerkio/clerk-woocommerce/releases/latest
The plugin will let you sync your WooCommerce store, add all the necessary scripts and elements to WooCommerce, and let you add Clerk.io elements to the webshop easily.
Syncing your WooCommerce Store with Clerk.io
To show results, Clerk.io must sync with the products, categories, sales, pages and customers from WooCommerce.
This is done by configuring the plugin in WooCommerce with the API keys to set up a Data Sync
Now you are ready to start adding Clerk.io elements.
Adding Search and Recommendations #
Frontend elements in Clerk.io consist of two parts:
A Design that controls the visual presentation of products. This can be changed to match any styling you want. Most often you will use 3 Designs:
One for Instant Search, the Search page and Recommendations.
The Setup Guide will help you create Designs and Content while the Plugin lets you activate them on the webshop by automatically inserting the embed codes.A Content that displays the products. The Content has attached embed codes that will be inserted on the right page automatically, when configuring the plugin:
For the Powerstep and Search Page, you will also need to create two individual Pages in WooCommerce to display them.
And that’s all there is to it, reach out to us if you need any further help!
Multi-language #
When using WPML in WooCommerce, you should be able to differentiate your languages by URL, like this:
If you have unique URLs like this, you can extend the WooCommerce plugin to support WPML.
It is also ok to define the language via the lang paramter. Eg.
1. Create Stores #
The easiest way to implement Clerk.io in multiple domains in standard setups is by creating a separate Store for each domain in my.clerk.io.
This way, you can separate products, sales, currencies etc. to keep track of each domain.
1. Start by creating your main Store and follow the Setup Guide to connect your Store to Clerk.io and choose the Recommendationsand/or Search Results that you want to display on your webshop.
2. When you are done with the initial setup, go back to the start page of my.clerk.io (by clicking the Clerk.io logo in the upper left side corner of the side-menu) and then click "+ Add new store" the last option of the scroll down list (generally under you the existing store(s) and your company name):
3. On the Add New Store page, click Advanced to see all settings.
4. Fill in the details of your webshop, and choose your main Store from the Copy Content From Existing Store dropdown, then click Add Store.
This will carry over the Content and Designs from your main Store.
Remember to translate Headlines, in Content-> Edit -> Select Design to the right language as well.
2. Install and Configure #
Official support for WPML has been added to the Clerk.io WooCommerce Extension, which means that as long as you use that version or a newer one, WPML should be supported.
In the settings panel for woocommerce you will see the settings as normal. If WPML is active and configured on your WordPress site, you will see Multi Language Scope with the current language towards the top of the settings page.
In order to swap the language simply use the selector on the top panel. You should select the language you wish to configure Clerk for, and provide your desired settings. Repeat this for each language.
Note that selecting ‘All Languages’ from this dropdown, is not advised when saving your configuration, since it will only save your settings as a fallback only.
3. Sync your domains #
Once you have extended the plugin, you can now sync each of your Stores with their language domain.
As you have already installed the extension you can skip the first step directly start configuring it and syncing data.
8. When the Sync has finished, your domain is ready and using the same setup as your main Store.