Notifications

You can configure Brightspot to send you a notification when certain events occur, such as when someone publishes an item. You can set notification preferences for different site-content type combinations. For example, you can receive notifications when any item is published, or only when articles are published to one of your sites.

Overview of Notifications

Every time certain events occur, Brightspot checks if other users need to be informed of that event. For example, when a user publishes an article, Brightspot checks if other users have signed up to receive notifications about newly published articles, and then sends a notification to those users.

Users sign up for notifications by creating subscriptions. A subscription is a combination of an event and a delivery mechanism. The following illustration describes a typical subscription scenario.

../../../_images/notification-overview.svg

Referring to the previous illustration—

  • There is one event, publish. Whenever an editor publishes an item, Brightspot checks if other users have subscriptions that monitor the publish event.
  • Sam has two subscriptions:
    • Whenever anyone publishes any content type, he receives a notification via his browser.
    • Whenever anyone publishes an article, he receives a notification via email.
  • Sally also has two subscriptions:
    • Whenever anyone publishes an image, she receives a notification via her browser.
    • Whenever anyone publishes a video, she receives a notification via email.

Brightspot’s notifications feature is flexible enough so that you can receive notifications for only the events that matter to you. If your version of Brightspot does not offer the notifications you need for a particular event or delivery option, contact your Brightspot developer to install the corresponding plugin.

Prerequisites

This section describes how to configure the URLs that Brightspot sends in notifications, as well as defaults for email address and phone number.

Base URL for Notifications

When sending notifications that include hyperlinks, such as emails and text messages, Brightspot creates the hyperlink from a base URL and a path.

../../../_images/tool-url.svg

Before Brightspot can send hyperlinks correctly, you need to configure the default tool URL. For details, see Configuring Default Tool URL.

Configuring Origin Email and Phone Number

When sending notifications via email or text message, Brightspot can include a “from” email address or phone number.

  1. From the Navigation Menu, select Admin > Sites & Settings.

  2. In the Sites & Settings widget, click Global. The Edit Global widget appears.

  3. Under the Main tab, under Notifications, do the following:

    • In the Default From Email field, enter the email address that appears as the sender of email notifications.

    • In the Default From Phone Number field, enter a phone number that appears as the sender of text notifications.

      ../../../_images/from-email-phone.png
  4. Click Save.

Setting Your Default Email Address and Phone Number

When you configure a default email address and phone number, Brightspot can use them for all of your subscriptions. You can also override the default email and phone number for individual subscriptions.

For details about setting your default email address and phone number, see Viewing and Modifying Your Profile.

Delivery Options

A delivery option is the method by which you receive a notification from Brightspot. The following sections describe the most common delivery options; your version of Brightspot may have different delivery options.

Browser Notifications

When you sign up for this delivery option, your web browser displays a notification, similar to notifications from Gmail. The following is an example of a browser delivery option for Safari.

../../../_images/browser-delivery-option.png

To configure the browser delivery option:

  1. In the Brightspot header, click Profile. The Profile panel appears.
  2. Under the Notifications tab, under Delivery Options, click Add Browser.
  3. If a message appears that browser notifications are blocked, allow notifications from Brightspot. Use one of the resources in the table Resources for Enabling Browser Notifications.
../../../_images/browser-delivery-configuration.png

When you select your browser as a delivery option, you need to ensure your browser and your device’s operating system allows notifications. The following table provides links to resources that explain how to enable notifications on a variety of browsers and platforms.

Resources for Enabling Browser Notifications
Name Resource for Enabling Notifications
Operating Systems
OS X Sierra macOS Sierra: Notifications System Preferences
Windows 10 Get notifications you want
Chromebook Turn notifications on or off (Chromebook)
Android How To Enable Or Disable App Icon Badges On Android
iOS Use notifications on your iPhone, iPad, and iPod touch
Browsers
Chrome Turn notifications on or off (Chrome)
Firefox
Safari Safari for Mac: Notifications preferences in Safari

Email Notifications

When you sign up for this delivery option, Brightspot sends you an email similar to the following:

../../../_images/custom-email.png

Contact your Brightspot developer to customize the email’s wording and appearance for your organization’s needs.

To configure the email delivery option:

  1. Confirm with your Brightspot developer that your copy of Brightspot is configured to work with an email provider.

  2. In the Brightspot header, click Profile. The Profile panel appears.

  3. Under the Notifications tab, under Delivery Options, click Add Email. A form appears with your login email address.

    ../../../_images/email-pre-unconfirmed.png
  4. If necessary, modify the email address. (You can change the default email address; for details, see Viewing and Modifying Your Profile.)

  5. Repeat steps 3–4 to add additional email addresses for notifications.

  6. Click Save.

  7. Re-open the profile settings: in the Brightspot header, click Profile.

  8. Under the Notifications tab, under Delivery Options, check for a message that the delivery option needs to be verified.

    ../../../_images/email-unconfirmed.png
  9. Click Click here to confirm. Brightspot sends a confirmation message to your email addresses.

  10. In your email application, check for a message from Brightspot and click on the confirmation link.

Additional Options

You can extend Brightspot to send notifications for more events and delivery options.

Subscriptions and Events

A subscription sends notifications using a specified delivery option when a specified event occurs for a particular content type and site. The following examples illustrate different types of subscriptions:

  • When any user publishes any type of content to any of your sites, Brightspot sends an email notification.
  • When any user publishes any type of content to www.neanderthalcooking.com, Brightspot sends an email notification.
  • When any user publishes articles to www.neanderthalcooking.com, Brightspot displays a browser notification.

The following procedure describes how to configure a subscription for a publication event.

  1. In the Brightspot header, click Profile. The Profile panel appears.

  2. Under the Notifications tab, under Subscriptions, click Add Publish Subscription. A form appears.

  3. From the Delivery Options list, select the required delivery options. (For an explanation about configuring delivery options, see Delivery Options.)

  4. From the Content Filter list, select one of the following:

    • All Content—Brightspot sends a notification to the selected delivery options after every published event.

    • Basic Publish Content Filter—Select sites and content types. Brightspot sends a notification to the selected delivery options after a site-content type combination is published.

      ../../../_images/subscriptions-publish.png
  5. Click Save

Referring to the previous illustration, Brightspot sends two types of notifications:

  • When any content type is published to a site, you receive a notification through the browser.
  • When any content type Article is published to the site Modern Neanderthal Cooking, you receive an email.

Viewing Recent Notifications

When sending a notification through one of the delivery options, Brightspot also adds the notification to the Notifications widget.

../../../_images/notification-widget.png

The counter in the Brightspot Header lists the number of unread notifications you have. After you open the Notifications widget, the counter resets to zero. In addition, Brightspot eventually removes old notifications from the Notifications widget.

../../../_images/notification-counter.svg
  1. In the Brightspot Header, click . The Notifications widget appears.
  2. Click an item in the Notifications widget. Brightspot opens the corresponding link in your browser.

See also: