Twitter

Enabling Brightspot to post tweets to Twitter requires the following steps:

  1. Creating a Twitter App
  2. Connecting Brightspot to a Twitter App
  3. Authorizing Posts to a Twitter Account

Creating a Twitter App

A Twitter App is the mechanism which allows third-party applications to authenticate and post directly to Twitter accounts. Brightspot uses the authentication model described under User authentication aka user context at Oauth with the Twitter API. The actual implementation is Twitter’s 3-legged authorization described in 3-legged OAuth.

In this procedure you create a Twitter app that allows Brightspot to post to Twitter.

  1. Install the Social plugin; contact your Brightspot developer for details.

  2. Create a developer account for the target Twitter profile if you don’t already have one.

  3. Log in to the target Twitter developer account at https://apps.twitter.com.

  4. Create a new app by doing the following:

    1. Click Create New App. The Create an application page appears.

      ../../../_images/tw-create-application.png
    2. Enter values for Name and Description.

    3. In the Website field, enter the domain from which you will be publishing content on Twitter. This must be a publicly accessible URL.

    4. In the Callback URL field, enter the domain from step c followed by _social/services/twitter/connect. See the example in the previous illustration.

    5. Acknowledge the developer agreement, and click Create your Twitter application. The app’s profile page appears.

      ../../../_images/tw-application-settings.png
  5. In the app’s profile page, under the Keys and Access Tokens tab, copy the Owner, Consumer Key, and Consumer Secret into a text editor; you’ll paste these values into Brightspot.

  6. Proceed to Connecting Brightspot to a Twitter App.

Connecting Brightspot to a Twitter App

  1. In Brightspot, from the Navigation Menu, select Social > Services. (If you don’t see Social, contact your Brightspot developer to install the Social plugin.)

  2. In the Services widget, click New Twitter Service. The New Twitter Service widget appears.

    ../../../_images/twitter-service.png
  3. In the New Twitter Service widget, do the following:

    1. In the Name, Consumer Key, and Consumer Secret fields, paste the values from Twitter’s Keys and Tokens tab.
    2. Click Save. If the connection is successful, a Connected message appears at the top of the Edit Twitter Service widget.
  4. Proceed to Authorizing Posts to a Twitter Account.

Authorizing Posts to a Twitter Account

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

  1. If you haven’t done so, connect Brightspot to the Twitter service. For details, see Connecting Brightspot to a Twitter App.

  2. In Brightspot, from the Navigation Menu, select Social > Accounts. (If you don’t see Social, contact your Brightspot developer to install the Social plugin.) The Connect Accounts widget appears with your Twitter service listed.

    ../../../_images/create-accounts-twitter.png
  3. In the Connect Accounts widget, under the required Twitter service, do the following:

    1. Click Connect Account. A request from Twitter appears asking for authentication.

      ../../../_images/tw-authorize.png
    2. Click Authorize App. You return to Brightspot with the Twitter account’s avatar displayed.

      ../../../_images/tw-authorize-confirmed.png

Brightspot users can now publish links to Twitter; for details, see Social Publishing.