Magento 2.x

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

Install extension

This topic explains how to integrate REES46 extension with your Magento online store (Magento 2.x).

Manual Installation for Advanced Users

1. Download the archive with REES46 Extension (opens new window) and unpack it to the selected place on your PC.
2. Copy the content of the upload folder to the root web directory of your store.
3. In the console (opens new window), run the following series of commands from the root web directory of your store:

php bin/magento module:enable Rees46_Personalization
php bin/magento setup:upgrade
php bin/magento setup:static-content:deploy
php bin/magento cache:clean

4. If you have compilation enabled run the following:

php bin/magento setup:di:compile
php bin/magento cache:clean

Installation via Magento Component Manager

To install REES46 Extension for Magento 2.x via the built-in component manually:

1. Open the REES46 Extension page (opens new window) on Magento Marketplace.
2. Click Add to Cart and complete your checkout (the extension is free of charge).
3. In your Magento account, navigate to My Account > My Access Keys > Magento 2 and copy your Public Key and Private Key (generate them if necessary).
4. In Magento Administration Panel, navigate to System > Tools > Web Setup Wizard > Component Manager.
5. Authorize using the generated Public Key and Private Key.
6. Click Sync to synchronize your existing extensions with Magento Marketplace.
7. Wait till the synchronization is complete and then click Install.
8. Select the checkbox next to rees46/personalization and complete the installation.
9. Navigate to Store > Settings > Configuration > Advanced > Advanced.
10. Check that Rees46_Personalization is enabled and save the settings.
11. Navigate to System > Tools > Cache Management and clear the cache.

Automatic Configuring REES46 Extension

This section helps you configure the basic settings of REES46 Module in an automatic mode. You can perform an automatic configuration in one of the following ways:

1. Authorization of your store (use this method if you have already registered your store on rees46.com)
2. Registration of your store

To configure REES46 module:

• In Magento Administration panel, navigate to Stores > Settings > Configuration > REES46 > Settings

Authorization of Your Store

To configure the module through authorization of your store if has already been registered on rees46.com, complete the following steps:

1. Click AUTHORIZE. This opens an authentication form:

2. In the Store Key and Secret Key text boxes, enter appropriate values that you can always find in your personal account on rees46.com (Settings > Store Settings).

Note

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

3. Click Send.

The authorization process initiates the following operations:

• authenticating your store in rees46.com
• exporting XML-links to rees46.com
• exporting order history
• exporting customer list
• uploading the manifest.json and push_sw.js files (they are used for Web Push notifications)

Registration of Your Store

To register your store in rees46.com, complete the following steps:

1. Click REGISTER. This opens a registration form:

2. In the registration form, complete all fields (note that all fields are mandatory).
3. Click Send.

The registration process initiates the following operations:

• registering a user on rees46.com
• registering your store on rees46.com
• authenticating your store on rees46.com
• exporting XML-links to rees46.com
• exporting customer list
• uploading the manifest.json and push_sw.js files (these are used for Web Push Notifications).

4. Right after you will see a checklist for the described operations with the Repeat buttons to reinitiate the failed operations.

Note

To include a Cron task for updating your XML-file in the background mode, select "Yes" in the drop-down list next to the Cron XML option. In this scenario, an XML-file generated by Cron task will be loaded instead of automatic XML-file generation by the module. For this functionality to work, you must first adjust the Cron scheduler on your Magento-based website.

Logging is used by system administrators. If you do not know what this option stands for, do not enable logging.

Finish Configuring REES46 Extension

Perform the configuration of REES46 Extension after completing authorization or registration of your store.

To configure REES46 Extension:

1. In Magento Administration Panel, navigate to Stores > Settings > Configuration > REES46 > Settings.
2. In the General settings choose appropriate for your Order Statuses, and then click Save.

Configure Web Push Notifications for Magento 2.x

Important

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

To configure Web Push notifications, upload the manifest.json and push_sw.js files to the root directory of your website. These two files are automatically uploaded by the module during initial configuration of REES46 module.

If the module failed to automatically upload the required files, do the following:

• Upload the manifest.json (opens new window) and push_sw.js (opens new window) files to the root of your website (for example, via an FTP client).

Configure Notifications for Mac Users

To configure your website to send Web Push notifications to Mac users, you should register as a push provider with Apple in the Certificates, Identifiers & Profiles (opens new window) section of your Apple developer account, generate Website Push Notification certificate, and then upload a private key to rees46.com.

For detailed information, see Configuring Safari Push Notifications (opens new window) и Configure Web Push Notifications for Mac Users.

Set Up & Design Product Recommendations

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

Add Recommendation Blocks

To add a new Recommendation block in REES46 Extension:

1. In Magento Administration panel menu, navigate to Content > Elements > Widgets.
2. Click Add Widget.
3. Select REES46 Recommendations and the template in the respective drop-down lists.

4. Click Continue.
5. On the newly opened Storefront Properties tab, select the type, theme, title, page (store views) and sort order. You can specify the pages for each recommendation block in the Layout Updates section (appears when you have chosen all the settings from the screenshot below).

6. Switch to the Widget Options tab and choose the block type, title, template, product limit, image dimensions. You can also choose to show only your special offers (discounted items, hot sales, daily sales, hot products, etc.) or choose the brands you want to show in the product recommendations.

7. Don't forget to click Save.

Note

After installing and configuring this module, Recommendation Blocks are not immediately displayed. Depending on your website traffic, it can take from minutes to hours for them to appear.

Operability Test for CS-Cart

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.

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.