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)

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)

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
  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
  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
      Rendered language code (default)
      Rendered language code (default)
      Configuring a language code override
      Configuring a language code override
      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
      Rendered language display name (default)
      Rendered language display name (default)
      Configuring a language display name override
      Configuring a language display name override
      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
  10. Click Save.
  11. Click Back.
    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.

See also:

Previous Topic
Configuring a site's locale
Next Topic
SEO
Was this topic helpful?
Thanks for your feedback.
The elements that get you up and running in a matter of days, from pre-built content types, to modules, to landing pages.

Content types
Modules
Landing pages
Everything you need to manage and administer content within Brightspot CMS, including plug-and-play integrations.

Dashboards
Publishing
Workflows
Admin configurations
A guide for installing, supporting and administering code on the Brightspot platform, including integrations requiring developer support to use.

Field types
Content modeling
Rich-text elements
Images