Magento 2 Installation Guide

About this extension

The Athos Commerce extension is specifically designed to facilitate a seamless data connection between your Magento store and Athos. With this extension, you can effortlessly fetch and sync your product data from Magento's catalog into Athos' indexing process.

Note: This extension does not handle any elements related to the integration with your live storefront or the implementation steps required to incorporate Athos onto your website.

What versions of Magento 2 are supported?

This extension officially supports the 2.4.X versions of Magento 2 that is currently supported by Adobe Commerce.

Before you get started

You must have an Athos account before proceeding with this installation guide. Without an account, you will not be able to establish the connection.

If you are a new customer

• If you already have access to the Athos Search & Product Discovery Console (ASD), proceed to Step 1.
• If you do not have an account to access the ASD, ask your main team contact to add you as a "User" in the User Website Management section of the ASD. Once you can access the ASD, proceed to Step 1.

Step 0: Pre-installation

• Ensure your Magento cron is running.
• Ensure that the Athos IP addresses are added to your "allow" list.
• If you have basic authentication set up, make an exception for the following URLs:
  • /oauth/.* 
  • /rest/V1/athoscommerce/.* 

Step 1: Installing the Extension

Install the Athos Adobe commerce module using the below composer and Magento commands:

composer require athoscommerce/magento2-module
bin/magento setup:upgrade
bin/magento setup:di:compile
bin/magento setup:static-content:deploy
bin/magento cache:flush

Step 2: Adding the Integration

1. Go to your Magento 2 store, click the "System" section, and select "Integrations".
   
2. Click the "Add New Integration" button.
   
3. Go to the "API" tab, select Athos, and ensure the following checkboxes are checked (enabled):
   • Products 
   • Customers (optional if not using Personalized Recommendations) 
   • Sales (optional if not using Personalized Recommendations) 

4. Go to the "Integration Info" tab and manually fill in the following:
   • Name: "Athos" 
   • Callback URL: https://console-service-apis.athoscommerce.net/api/connector/magento/activate
   • Identity link URL: https://console.athoscommerce.net/data-connectors/data-sources/adobe-commerce/app-installation
   • Your Password: Enter your Magento 2 store password 

5. Click the arrow beside "Save" and then select "Save & Activate".
6. Click "Allow" to proceed to the next step of the setup process.
   

Step 3: Authentication

7. If you are not logged into the Athos Console (ASD), you will be taken to a landing page where you can click the link beside "Already a Athos client?".
8. If you are already logged into the ASD, skip to Step 10.
9. Log in using your ASD email/password.
10. Select the website you would like to use from the drop-down menu. Be sure to review this carefully before proceeding.
11. If successful, you should be taken to the Data Source page in the ASD with the Adobe Commerce platform listed.
12. Once this is complete, reach out to your Athos point of contact.