Creating machine translation services

To develop a custom machine translation service, you need to define a class that inherits from AbstractMachineTranslationService (found in the CMS.TranslationServices namespace).

The service class must override and implement the following abstract methods:

Defining machine service classes

This example demonstrates how to write a class providing functionality for a machine translation service. The sample class does not use a real translation service, it only converts the source text to upper case. When creating your own classes, replace the code of the methods with your own translation logic or call the API of the appropriate web service.

1. Open your Kentico web project in Visual Studio.

2. Add a new class into the App_Code folder (or Old_App_Code on web application installations). For example, name the class SampleMachineTS.cs.

3. Edit the class and change its code to the following:

   Copy

   
   
   
    using System;
    using System.IO;
   
    using CMS.TranslationServices;
   
    /// <summary>
    /// Sample machine translation service.
    /// </summary>
    public class SampleMachineTS : AbstractMachineTranslationService
    {
        /// <summary>
        /// Translates the specified text from the source language to the target language.
        /// Must return the translated text as a string.
        /// </summary>
        /// <param name="text">Text to translate</param>
        /// <param name="sourceLang">Source language culture code</param>
        /// <param name="targetLang">Target language culture code</param>
        public override string Translate(string text, string sourceLang, string targetLang)
        {
            // "Translates" the text to upper case.
            return text.ToUpper();
        }
   
        /// <summary>
        /// Automatically attempts to detect the language of the source text.
        /// Returns the culture code of the detected language.
        /// </summary>
        /// <param name="text">Text to be processed</param>
        public override string Detect(string text)
        {
            // Use your service to detect the language. This example always returns English. 
            return "en-US";
        }
   
        /// <summary>
        /// Returns a stream of sound generated by text-to-speech services (if supported).
        /// </summary>
        /// <param name="text">Text to be processed</param>
        /// <param name="lang">Culture code of the text's language</param>
        public override Stream Speak(string text, string lang)
        {
            // This service provider does not support Text-to-speech.
            throw new NotImplementedException();
        }
   
        /// <summary>
        /// Checks the necessary prerequisities needed for the service to work,
        /// e.g. availability of credentials for connecting to the service etc.
        /// </summary>
        public override bool IsAvailable()
        {
            // This sample provider does not require any settings and does not depend on
            // any other services, therefore is always available.
            return true;
        }
    } 
   
   
    

   The system calls the methods of the class as needed when the given translation service is used.

4. Follow the instructions on the Loading translation service classes from App_Code page to ensure that the application can access the custom class.

Registering machine services in the system

Once you have implemented the class with the required functionality, you need to register the translation service:

1. Sign in to the Kentico administration interface.

2. Open the Translation services application.

3. Click New translation service.

4. Enter the following values into the service’s properties:

   • Display name: Sample machine service
   • Code name: Leave the (automatic) option. The system generates the code name as SampleMachineService (based on the display name).
   • Service provider - Assembly name: (custom classes)
   • Service provider - Class: SampleMachineTS
   • Is machine translation service: Yes (checked)
   • Service is enabled: yes (checked)

5. Click Save.

The service is now ready to be used.

Result

When submitting pages for translation, users can select the Sample machine service as one of the translation service options. Using this option creates the new language version of the page as a copy of the original content, with all characters converted to upper case.

Users can also call the custom translation service when localizing resource strings.