Difference between revisions of "PT Social Media"

Revision as of 19:55, 7 July 2011

About the Social Media App

The Social Media application is built using the Application Development Framework (ADF).

• Important: ADF 1.5 or greater is REQUIRED for this application.

Overview

The Social Media application provides a tool to allow your organizations social media live data streams from your Facebook Pages, your Twitter accounts and targeted Twitter keyword searches, your YouTube Channels and your WordPress blog posts to be combined various configurations to be displayed in one or in various strategic locations on your CommonSpot site.

Requirements

ADF Library components that are required for the Calendar application:

• CEData_1_1
• CSData_1_1
• Data_1_1
• Date_1_1
• Form_1_1
• UI_1_1
• Scripts_1_1
• JSON
• CCAPI

The ADF 1.5 must be configured correctly for your site. The Site Configuration (ADF.cfc) wiki page has instructions for configuration.

Contents

The Social Media application contains the following:

• Custom Coding - various components and scripts.

• Custom Elements:
  • SocialMedia Selector - Custom Element
  • Facebook Pages - Custom Element
  • Twitter Accounts Keywords - Custom Element
  • WordPress Blogs - Custom Element
  • YouTube Channels - Custom Element
  • ptSocialMedia Configuration - Custom Element

• Custom Fields:
  • Video Size Calculator Field

Note: Elements may contain one or more: Render Handlers or Custom Field Types. They do NOT use Display Templates.

Pre-installation Considerations

The Application Development Framework (ADF) must be setup and configured on the server for the site that will be implementing the Social Media application. For detailed instructions follow the ADF Overview wiki page for Site Configurations.

This installation guide assumes that you have no Custom Elements and/or Metadata Forms with the names above. Before the install, remove any Custom Elements/Metadata Forms with the names listed in the "Contents" section above. (If you do not remove existing elements with these names, you may have difficulties during the installation.)

Installation/Setup

Each of the following steps should be completed fully and in the order presented:

1. Download/Extract PT Social Media Application
2. PT Social Media ADF Configuration
3. Styles
4. Import Custom Elements
5. Site Configuration
6. Build Subsites, Templates and Pages

Guides

• Getting Started

Save your App Configuration and Reset the ADF

1. If you haven't already done so, go to your Social Media App Configuration Management page and click the button to add the app configuration data.

Setup the available Social Media Service Pages, Accounts and Keywords:

1. Add Social Media Service info for each of the Social Media services
   1. Go to your Web Admin manangement pages: http://{sitename}/webadmin/socialmedia/Manage-Social-Media.cfm
   2. Under each of the Social Media Tabs that is applicable to your organization click the 'Add' button and fill out the social media data form.
      1. Facebook Pages
         1. Give the new record a friendly name
         2. Add a Facebook Page Link (the URL of your organization Facebook page)
         3. Check the 'Feed Active' checkbox to enable the feed.
         4. Click Submit
      2. (Repeat for each desired Facebook page... Remember posts from these pages will not be visible until they are selected during the next step.)

Select Social Media Pages, Accounts and/or Keywords to build your feed

1. Go to the Public facing Social Media Feed Page
2. Go into Author (or Work) mode
3. Click on the element indicator for the Social Media Selector element
4. If this is the first time adding data click 'New Data' or click the 'Data' option.

Known Issues/Bugs

Found a bug, view the PT Social Media Issues page. Your issue not on the list? Then post it so the issue can be addressed.