KB Version:

Page Navigation

Related Links

Learning Levels

Most Read

Announcements RSS Feed of Announcements

Facebook Connector

Digest

The Cascade Server Facebook Connector is a Connector that allows Cascade to publish content to a single Facebook account's Facebook page. The content of Pages having specific Content Types (for example, "announcement") published to a specific Destination will be automatically posted to the Facebook page specified by the Connector when the Page is published the first time. Posts generated by this Connector will contain a link to the published version of a Page, the title of the page (or system name if no title is specified) and an optional prefix specified for the Connector.

Concept

Content of Facebook Posts

Facebook Connectors automatically send a Facebook post about a Page on publish. The post includes an optional configurable prefix, the metadata title of the Page (or system name if no title is present) and a link to the newly published content. The link is created using the Web URL of the Destination associated with the Connector, if set or the Site's URL property otherwise

Here is an example post generated by Cascade Server:

Hannon Hill News: Cascade 6.8 Released - http://www.hannonhill.com/kb/Release-Notes/6.8/index.html

Publishing to Eligible Facebook Connectors

When publishing a Page or Folder, all verified Connectors appear in a list labeled Connectors.  If a verified Facebook Connector references the Content Type, Page Configuration, and Destination that the asset is published to, then a Facebook post will be generated for the asset.

Cascade Server will only publish a Facebook post for a Page asset if that asset was created after the creation date of the Facebook Connector and if the Page has neve been published to Facebook before.  Assets existing in the system before the 6.10 upgrade will not be eligible to be posted.  These assets would need to be copied over to new assets in order to satisfy the creation date constraint mentioned in the note above.

Technical

Creating a Facebook Connector

Create Screenshot
  1. While in a Site, go to Administration -> Connectors -> New Connector
  2. On the Connector Type screen, select Facebook and click Submit
  3. Fill out the form.  The fields are:
    1. General Pane
      1. System Name - The name of your Facebook Connector
      2. Parent Container - The Connector Container where the Connector is saved
      3. Destination - The Destination to which a Page must be published in order for a Facebook post to be generated
    2. Content Types
      1. Select one or more Content Types.  Pages having one of these Content Types will be considered for posting.
      2. For each Content Type, select a Page Configuration from the drop-down. The Page Configuration will be used to determine which file extension to use when linking to the published Page. Also, a post will only be generated when that specific Page Configuration is published.
    3. Parameters
      1. Prefix - Text that is prepended to all posts (e.g. "Cascade News - ")
      2. Page Name - The name of the Facebook page
  4. Submit the Facebook Connector to save.

Verifying the Facebook Connector

When a Facebook Connector is created, it still needs to be linked to a Facebook account as Cascade Server does not store any Facebook login credentials.  To link a Facebook Connector to a Facebook account:

  1. On the View tab for the Facebook Connector, click the "Verify" link in the Verification section.
  2. A link to a Facebook page will appear below saying, Allow Cascade to access your Facebook account
    Facebook Connector Verify Screenshot
  3. Click the link to popup a new window to a Facebook login page asking you to Allow Cascade Server access to your Facebook account.
  4. You will be forwarded to a page showing an access token - copy that token
  5. Go back to the original window with the Cascade Facebook connector screen and paste the token into the text field shown on the screen above
  6. Hit the Submit button to complete the verification process

Unverifying the Facebook Connector

To unverify the Facebook Connector, simply click "Unverify" on the View tab.  This will remove all authentication information.

*Note - Facebook Connectors never become automatically unverified; the only way to unverfiy a Connector is to do so manually as stated above.

Related Links