Topics

Facebook


In This Guide

You can post messages to Facebook directly from Brightspot.


Connecting Brightspot to a Facebook app

To post to your Facebook account from Brightspot, you need to connect Brightspot to an existing Facebook app.

Note
Perform the steps in this section from a Brightspot instance running over HTTPS. Facebook does not allow connections from sites running over HTTP.

To connect Brightspot to a Facebook app:

  1. In Brightspot, switch to the site from which you will be connecting to Facebook. For details, see Switching between sites.
  2. Click menu > Social > Services.
  3. In the Services widget, click New Facebook Service. The New Facebook Service widget appears.
    New Facebook service widget.png
    New Facebook service widget
  4. In the New Facebook Service widget, do the following:
    1. In the Name field, type a name for the service.
    2. In the App ID and App Secret fields, paste the values from your Facebook console.
    3. Click Save. Your Brightspot instance is now connected to a Facebook app, and a URL with two query parameters appears in your browser's address bar.
    4. In your browser's URL, copy into a text editor the value for the query parameter id. This is your Facebook's service ID within Brightspot, and you'll need this value when establishing redirect URIs in your Facebook app's settings.
      Service ID example.svg
      Service ID example
    5. Proceed to the next step, Adding callback URIs to a Facebook app.

Adding callback URIs to a Facebook app

The procedure in the previous section, Connecting Brightspot to a Facebook App, generated a service ID that you pasted into a text editor. With that service ID you add two callback URIs to your Facebook app that allow your Brightspot instance to log in to Facebook and to post to profiles and pages. The callback URIs have the following formats:

https://my-domain.com/_social/services/facebook/connect?serviceId=<serviceID>&action=USER_AUTH_CALLBACK
https://my-domain.com/_social/services/facebook/connect?serviceId=<serviceID>&action=PAGES_AUTH_CALLBACK

  1. Return to Facebook's Client OAuth Settings widget for your app.
    Client OAuth Settings.png
    Client OAuth settings
  2. In the Valid OAuth Redirect URIs field, enter the two callback URIs for your Brightspot instance: one for action=USER_AUTH_CALLBACK and another for action=PAGES_AUTH_CALLBACK.
    Valid OAuth Redirect URIs.png
  3. Click Save Changes.

Authorizing posts to Facebook profile and page

Many applications on the Internet provide access to other applications. Cross-access between applications is very useful if you have several social media accounts and you want to post an article to one of them and then link to it on your other accounts. For example, if you posted an article on LinkedIn, you can share a link to that article on your Facebook, Twitter, and Google+ accounts. The same feature is available with Brightspot: you can post a story to your website from Brightspot, and then share links to that story on your social media accounts right from the content edit page. The mechanism by which one application grants access to another one is called Open Authorization (OAuth).

This section describes how to authorize posts to Facebook from Brightspot using OAuth.

Authorizing posts to a Facebook profile

In this step, Facebook requests authorization to post to the target Facebook account from Brightspot.

Note
Perform the steps in this section from a Brightspot instance running over HTTPS. Facebook does not allow connections from sites running over HTTP.

To authorize posts to a Facebook profile:

  1. In Brightspot, click menu>Social > Accounts. The Connect Accounts widget appears with your Facebook service listed.
    Connect Accounts options.png
    Connect Accounts widget
  2. In the Connect Accounts widget, under the required Facebook service, do the following (if you do not see a Facebook service, add one by following the procedure in Connecting Brightspot to a Facebook App):

    1. Click Connect Profile. A request from Facebook appears asking for authentication.
      Facebook authentication window.png
      Facebook authentication window
    2. Complete the authentication request. You return to the Connect Accounts widget, and the target Facebook account is listed.

      Facebook target account.png
      Facebook target account example

Brightspot users can now publish links to Facebook; for details, see Sharing content on social networks.

Authorizing posts to a Facebook page

Some companies have Facebook pages dedicated to target audiences. You can publish from Brightspot directly to those pages.

Note
Perform the steps in this section from a Brightspot instance running over HTTPS. Facebook does not allow connections from sites running over HTTP.

To authorize posts to a Facebook page:

  1. In Brightspot, from the Navigation Menu, select Social > Accounts. The Connect Accounts widget appears with your Facebook service listed.

    Connect Accounts options.png
    Connect Accounts widget

  2. In the Connect Accounts widget, under the required Facebook service, do the following:
    1. Click Connect Page. A request from Facebook appears asking for authentication.

      Facebook page authentication.png
      Facebook authentication page

    2. Click OK. You return to Brightspot showing a list of your Facebook pages.

      Choose a Facebook page.png
      Choose a Facebook page example

    3. Select the required page. You return to the Connect Accounts widget, and the target Facebook page is listed.

Brightspot users can now publish links to Facebook; for details, see Sharing content on social networks.