# 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:
- Sign up for REES46 site:
- Open this page
- Create your personal account
- Create a project for your store
- 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:
- 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.
- 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.
- In OpenCart Administration panel, navigate to Extensions > Modifications, and then click Clear. NOTE: Please wait until the system finishes clearing cached files.
- In OpenCart Administration panel, navigate to Extensions > Modifications, and then click Refresh.
# Install the Module
- 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.
- In OpenCart Administration panel of your store, navigate to Extensions > Extension Installer.
- Click Upload to upload the downloaded archive rees46.ocmod.zip to rees46.com.
- In OpenCart Administration panel, navigate to Extensions > Modifications, and then click Clear.
- NOTE: Please wait until the system finishes clearing cached files.
- In OpenCart Administration panel, navigate to Extensions > Modifications, and then click Refresh
- In OpenCart Administration panel, navigate to Extensions > Modules, and install this module.
# Configure REES46 Module
To configure REES46 Module:
- In OpenCart Administration panel menu, navigate to Extensions > Modules > REES46, and then open the General tab.
- 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).
- Set Module Status to Enabled.
- Click 💾 to save the current module settings.
A General tab
example:
# 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:
- In OpenCart Administration Panel menu, navigate to Extensions > Modules > REES46, and then open the Web Push tab.
- 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:
# 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:
- In Opencart Administration Panel menu, navigate to Extensions > Modules > REES46, and then open the Recommendations tab.
- Click Add New to add a new block of recommendations.
- Configure settings for the newly added block.
- Click 💾 to save the current module settings.
Note
It is necessary to create new settings for each Recommendation Block.
A Recommendations tab
example:
An example of the recommendation block settings page:
# Configure Layout Setting
To configure Layout Settings, use OpenCart Administration Panel interface.
To clarify, consider the following screenshots:
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
- Enable Developer Console in your browser.
- Find the Network tab, where requests are displayed when you refresh the page.
- Enable filtering mode to see only XHR-requests.
- Check there are requests leading to api.rees46.com.
# Test Event Dispatch
- Open a product page and make sure you can see in Developer Console a push event leading to api.rees46.com.
- Then click "Add to Cart" and make sure you can see in Developer Console a new push event leading to api.rees46.com.
- 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.
- Complete this test order and make sure you can see on the final page a push event leading to api.rees46.com.
# Check Recommendation Requests
- Open a page with embedded blocks of Product Recommendations and make sure you can see in Developer Console requests leading to api.rees46.com.
- Make sure that the number of requests corresponds to the number of Recommendation Blocks on the page..
- Do the same for other pages with embedded Recommendation Blocks (i.e. Home page, Category page, Product page, Cart page).
- 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.