Brightspot CMS User Guide

Customizing Brightspot's labels


Note
This section describes using resource bundles to customize Brightspot's widgets, dashboard, reports, and other editorial components.

Some of Brightspot's labels are in configuration files. For example, the configuration file SiteDefault_en.properties provides labels appearing in the Sites widget.

Example 1. Configuration file for labels in Sites widget

displayName=Site
global=Global
action.switch=Switch

Brightspot uses the labels when rendering the Sites widget, as described in the following illustration.

Site Properties Labels.png Site Properties Labels.png

Each configuration file's name contains one of the following:

  • A code indicating a language and region
  • A code indicating only a language
  • Neither language nor region code

The following table illustrates file names and the associated language and region.

Table 1. Language and region codes in file names

File name
Language code
Region code
Language
Region
SiteDefault_en_GB.properties
en
GB
English
United Kingdom
SiteDefault_en.properties
en
N/A
English
N/A
SiteDefault_es_MX.properties
es
MX
Spanish
Mexico
SiteDefault_es.properties
es
N/A
Spanish
N/A

For a list of language and region codes, see ISO-3166 Country Codes and ISO-639 Language Codes.

Brightspot retrieves labels based on an editor's locale.

  • If an editor selected a locale English (United States), then Brightspot retrieves the labels for the Sites widget using the following priority:

    1. From the file SiteDefault_en_US.properties. If that file does not exist,
    2. From the file SiteDefault_en.properties. If that file does not exist,
    3. From the Brightspot defaults (which are US English).
  • If an editor selected a locale Spanish (Mexico), then Brightspot retrieves the labels for the Sites widget using the following priority:

    1. From the file SiteDefault_es_MX.properties. If that file does not exist,
    2. From the file SiteDefault_es.properties. If that file does not exist,
    3. From the Brightspot defaults (which are US English).

(For information about setting a user's locale, see Users.)

You can override the labels appearing in the configuration files to customize the Brightspot experience to your organization's needs (and personality).

To customize labels:

  1. Acquire from your Brightspot developer the path and name of the file you want to override. Examples of these files are as follows:

    • com/psddev/cms/db/SiteDefault_en_US.properties
    • com/psddev/cms/tool/content/SitesWidgetDefault_en.properties
  2. Inside the file, identify the label you want to customize.
  3. From the Navigation Menu, expand Admin, and select Sites & Settings.
  4. In the Sites widget, select Global.
  5. Click search, located to the left of more_horiz, and type Localization Bundles.
  6. Click add_circle_outline Add Localization Bundle.

    Localization bundles.png Localization bundles.png

  7. From the Locale list, select the language and region whose labels you want to customize. The language corresponds to the two-letter code in the file name.
  8. Under Localizations, click add_circle_outline .

    Localizations.png Localizations.png

  9. In the Name field, enter the path and filename from step 1 until the word Default. For example, if the developer gave you a path and filename com/psddev/cms/db/SiteDefault_en.properties, enter com/psddev/cms/db/Site.
  10. Under Entries, click.add_circle_outline .

    Localization entries.png Localization entries.png

  11. In the Key field, enter the key corresponding to the label you want to customize. Enter one of the following keys: displayName, global, or action.switch.
  12. Repeat steps 10–11 to customize additional labels in the configuration file.
  13. Repeat steps 8–12 to customize labels in other configuration files for the current locale.
  14. Repeat steps 6–13 to customize labels for other locales.
  15. Click Save.

When an editor uses the locale you selected in step 7, Brightspot retrieves the label from the override you entered.

Retreived label.png Retreived label.png

Previous Topic
Creating an auxiliary dictionary
Next Topic
Customizing Brightspot's appearance
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