REES46 Guide

# OpenCart 2

This guide explains how to install and integrate the REES46 OpenCart module (hereafter REES46 module) with your online store built on the OpenCart platform. This module gives your store full access to REES46 functionality. With REES46, you improve your sales performance.

# Install REES46 OpenCart 2 Module

This topic explains how to integrate REES46 module with your online store built on the OpenCart 2.x platform.

# Add Your Store to REES46

Before installing the module, add your online store to rees46.com.

To add your store:

  1. Sign up for REES46 site:
    • Open this page
    • Create your personal account
    • Create a project for your store
  2. Note down your Store Key and Secret Key.

NOTE

Store Key and Secret Key are unique identifiers that look somewhat like this: 640e3aq6dd5e70c8156e75238bf4e2. They are used to access REES46 functionality through our API.

TIP

You can always find your Store Key and Secret Key in your personal account space on rees46.com (navigate to Settings > Store Settings).

# Install REES46 Module

This section helps you install REES46 Module and integrate your store with REES46.

# Install Quick Fix Patch

Before installing this module, ensure that you have installed Quick Fix patch.

To install the patch:

  1. Download Quick Fix patch by performing the following steps:
    • Open this page (opens new window) and click DOWNLOAD.
    • When prompted, log in to your OpenCart account space (use your OpenCart login and password).
    • On the page that opens, click DOWNLOAD to download Quick Fix Zip-archive.
    • Unzip the Zip-archive.
  2. In OpenCart Administration panel of your store, navigate to Extensions > Extension Installer, and then click Upload to upload the localcopy.ocmod.xml file you unzipped from Quick Fix Zip-archive.
  3. In OpenCart Administration panel, navigate to Extensions > Modifications, and then click Clear. NOTE: Please wait until the system finishes clearing cached files.
  4. In OpenCart Administration panel, navigate to Extensions > Modifications, and then click Refresh.

# Install the Module

  1. Download the module Zip-archive by performing the following steps:
    • Open this page (opens new window) and click DOWNLOAD.
    • When prompted, log in to your OpenCart account space (use your login and password).
    • Select and download the archive for your OpenCart version.
  2. In OpenCart Administration panel of your store, navigate to Extensions > Extension Installer.
  3. Click Upload to upload the downloaded archive rees46.ocmod.zip to rees46.com.
  4. In OpenCart Administration panel, navigate to Extensions > Modifications, and then click Clear.
  5. NOTE: Please wait until the system finishes clearing cached files.
  6. In OpenCart Administration panel, navigate to Extensions > Modifications, and then click Refresh
  7. In OpenCart Administration panel, navigate to Extensions > Modules, and install this module.

# Configure REES46 Module

To configure REES46 Module:

  1. In OpenCart Administration panel menu, navigate to Extensions > Modules > REES46, and then open the General tab.
  2. In Store Key and Secret Key, specify your Store Key and Secret Key, respectively. NOTE: You can always find your Store Key and Secret Key in your personal account on rees46.com (navigate to Settings > Shop Settings).
  3. Set Module Status to Enabled.
  4. Click 💾 to save the current module settings.

A General tab example:

Install opencart extension

# Configure Web Push Notifications

This topic explains how to configure Web Push notifications.

Important

To use the Web Push notifications feature, your website must support HTTPS protocol.

To upload files:

  1. In OpenCart Administration Panel menu, navigate to Extensions > Modules > REES46, and then open the Web Push tab.
  2. Click Check files.

Note

Clicking the Check files button uploads the manifest.json and push_sw.js files (if necessary) to the root of your website and checks whether they are properly installed. OpenCart Administration Panel sends a notification message upon completing this operation.

A Web Push tab example:

Web push for OpenCart 2

# Product recommendations

Read detailed guide about products recommendations configuration and design in Product recommendations.

# Add Recommendation Blocks

This section helps you embed Recommendation Blocks into your website pages.

To add a new Product Recommendation Block to REES46 module:

  1. In Opencart Administration Panel menu, navigate to Extensions > Modules > REES46, and then open the Recommendations tab.
  2. Click Add New to add a new block of recommendations.
  3. Configure settings for the newly added block.
  4. Click 💾 to save the current module settings.

Note

It is necessary to create new settings for each Recommendation Block.

A Recommendations tab example:

Product recommendations

An example of the recommendation block settings page:

Product recommendations

# Configure Layout Setting

To configure Layout Settings, use OpenCart Administration Panel interface.

To clarify, consider the following screenshots:

Product recommendations

Product recommendations

Note

For information on how to use the Design and Layouts feature in OpenCart Administration Panel, see “Chapter 6: Design” in Definitive Guide to Getting Started with OpenCart 2.x (opens new window).

# Operability Test for OpenCart 2

This topic explains how to perform an operability test to ensure a successful installation.

# How to Perform the Test

  1. Enable Developer Console in your browser.
  2. Find the Network tab, where requests are displayed when you refresh the page.
  3. Enable filtering mode to see only XHR-requests.
  4. Check there are requests leading to api.rees46.com.

# Test Event Dispatch

  1. Open a product page and make sure you can see in Developer Console a push event leading to api.rees46.com.
  2. Then click "Add to Cart" and make sure you can see in Developer Console a new push event leading to api.rees46.com.
  3. Go to the Cart and remove the product from it. Make sure you can see in Developer Console a push event leading to api.rees46.com.
  4. Complete this test order and make sure you can see on the final page a push event leading to api.rees46.com.

Test events tracking

# Check Recommendation Requests

  1. Open a page with embedded blocks of Product Recommendations and make sure you can see in Developer Console requests leading to api.rees46.com.
  2. Make sure that the number of requests corresponds to the number of Recommendation Blocks on the page..
  3. Do the same for other pages with embedded Recommendation Blocks (i.e. Home page, Category page, Product page, Cart page).
  4. If you embedded the "Customer Who Looked For This Item Also Bought These" block into the Search Results page, perform a search and make sure you can see a request leading to api.rees46.com.

Recommendations test