Configuration

Learn how to configure your SFCC instance to send products for translation on TextMaster

1. Navigate to "Merchant Tools" → "TextMaster" → "API Setup" in your SFCC environment

2. Under the "API Environment" section, select "Live". This will ensure that your live content is being translated

3. Enter the ID of your master catalog. This ensures that the right product information is being selected for translation

4. If your environment is password-protected, enter your password in the "Storefront Protection Password" field. This helps maintain the security of your translation process

5. Provide the API Base URLs for both the Demo and Live environments. These URLs enable the communication between SFCC and TextMaster

6. Once you've filled in all the necessary fields, click the "Save" button

In order to facilitate a secure connection between your TextMaster account and the Salesforce Commerce Cloud (SFCC) plugin, you need to create an OAuth application in your TextMaster account. Once created, this OAuth application needs to be linked in the "API Authentication" page of the SFCC plugin.

Log in to your TextMaster account, navigate to the API & Loop menu.

Click on the "New application" button and follow these instructions:

1. In the "Name" field, type a unique name for your application to easily identify it

2. For the "Authorization callback URL", enter your callback URL in the following format: https://<hostname of your SFCC business manager environment>/on/demandware.store/Sites-Site/default/TMTranslation-Authentication

   Alternatively, you can copy this URL directly from the "API Authentication" page of the TextMaster plugin modules in the Business Manager of your SFCC instance

3. In the "Scopes" section, select the checkboxes for project:manage and user:manage. This will allow your application to manage projects and users on your behalf

4. Click "Save" to finalize the creation of your new application

After creating your OAuth application within TextMaster, you'll need to link it with your Salesforce Commerce Cloud (SFCC) instance. To do this:

1. Take note of the Application ID and Secret that were generated when you created your application in TextMaster

2. Return to the Business Manager of your SFCC instance and navigate to the "API Authentication" page within the TextMaster plugin modules

3. In the form provided, enter the Application ID and Secret that you noted down earlier

4. Click on "Authorize in TextMaster". This will redirect you to your TextMaster account

5. Follow the instructions provided by TextMaster to authorize the app. This process will involve granting the necessary permissions to the app to ensure it can function as expected

6. Once you've authorized the app, you will be redirected back to your SFCC page. Here, click on the "Generate Token" button. This action will generate a token internally which will be used by the plugin for all subsequent API communications

By following these steps, you'll successfully connect your TextMaster OAuth application with your SFCC instance. This connection is essential for enabling seamless and secure communication between TextMaster and SFCC. If you encounter any issues or need further clarification, please don't hesitate to reach out to our support team.

Language Mapping

Language Mapping is a vital step in ensuring accurate and context-specific translations between Salesforce Commerce Cloud (SFCC) and TextMaster. Here's how to establish this link:

1. In your SFCC environment, navigate to "Merchant Tools" → "TextMaster" → "Language Mapping"

2. Click on the "Add a Language Mapping" button. This will open up a new mapping form

3. From the selection dropdown, choose the appropriate SFCC Language that you want to map

4. Similarly, select the corresponding TextMaster Language from the next dropdown. This language will be used by TextMaster for the translations

5. After selecting the languages, click on the "Save" button to finalize the mapping

By following these steps, you've successfully created a language mapping between SFCC and TextMaster. This mapping will ensure that your translations are properly localized for your specified regions. If you need to map more languages, just repeat these steps for each language pair.

Default Attributes

Establishing default attributes streamlines the translation process by automatically including specific attributes every time you initiate a translation request. Here's how to set up default attributes:

1. Navigate to "Merchant Tools" → "TextMaster" → "Attribute Setup" in your Salesforce Commerce Cloud (SFCC) environment

2. From the options available, select the "Item Type" that your default attributes will apply to. This could be Products, Categories, Content Assets, etc., depending on what your SFCC setup includes

3. Next, review the list of available attributes for the selected item type. Check the boxes next to the attributes that you want to include by default in every translation request sent to TextMaster

4. Once you've selected all the relevant attributes, click on the "Save" button to finalize your selections

Remember, the attributes you set as defaults will automatically be included in every translation request for the corresponding item type. You can always come back to this page to adjust your default attributes as needed.