print

Configuring Language Settings in TRUENDO CMP

Introduction#

TRUENDO CMP offers multilingual support, allowing you to cater to a diverse audience by displaying the consent banner and privacy settings in their preferred language. With support for 32 different languages, you can enhance user experience and ensure compliance across different regions.

This guide will walk you through the steps to configure the language settings for your TRUENDO CMP, including setting the main language, adding supported languages, implementing a language override, and troubleshooting common issues.

1. Prerequisites#

Before you begin, ensure you have the following:

  • Access to the TRUENDO Console: You need login credentials to access and modify settings.
  • TRUENDO CMP Integrated into Your Website: The TRUENDO script should already be implemented on your site. If not, refer to the TRUENDO CMP Integration Guide.
  • Administrator Access to Your Website's Code: Necessary for implementing the language override.

2. Supported Languages#

TRUENDO CMP supports the following 32 languages:

  • Albanian (sq)
  • Arabic (ar)
  • Bosnian (bs)
  • Bulgarian (bg)
  • Chinese (Simplified) (cn)
  • Chinese (Traditional) (hk)
  • Croatian (hr)
  • Czech (cs)
  • Danish (da)
  • Dutch (nl)
  • English (en)
  • Estonian (et)
  • Finnish (fi)
  • French (fr)
  • German (de)
  • Greek (el)
  • Hungarian (hu)
  • Italian (it)
  • Latvian (lv)
  • Lithuanian (lt)
  • Norwegian (no)
  • Polish (pl)
  • Portuguese (pt)
  • Portuguese (Brazilian) (pt-br)
  • Romanian (ro)
  • Russian (ru)
  • Serbian (sr)
  • Slovak (sk)
  • Slovenian (sl)
  • Spanish (es)
  • Swedish (sv)
  • Turkish (tr)

3. Configuring Basic Language Settings#

A. Accessing Language Settings

  1. Log in to the TRUENDO Console using your credentials.
  2. Navigate to the Banner section from the left-hand menu.


B. Setting Main and Supported Languages

  1. Main Language:

    • Click the dropdown under Main Language.
    • Select the default language that will be displayed if a user's browser language is not among the supported languages.

  2. Supported Languages:

    • Click on Supported Languages.
    • Select all the languages you want your TRUENDO CMP to be displayed in.

C. Saving Changes

  • After configuring the main and supported languages, click Save at the bottom of the page to apply the changes.

4. Implementing Language Override#

A. Understanding Language Override

By default, TRUENDO CMP displays in the user's browser language, provided it is among the supported languages. However, if your website has its own language selection mechanism (e.g., a language picker), you may want to synchronize TRUENDO CMP's language with your site's language choice. This can be achieved using the language override feature.

B. Prerequisites for Language Override

  • TRUENDO CMP Integrated: Ensure TRUENDO CMP is already integrated into your website.
  • Language Added to Supported Languages: The desired language must be added to the Supported Languages in the TRUENDO Console.

C. Adding the Language Override Attribute

To override the default language detection, add the data-lang attribute to your TRUENDO integration script with the appropriate language code.

Example:

<script
    id="truendoAutoBlock"
    type="text/javascript"
    src="https://cdn.priv.center/pc/truendo_cmp.pid.js"
    data-siteid="yourSiteID"
    data-lang="language-code"
></script>
  • Replace yourSiteID with your actual site ID provided by TRUENDO.
  • Replace language-code with the code of the language you wish to set (refer to the list in the next section).


D. Supported Language Codes

Refer to the table below for the correct language codes to use:

Language

Code

Language

Code

Albanian

sq

Latvian

lv

Arabic

ar

Lithuanian

lt

Bosnian

bs

Norwegian

no

Bulgarian

bg

Polish

pl

Chinese (Simplified)

cn

Portuguese

pt

Chinese (Traditional)

hk

Portuguese (Brazilian)

pt-br

Croatian

hr

Romanian

ro

Czech

cs

Russian

ru

Danish

da

Serbian

sr

Dutch

nl

Slovak

sk

English

en

Slovenian

sl

Estonian

et

Spanish

es

Finnish

fi

Swedish

sv

French

fr

Turkish

tr

German

de

Greek

el

Hungarian

hu

Italian

it

5. Troubleshooting#

A. Language Not Displaying Correctly

Issue: TRUENDO CMP is not displaying in the expected language.

Solution:

  • Check Supported Languages: Ensure the language is added to the Supported Languages in the TRUENDO Console.
  • Verify Browser Language: The user's browser language may not match any of the supported languages.
  • Fallback to Main Language: If the browser language is unsupported, TRUENDO CMP defaults to the Main Language.

B. Language Override Not Working

Issue: The language override attribute does not change the display language.

Solution:

  • Correct Language Code: Ensure you're using the correct language code from the supported list.
  • Attribute Placement: The data-lang attribute must be added directly to the TRUENDO script tag.
  • Script Cache: Clear your browser cache to ensure the latest script is loaded.

C. Changes Not Reflected on Website

Issue: After making changes in the TRUENDO Console, they are not appearing on your website.

Solution:

  • Save Changes: Confirm that you clicked Save after making changes.
  • Delay in Propagation: Allow some time for changes to propagate.
  • Clear Cache: Clear your website's cache and your browser cache.
  • Script Integration: Verify that the TRUENDO CMP script is correctly integrated into your website.

6. FAQs#

A. How Does TRUENDO Determine the Display Language?

TRUENDO CMP selects the display language based on the following priority:

  1. Language Override: If the data-lang attribute is set in the integration script, TRUENDO CMP uses this language.

    • Note: The language must be added to the Supported Languages in the TRUENDO Console.
  2. HTML Meta Language Tag: If the webpage specifies a language using the HTML <html lang="language-code"> attribute, and it is among the supported languages, TRUENDO CMP will use it.
  3. Browser Language: TRUENDO CMP checks the user's browser language settings and displays in that language if it is supported.
  4. Main Language: If none of the above apply, TRUENDO CMP defaults to the Main Language set in the TRUENDO Console.

Summary of Display Language Priority in Descending Order

Priority

Description

Language Override

An attribute added to the TRUENDO CMP script by a site admin (not present by default). If this language is not a main or supported language, TRUENDO CMP will display in the Main Language by default.

HTML Meta Data

The language specified in the website's code using <html lang="language-code">. If this language is not a main or supported language, TRUENDO CMP will display in the Main Language by default.

Browser Language

TRUENDO CMP will display in the visitor's browser language if it is a supported language. If not, it defaults to the Main Language.

Main Language

The fallback language set in the TRUENDO Console. This is used if none of the above criteria are met.

B. What is the Difference Between Main and Supported Languages?

  • Main Language: This is the default fallback language that TRUENDO CMP will use if the user's preferred language is not available through the language override, HTML meta tag, or browser settings.
  • Supported Languages: These are the languages you've selected in the TRUENDO Console to be available for TRUENDO CMP. It will display in these languages based on the user's browser settings or the language override.

7. Conclusion#

Configuring the language settings in TRUENDO CMP ensures that your website visitors receive consent information in their preferred language, enhancing user experience and compliance. By following the steps outlined in this guide and utilizing the troubleshooting tips, you can easily set up and customize the language preferences to match your audience's needs.

8. Support and Resources#

End of Guide

If you have any further questions or require assistance with specific configurations, please don't hesitate to reach out to TRUENDO support or consult the resources provided.

×