Google Cloud Translation Integration Administrator Setup | Axero Documentation

For sites integrated with Google Cloud Translation, there are two primary approaches to managing multilingual content: Dynamic Content Translation and the Multi-Language Content Manager.

Dynamic Content Translation enables users to quickly convert user-created content into any specific language with a single click. While machine translation is not always perfectly accurate, the quality of auto-translations is steadily improving as machine learning algorithms advance each year. This approach enables readers to access content in their chosen language without the need for intranet administrators to manage multiple manual translations.

Multi-Language Content Manager further enhances content management by enabling the automatic creation and refinement of different language versions, ensuring consistency across the platform. If a translation isn’t available, content will default to its original language, with the option to switch between available languages on the content detail page. This feature is only available on Enterprise licenses.

Step 1: Configure Google Cloud Translation API

Note: This step is required for both Dynamic Content Translation and the Multi-Language Content Manager.

1. Visit the Google Cloud Platform console.
2. Billing must be enabled to use the Cloud Translation API. If you haven't added one already, add a billing account:
   1. In the left menu, click Billing.
   2. Click Add Billing Account.
   3. Follow the steps to add a payment method.
3. Create a project for your intranet (if necessary):
   1. In the header, click the project dropdown menu.
   2. In the modal that opens, click New Project.
   3. Enter a name for the project.
   4. Click Create.
4. Enable Cloud Translation API:
1. In the left menu, click APIs & Services > Library.
2. Search for Cloud Translation API.
3. Click Cloud Translation API.
4. Click Enable.
5. Create API Credentials:
1. Click the hamburger menu icon.
2. Click APIs & Services > Credentials.
3. Click Create Credentials, and select API key.
4. A modal will appear with the API key. Copy the API key.

Step 2: Enable Google Cloud Translation in Axero

Note: This step is required for both Dynamic Content Translation and the Multi-Language Content Manager.

1. In Axero, go to Control Panel > System > System Properties.
   
2. Edit GoogleCloudTranslationApiKey.
3. Paste the copied API key and click Save.
4. Edit EnableGoogleCloudTranslation.
5. Set the value to true and click Save.
6. Navigate to System > Advanced System Utilities.
7. Click Restart Site.

Once the system properties are updated and the site is restarted, the translate button will appear on content, allowing users to translate content to their own language.

Additional Steps for Multi-Language Content Manager

For setting up Multi-Language Content Manager, ensure you have completed the general setup for the Google Cloud Translation API as outlined above. Then, follow these specific steps within the Google Cloud Platform and Axero:

1. 1. Visit the Google Cloud Platform console.
   2. Create a service account
      1. Click on the hamburger menu icon in the top-left corner.
      2. Go to IAM & Admin > Service accounts.
      3. Click Create Service Account.
   3. Service Account details
      1. In the Service account details tab, enter the Service account name, Service account ID, and a brief Service account description.
      2. Click Create and Continue.
   4. Grant Access to the Service Account
      1. In the Grant this service account access to the project tab, select Cloud Translation API Admin from the list of roles.
      2. Click Continue.
   5. Finalize Service Account Creation
      1. In the Grant users access to this service account tab, no additional input is required.
      2. Click Done to complete the creation of the service account.
   6. Generate Service Account Key
      1. Locate your newly created service account.
      2. In the Actions column, click the Manage keys icon.
      3. Click Add Key > Create new key.
      4. Choose JSON as the key type and click Create.
      5. Download the JSON file.
   7. Configure Axero with the Service Account Key
      
      1. Navigate to Control Panel > System > System Properties.
      2. Search for the GoogleCloudTranslationSecret property.
      3. Open the downloaded JSON file, which contains the Service Account keys. 
      4. Copy all text from the file and paste it into the GoogleCloudTranslationSecret property.

   8. Preserve Specific Formats:

      To maintain the formatting of specific tags during translation, enter these tags in the GoogleCloudTranslationProtectedPatterns system property. Use new lines to separate each pattern. The default patterns include:

      • • For Mention: <span\b[^>]>{{mention:([0-9]{1,}):([0-9]{1,})}}</span>
        • For Code Highlight: <pre\b[^>]>[\s\S]*?</pre>

       

   Note Excluding the tags from GoogleCloudTranslationProtectedPatterns will result in incorrect functionality for mentions and code highlights. Please do not delete or update the default value of the GoogleCloudTranslationProtectedPatterns property.