How to prevent the automatic translation of Live Chat UI template buttons
Monday, December 5, 2016 8:17 AM

FocalScope's translation module will automatically translate your FocalScope Live Chat UI templates when they need to be presented in different languages. FocalScope uses several reserved IDs  to identify Live Chat buttons to translate. However, if you wish to stop FocalScope from automatically translating buttons in your Live Chat UI templates, then you need to follow the steps detailed in this article.

Please note, an example is given using the Send button in a Live Chat UI template file.

Tutorial

Changing the Send button ID in a Live Chat UI template

  1. Use Notepad to open the Live Chat UI template and change the ID for the Send button from id="Send" to id="SendMessage". This change will prevent FocalScope from automatically translating the button text when a different presentation language is selected for the Live Chat link
  2. Archive your Live Chat UI template files into a .zip file. Please note, templates for the Live Chat pages must be static .htm or .html files (these files should not be in any subfolder(s) in the archive)



Figure 1 - Changing the default button ID


Uploading a new Live Chat UI template

  1. In the [Main menu], select [Screen > Administration]
  2. Click the [Administration] tab
  3. Navigate to the [Instant messaging > Live Chat > Custom UI templates] folder
  4. In the right-hand pane, right click and select [New]
  5. In the [Live Chat UI Template] dialogue, specify the name for the Live Chat UI template in the [Name] field
  6. In the [Template archive] field, click [...] and navigate to the .zip archive that contains the .htm files for the Live Chat UI template



    Figure 2 - Uploading a new Live Chat UI template

    Assigning a new Live Chat UI template to a Live Chat group

    1. Navigate to the [Instant messaging > Live Chat > Groups] folder
    2. Right click the group(s) that should use the new Live Chat UI Template and select [Properties]



      Figure 3 - Associating a Live Chat UI template with a Live Chat group


      Assigning a new Live Chat UI template to a Live Chat group

      1. In the [Live Chat Group Properties] window, click the [UI Template] tab
      2. In the [Template] field, click the arrow button and select the Live Chat UI template that you uploaded earlier
      3. Under the [Template pages] section, map the Live Chat UI pages [Registration, Chat window, Offline, Offline message] to the corresponding .htm file
      4. Click [Ok] to save the changes




      Figure 4 - Changing the default Live Chat UI template


      Generating the Live Chat URL

      1. Navigate to the [Instant messaging > Live Chat] folder
      2. In the [Chat with] field, specify the Live Chat group that uses the custom Live Chat UI template
      3. In the [Language] field, select which language the Live Chat UI template should be translated to
      4. In the [Link type] section, choose [just URL] (this URL will be used to test the Live Chat feature first), and click [Copy] to copy the URL to your system clipboard





      Figure 5 - Designating the Live Chat UI template to translate


       Testing the new Live Chat UI template

      1. Paste the copied Live Chat URL into your web browser and accept the chat request in FocalScope
      2. The Live Chat window should show the Send button in English, despite Danish being selected as the language translation for the Live Chat UI template
      3. Type something in the text field and click [Send] to test the Send button's functionality




        Figure 6 - Send button is unaffected by translation

        Additional Information

        Live Chat Overview