Version 1.8.2 for Magento 2 · Bold User interface controls, commands, and keywords in body text. ... DMS, e-commerce, PIM, and database platforms to manage multilingual content.

for Magento 2Version 1.8.2

User Guide

This documentation is proprietary and is protected by U.S. and international copyright laws and trade secret laws. Copyright © 2020Translations.com, Inc. ("Translations.com") All rights reserved. No part of this documentation may be reproduced, copied, adapted, modified,distributed, transferred, translated, disclosed, displayed or otherwise used by anyone in any form or by any means without the express writtenauthorization of Translations.com. Other names may be trademarks of their respective owners.Copyright © 2020 Translations.com, Inc. Confidential Page 2 of 31

Table of ContentsAbout this Guide..................................................................................................................................................... 3

Conventions.......................................................................................................................................................3

Typographical............................................................................................................................................ 3

Icons.......................................................................................................................................................... 3

1 About GlobalLink Connect................................................................................................................................ 4

Globalization Management Suite...................................................................................................................... 4

GlobalLink Connect for Magento 2...................................................................................................................4

Prerequisites..............................................................................................................................................5

2 Get Started.......................................................................................................................................................... 6

Explore the User Interface................................................................................................................................6

3 Prepare Elements for Submission....................................................................................................................7

Configure Product Attributes.............................................................................................................................7

Configure Category Attributes.........................................................................................................................10

Configure CMS Page Fields........................................................................................................................... 12

Configure CMS Block Fields...........................................................................................................................14

Configure Product Reviews............................................................................................................................ 16

4 Queue Submissions for Translation.............................................................................................................. 19

5 Queued Translation Management...................................................................................................................23

Manual Translation Submit and Retrieve....................................................................................................... 23

Submit Queued Submissions..................................................................................................................23

Receive Completed Submissions........................................................................................................... 23

Import Completed Submissions..............................................................................................................24

Synchronize Cancelled Submissions......................................................................................................24

Unlock Submissions................................................................................................................................24

Automatic Translation Submit and Retrieve................................................................................................... 24

Submission of Queued Translations.......................................................................................................25

Monitor Submissions...............................................................................................................................25

Manage Cancelled Submissions.............................................................................................................27

Copyright © 2020 Translations.com, Inc. Confidential Page 3 of 31

About this GuideThe images and topics contained in this guide are not representative of every GlobalLink® product installation.Each GlobalLink product installation is configured to meet the needs of the intended users, who may or may notrequire certain features and options. Therefore, the features and options covered in this guide may differ fromthose available on your GlobalLink product installation.

Conventions

TypographicalThe following table explains the typographical conventions used in this guide.

Bold User interface controls, commands, and keywords in body text.

italic Represents an input field where user input is expected.

<…> Generic parameters that must be replaced by specific code or text.

IconsThe following table explains the icon conventions used in this guide.

Note:This icon designates a note or helpful suggestion or reference relating to the surrounding text.

Best Practice:This icon designates a suggestion for best practice relating to the surrounding text.

Alert:This icon designates a warning or alert relating to the surrounding text. In this situation, the usershould exercise caution to avoid an undesirable result.


1. About GlobalLink ConnectGlobalLink Connect serves as a bridge between your back-end systems and our industry-leading GlobalizationManagement Suite, allowing you to use the full functionality of your CMS, DMS, e-commerce, PIM, and databaseplatforms to manage multilingual content.

Globalization Management SuiteThe GlobalLink Globalization Management Suite (GMS) is a modular set of translation technology products thatprovide enterprise solutions for organizations. It consists of the following server components:

• GlobalLink Project Director—An automated translation workflow system that leverages andcommunicates with the other GlobalLink products through a published Web services API

• GlobalLink TM Server—A robust, scalable server-based translation memory solution

• GlobalLink Term Manager—A web-based terminology management tool that allows any translationmanager to modify, review, search, or delete existing terms

• GlobalLink TransStudio Online—A web-based translation tool that offers translators instant access totranslation memories and terminology lists

• GlobalLink TransStudio Review—A web-based translation review tool with an intuitive user interface thatallows translated content to be reviewed quickly and effectively

• GlobalLink Translation & Review Portal—A web-based, collaborative application that streamlines thelinguistic review process

The integration with Magento 2 involves Web services communication between Magento 2 and GlobalLink ProjectDirector (PD).

GlobalLink Connect for Magento 2GlobalLink Connect for Magento 2 is a module that permits users to initiate, automate, control, and track theentire translation process. The translation of web content can be managed directly from the Magento 2 userinterface using the custom interface elements, tables, and job scheduler that exchanges content between theCMS and GlobalLink. The combination of the Magento 2 CMS functionality and the workflow capabilities ofGlobalLink provide Magento 2 users with a comprehensive platform to manage web content for markets aroundthe globe. Magento 2 highlights:

• Leverages existing Magento user knowledge

• Supports scheduled or on-demand translation initiation through the Magento Admin Catalog

• Allows content authors to focus on updates to source-language content

• Eliminates hand-off delays and reduces translation turnaround times

• Automatic imports of translations into Magento catalogs

• Automatically handles custom product attributes

• One-click exports and imports of catalog content

1. About GlobalLink Connect GlobalLink® Connect for Magento 2


PrerequisitesGlobalLink Connect for Magento 2 is compatible with Magento 2 Community Edition, Enterprise Edition, andCommerce cloud Edition—2.3.x..


2. Get StartedThis section describes how to get started from the basic requirements to the user interface.

Explore the User InterfaceThe default view is the dashboard. You can move through the interface using the Admin Sidebar.

Element Description

Admin Sidebar The primary tabs of Magento 2 interface.

Body Pane The main dialog area.

System Messages The area where system messages are displayed.


3. Prepare Elements for SubmissionYou can specify products for translation in Project Director (PD) using content element attributes.

The content elements attributes are:

• Product Attributes

• Category Attributes

• CMS Page Fields

• CMS Block Fields

• Customer Attributes

• Product Reviews

Configure Product AttributesYou can identify which products to translate by configuring the product attributes for inclusion.

To configure product attributes for inclusion:

1. On the Admin Sidebar, click GLOBALLINK.

2. Under Fields Configuration, click Products.

3. Prepare Elements for Submission GlobalLink® Connect for Magento 2


3. Select a product from the Select Attribute Set drop-down list.



4. Select the appropriate attribute for each attribute set in the drop-down list.

5. Click Update Configuration on the Actions drop-down menu.



6. Repeat Step 3 through Step 5 for each attribute set you are configuring.

The product attributes are configured for inclusion in the submissions.

Configure Category AttributesYou can choose categories for translation by configuring the category attributes.



To configure category attributes:


2. Under Fields Configuration, click Categories.

3. Select the appropriate attributes for the category.




5. Click OK.

The category attributes are configured for inclusion in the submissions.

Configure CMS Page FieldsYou can configure CMS page fields for inclusion in submissions through the CMS Pages tab.

You must add and configure each custom field in the Fields Configuration for CMS pages.



To configure page fields for inclusion:


2. Under Fields Configuration, click CMS Pages.

3. Select the appropriate field for the CMS page.




The page fields are configured for inclusion in the submissions.

Configure CMS Block FieldsThrough the CMS Blocks tab, you can limit the translation of the CMS block fields by configuring which to includein submissions.

You must add and configure each custom field in the Fields Configuration for CMS blocks.



To configure the block fields for inclusion:


2. Under Fields Configuration, click CMS Blocks.

3. Select the appropriate field for the CMS block.




The block fields are configured for inclusion in the submissions.

Configure Product ReviewsThrough the Product Reviews tab, you can configure Product Review fields for inclusion in submissions.

You must add and configure each custom field in the Fields Configuration for Product Reviews.



To configure the product review fields for inclusion:


2. Under Fields Configuration, click Product Reviews.

3. Select the appropriate field for the product reviews.




The Product Review fields are configured for inclusion in the submissions.


4. Queue Submissions for TranslationYou can queue content for submission to Project Director (PD) from the Magento user interface.

All content is queued for translation from within Magento by navigating to that content and following these steps.

To queue content for translation:

1. On the Admin Sidebar, click CATALOG.

2. Under Catalog, click Products.

3. Select the pages that you want to submit, then click Send for Translation.

4. Queue Submissions for Translation GlobalLink® Connect for Magento 2


4. Click OK.

5. Enter the submission details.



Field Action

Submission Name Enter a unique name for your submission.

Due Date Select a date for completion of this translation.

Project Select a project from the drop-down list.

Target Store Select the languages for this translation.

Priority Select the appropriate urgency of this project.

Alert Email Enter an email address to receive any error messages.

Submission Instructions Enter any instructions for the translator.

Translate associated and parent categories Select to include associated categories.

6. Click Send for Translation.

Your selected products are queued for submission to GlobalLink PD.

You must follow this process when translating the following:

• Products



• Categories

• CMS Pages

• CMS Blocks

• Product Attributes

• Customer Attributes

• Product Reviews


5. Queued Translation ManagementGlobalLink for Magento 2 provides two ways to manage Project Director (PD) queued translations:

• Manual—When Automatic Submission and Retrieval of Translations is disabled, you must manuallysubmit queued translation submissions to Project Director (PD). The completed or cancelled submissionsmust be retrieved from PD by running Submit, Receive and Import commands on the Magento 2 back-end.

• Automatic—When Automatic Submission and Retrieval of Translations is enabled, you mustautomatically submit queued translation submissions to Project Director (PD). The completed or cancelledsubmissions must be retrieved from PD by enabling the auto-submit and retrieval settings.

You can submit content for translation manually, or automatically, using your system scheduler.

Refer to your system documentation for further information on how to configure the scheduler.

Manual Translation Submit and RetrieveWhen automatic submission and retrieval is disabled, you must manually submit and retrieve your queuedtranslation submissions.

Submit Queued SubmissionsWhen you create submissions from the Magento 2 user interface, the submissions are added to a queue. Youmust then submit the queued submissions to Project Director (PD).

To submit a queued submission:

1. Open a Command console.

2. At the command prompt, enter:

php bin/magento globallink:translations:submit

The queued submission is submitted to PD.

Receive Completed SubmissionsYou must receive the list of completed submissions from Project Director (PD) to add them to the input queue.

You must run the Receive command before you can retrieve completed submissions using theMagento 2 user interface.

To receive completed submissions:



php bin/magento globallink:translations:receive

The completed submissions are received from PD and added to the input queue.

5. Queued Translation Management GlobalLink® Connect for Magento 2


Import Completed SubmissionsYou can import all completed submissions from Project Director (PD).

To import completed submissions:



php bin/magento globallink:translations:import

The completed submissions are imported from PD and applied to the store view.

Synchronize Cancelled SubmissionsYou must synchronize the list of cancelled submissions from Project Director (PD) to record the cancelled statusin the local Magento 2 database.

You can synchronize all cancelled submissions with the cancel command.

When Automatic Submission and Retrieval of Translations is disabled, you must run the Cancelcommand on the command console after cancelling submissions on the dashboard.

To synchronize cancelled submissions:



php bin/magento globallink:translations:cancel

The cancelled submissions are synchronized with PD and their status is recorded in the Magento 2 database.

Unlock SubmissionsYou can unlock queued, completed, and cancelled submissions using the Unlock command.

To unlock submissions:



php bin/magento globallink:translations:unlock

The locked submissions are unlocked.

Automatic Translation Submit and RetrieveWhen automatic submission and retrieval is enabled through the Automatic Submission and Retrieval ofTranslations setting, your translations are queued for submission to Project Director (PD). This queue isprocessed immediately and the queued submissions are sent to PD. You must enable the setting Automatically



import after checking for Translations to have PD automatically import and update the completed submissions.Refer to Configure General Settings in the Administrator Guide.

Submission of Queued TranslationsWhen you create translation submissions they are queued for submission to Project Director (PD). This queue isprocessed automatically at regular intervals and translation requests are sent to PD.

Monitor SubmissionsYou can monitor the real-time status of your submissions on the Translations - Submissions dashboard.

To monitor your submissions:


2. Under Management, click Submissions.

3. Click Refresh Dashboard.

When Automatic Submission and Retrieval of Translations is set to Yes, only the Refresh buttonis visible.



Automatic import is optional; see Configure General Settings in the Administrator Guide.

Automatic import can only be activated when Automatic Submission and Retrieval of Translationsis set to Yes in General Settings.

The submission status colors are:

• Blue—Translation complete

• Orange—Submission is queued or in-progress

• Grey—Submission cancelled or waiting to be cancelled

• Red—All error conditions

4. Click OK.



The status of each submission is retrieved from Project Director (PD) and updated. All Completedsubmissions are received from PD and the translations are applied to the target stores.

When a submission is complete, you can click on the link in the Source Language column to viewthe source and in the Target Language column to view the translated content.

Manage Cancelled SubmissionsThe list of submissions cancelled manually or by Project Director (PD), is automatically synchronized with PD anddisplay on the dashboard with the status of Cancelled. You can manually cancel incomplete submissions with theCancel Submissions command and delete all cancelled submissions from the dashboard with the Remove allcancelled items command.



To cancel submissions:



3. Select all submissions that are not Completed and you want to cancel.

4. Click Cancel Submissions in the drop-down menu.



The selected submissions are cancelled.

Remove All Cancelled SubmissionsYou can remove the cancelled submissions with the Remove all cancelled items option.



To remove cancelled submissions:



3. Click Remove all cancelled items.



The cancelled submissions are removed from the dashboard.

Version 1.8.2 for Magento 2 · Bold User interface controls, commands, and keywords in body text. ... DMS, e-commerce, PIM, and database platforms to manage multilingual content.

Documents