Connectors

The Magento 2 Connector

Using Memsource, you will be able to translate products, categories, pages, and blocks from Magento 2. You can manually upload your content or you can configure Automated Project Creation to initiate jobs based on rules that you define in a project template. This article provides a step-by-step guide to setting up and using the Memsource Connector extension for Magento 2.

Requirements

Before you begin, make sure that you are running Magento CE 2.1 or newer.

Installation

There are three ways to install the Memsource Connector extension into your Magento 2 instance: through the Magento Marketplace, by using Composer, or by installing it manually. Each of these three options will be explained below:

Installing via Magento Marketplace

Find the Memsource Connector on the Magento Marketplace and get the extension by clicking on Add to Cart:

 

In the Magento Administration, go to System and click on Web Setup Wizard:

 

Then, choose the Extension Manager:

 

Under the number of extensions to install, click on Review and Install:

 

On the list of extensions, find the Memsource Connector, and click on the Install link:

 

Now, we'll go through the installation of the extension. Let’s start with the Readiness Check:

 

Once you’ve passed the Readiness Check, you can continue the installation process by clicking the Next button. After this, you will be asked to create a data backup:

 

After the backup process is complete, you are ready to install the Memsource extension—just click the Install button:

 

Note: If you are not sure about any of the steps above, check out Magento Docs for further information.

Installing via Composer

To install the extension via Composer:

composer require memsource/magento2-connector
php bin/magento module:enable Memsource_Connector
php bin/magento setup:upgrade
php bin/magento setup:static-content:deploy

Manual Installation

If you are unable to use either Magento Marketplace or Composer, you can install the connector manually. To do this, follow the steps below:

Step 1: Download the zip file from GitHub releases.

Step 2: In your Magento 2 installation, extract the downloaded zip file into the folder app/code/Memsource/Connector

Step 3: Enable the extension and clear the cache:

php bin/magento module:enable Memsource_Connector
php bin/magento setup:upgrade
php bin/magento cache:flush
php bin/magento setup:di:compile
php bin/magento setup:static-content:deploy

Configuration

Set up a Multilingual Website

Now it’s time to connect Memsource with Magento. First, make sure that you have correctly set up your websites, stores and store views. Sign in to the Magento Administration, go to Stores, and click on All Stores:

 

Every language is associated with a store view, so if you want to use two languages, you will need at least two store views. If you don’t have enough store views, you can add more by clicking the Create Store View link:

 

Then, you have to provide some basic information about your new store view and click Save:

 

Every store view should have a language associated with it. To set them up, go to Stores and click Configuration: 

 

Select your store view from the dropdown menu: 

 

Set the language for your store view. Update the Locale Options and click on Save Config:

 

Now, you'll need to obtain the URL and token for API calls. Do this in Magento 2 by going to Stores, clicking on Configuration, and selecting MEMSOURCE. On this page, you will see the URL and a token. The URL will be in the address bar, and the token can be found in the middle of the General Configuration section. Save these—you’ll them need to configure Memsource.

Memsource Configuration

Once you have the URL and the token, open Memsource and go to Setup. Click on Integrations,  Connectors,  and then New: 

 

Fill in the form with your URL and Token from Magento 2 and click on Test connection. Then, choose the source website, store, and store view:

 

If everything is successful, you should see your Magento account in the connectors list:

Usage

Now you can create a project (or choose an existing one) for content translation, and create a new job:

 

For translating Magento content, click on Add from Online Repository and choose your connector. Then, choose the content you want to translate:

 

Finally, confirm the job creation: 

 

After translation, you can upload the content back to Magento:

 

In Magento Administration, go to the Products list and filter by the store view that was used as a target. You should then see your translated product: