Troubleshooting

Finding Shopify Theme Files

May 17, 2022
Troubleshooting

Shopify houses over 100 different themes to style and customise your webshop. Each theme works in the same way, that you customise the theme files to get a given result on your store, however, the theme file names change from theme to theme.

How To Find Theme Files #

Shopify gives you a search field to easily and quickly find the theme file you are looking for. If you do not know the name of the file you are looking for, you can use the search field to help locate it. For example if you are looking for the file that has the code for the search page, it is likely to have ‘search’ in the file name.

...

Frontpage Product Sliders are Cached

May 17, 2022
Troubleshooting

Normally this only happens if embedcodes are inserted through Magentos CMS Pages in the backend, as the frontpage is cached:

Instead, your embedcodes should be inserted directly to the Frontpage files, through FTP:

Magento will not cache results when inserted like this.

Handling Require.js in Magento 1 (Only for Clerk v1)

May 17, 2022
Troubleshooting

This guide only applies when using up to v.3.7.2 of the Magento 1 Clerk extension.

In some setups, Require.js stops Clerk.js from loading, which means that no sliders or search results will be shown.

When this happens, the following error will be shown in your console:

Uncaught ReferenceError: Clerk is not defined

There are two ways to handle Require.js. Both approaches require you to make changes to the tracking-script in this file:

...

Handling Require.js in Shopify (only for Clerk JS1 users)

May 17, 2022
Troubleshooting

This guide only applies when using Clerk JS1.

In some setups, Require.js stops Clerk.js from loading, which means that no sliders or search results will be shown.

When this happens, the following error will be shown in your console:

Uncaught ReferenceError: Clerk is not defined

There are two ways to handle Require.js. Both approaches require you to make changes to the tracking-script, which is normally inserted in index.liquid.

Include “clerk” in Require.js #

The best approach is trying to get Require.js to recognize Clerk.io.

...

How to Fix Common JTL Errors When Importing Data to Clerk.io

May 17, 2022
Troubleshooting

When importing data with the JTL plugin, the webshops generated feed is responsible for sending the product- category- and sales-data to Clerk.io.

However in some cases, the feeds configuration might stop the Importer from getting access, causing an error in Data Sync.

Below is a list of the most common errors and how to fix them.

403 Server Error: Forbidden #

This error happens if your server blocks the importer from accessing it. In most cases you simply need to whitelist the importers IP address to give it access. The latest IP address can be found here. Also check your public key, private key and import url are correct for the store you are operating within my.clerk.io

...

How to Fix Common Shopify Errors When Importing Data to Clerk.io

May 17, 2022
Troubleshooting

When importing data with the Shopify extension, the webshops server is responsible for sending the product- category- and sales-data to Clerk.io.

However in some cases, the servers configuration might stop the Importer from getting access, causing an error in Data Sync.

Below is a list of the most common errors and how to fix them.

401 Server Error: Unauthorized #

This error happens if your webshop/dev environment requires HTTP authentication to access it.

...

How To Import Data When Using HTTP Authentication On Magento 1

May 17, 2022
Troubleshooting

Often HTTP authentication is used on staging sites to avoid uninvited visitors.

This will block the Clerk Importer as well and display a 401 Unauthorized error in the sync log.

You can easily verify the importer by inserting the authentication info in the Import URL like below, in Data Sync at my.clerk.io:

http//USER:PASS@magento.clerk.io/clerk/api/store/1:

Identifying Console Errors with Clerk.io

May 17, 2022
Troubleshooting

When setting up Clerk.io you might run into problems, for a number of different reasons.

The most common problem is that you have installed Clerk.io, but products are still not being shown.

This article shows you the messages that Clerk.io shows in the console and explains how to deal with them to help you when debugging.

Checking your browsers console #

If Clerk.io encounters an error, and we know what the error is, you will see a message in your console:

...

Setting Clerk logging-settings in Magento1

May 17, 2022
Troubleshooting

First thing you have to do to change the logging settings, after the first data sync has run successfully, is to go into your Magento1 backend, choose Configuration under System:

Choose the main site (the site you’re attempting to affect) under CURRENT CONFIGURATION SCOPE:

Then, go to Settings => Logging Settings and set your preferred logging-settings and press Save Config:

The Logging settings include:

...