Brightspot CMS User Guide

Adding language menus


Publications that deliver content in multiple locales often add a language menu in the header. Visitors can use the language menu to view content in different locales.

Language menus have the following components:

  • A language code, indicating the locale of the asset currently in the browser
  • A menu of language display names, indicating the other languages in which you publish content
  • Links in the menu of display names
Front-end language menu (standard locales) Front-end language menu (standard locales)
Front-end language menu (standard locales)

Referring to the previous illustration—

  • The current asset in the browser is published in the English (United States) locale, so the language code is EN-US.
  • Assets are available in two other locales: French (France) and Spanish (Spain).
  • Each locale has a link, typically to the home page of the localized site. For example, clicking French (France) loads a page fr.brightspot.com, and clicking Spanish (Spain) loads a page brightspot.com/es.

You can customize the text appearing in the language code and the display names.

Front-end language menu (customized locales) Front-end language menu (customized locales)
Front-end language menu (customized locales)

Referring to the previous illustration—

  • A—Language code of the asset currently loaded in the browser.
  • B—Standard locale provided by your version of Brightspot. For recent versions of Brightspot, you can view the standard locales in JDK 11 Supported Locales.
  • C—Customized locale. This feature is useful if you publish content in a locale that is unique to your audience, or is a combination of the standard locales.
  • D—Localized locale. This feature is useful if the visitor is not familiar with the standard locales, or is not familiar with Latin characters.

To create a language menu:

  1. Click menu > Admin > Sites & Settings.
  2. Select the site for which you want to configure a language menu, or select Global to configure a language menu for all sites.
  3. Click search, located to the left of more_horiz, and type Language Menu.
  4. Under Language Menu, click search to display the content picker.
  5. Under Create, select Auto Language Menu, and then click New.
    Creating an auto-language menu Creating an auto-language menu
    Creating an auto-language menu
  6. In the Internal Name field, enter an internal name. Brightspot uses this name in selection fields.
  7. To add a language to the list of available languages, and to configure the link for each language, do the following:

    1. Under the Defaults field, click add_circle_outline.
    2. From the Locale list, select a locale you want to include in the language menu.
    3. From the Link list, select the internal or external asset the visitor sees after clicking the language.
      Specifying a link for a locale Specifying a link for a locale
      Specifying a link for a locale
  8. To customize the language code or display name, do the following:
    1. Under Locale Display Name Overrides, click add_circle_outline.
    2. From the Locale list, select the locale whose code you want to customize.
    3. In the Language Code Override field, enter a customized language code (see A in the illustration "Front-end language menu (customized locales)," above; if you don't enter an override, the rendered language code is the locale of the current asset).

      Using a default language code Using a default language code
      Using a default language code
      Rendered language code (default) Rendered language code (default)
      Rendered language code (default)
      Configuring a language code override Configuring a language code override
      Configuring a language code override
      Rendered language code (overridden) Rendered language code (overridden)
      Rendered language code (overridden)
    4. In the Display Name Override field, enter a customized display name (if you don't enter an override, the rendered display name is the English version of a country-region pair).

      Using a default language display name Using a default language display name
      Using a default language display name
      Rendered language display name (default) Rendered language display name (default)
      Rendered language display name (default)
      Configuring a language display name override Configuring a language display name override
      Configuring a language display name override
      Rendered language display name (overridden) Rendered language display name (overridden)
      Rendered language display name (overridden)
  9. To localize the display names to the current asset's locale, toggle on Localize Display Names. (For example, if you toggle this on, the display name for Arabic (Saudi Arabia) is العربية (المملكة العربية السعودية)). This setting has no effect if you entered an override display name in step 8.
    Localizing locale display names Localizing locale display names
    Localizing locale display names
  10. Click Save.
  11. Click Back.
    Language menu configuration -- back button Language menu configuration -- back button
  12. In the content picker, click the language menu you just configured.
  13. In the Edit Global or Edit Site widget, click Save.
Previous Topic
Configuring a site's locale
Next Topic
SEO
Was this topic helpful?
Thanks for your feedback.
Our robust, flexible Design System provides hundreds of pre-built components you can use to build the presentation layer of your dreams.

Asset types
Module types
Page types
Brightspot is packaged with content types that get you up and running in a matter of days, including assets, modules and landing pages.

Content types
Modules
Landing pages
Everything you need to know when creating, managing, and administering content within Brightspot CMS.

Dashboards
Publishing
Workflows
Admin configurations
A guide for installing, supporting, extending, modifying and administering code on the Brightspot platform.

Field types
Content modeling
Rich-text elements
Images
A guide to configuring Brightspot's library of integrations, including pre-built options and developer-configured extensions.

Google Analytics
Shopify
Apple News