Notice
This integration will be deprecated as of December 15, 2023. If requiring an alternate solution, communicate with your Customer Service Manager and consider either a custom solution or using an API.
Magento connector allows the downloading of source content and uploading of translations to/from Magento for the following content types:
-
Products
-
Categories
-
Pages
-
Blocks
There are a number of use cases for the connector:
-
Project managers can add files directly to projects from an online repository.
-
Set up the submitter portal to allow Submitters to add files to requests directly from the online repository.
-
Use automated project creation (APC) to have new projects automatically created when a change in the last modified date is detected for monitored files or a folder.
-
Selected files are imported the very first time APC runs.
-
There are three ways to install the Phrase Connector extension into a Magento instance:
-
Through the Magento Marketplace
-
Use Composer
-
Manually
Installing via Magento Marketplace
-
Open the Magento Marketplace entry and add it to cart.
-
In the Magento Administration, go to System and click on Web Setup Wizard.
-
Choose the Extension Manager.
-
Under the number of extensions to install, click on Review and Install.
-
Find the Phrase Connector, and click on the Install link.
-
Finish the installation.
For more information, see Magento Documentation.
Installing via Composer
Use the following commands to install via Composer:
composer require phrase/magento2-connector php bin/magento module:enable Phrase_Connector php bin/magento setup:upgrade php bin/magento setup:static-content:deploy
Manual Installation
If unable to use either Magento Marketplace or Composer, the connector can be installed manually.
To install manually, follow these steps:
-
Download the zip file from GitHub releases.
-
In the Magento installation, extract the downloaded zip file into the folder app/code/Phrase/Connector
-
Enable the extension and clear the cache with these commands:
php bin/magento module:enable Phrase_Connector php bin/magento setup:upgrade php bin/magento cache:flush php bin/magento setup:di:compile php bin/magento setup:static-content:deploy
To enter the Magento site without basic authorization, the connector needs to be enabled.
-
In the Magento Administration, go to Stores and click on All Stores.
-
Click Create Store View to create a separate view for every language.
-
To associate language with a store go to Configuration, select the Store View from the dropdown menu, and update the .
and click -
Save the configuration.
-
Go to Stores, click on Configuration, and select PHRASE.
-
Copy the URL in the browser address bar and the Token from the section.
-
From the Settings
page, scroll down to the section.
-
Click on Connectors.
The
page opens. -
Click New.
The
page opens. -
Provide a name for the connection and change the Type to Magento .
-
Enter the Magento site URL (including the protocol) and the Phrase plugin token.
-
Click Test connection.
A checkmark will appear if the connection was successful. A red exclamation point will appear if it wasn't. Hover over the icon to see additional details.
-
Select the Website, Store, and Source store view.
-
Click Save.
The connector is added to the list on the
page.
When reporting an issue to support please include the log file. The file contains all API calls.