PT Social Media Getting Started

From ADF Docs
Jump to: navigation, search

Back to Social Media

Social Media App Configuration

Make sure your App Configuration has been saved and the ADF reset.

  1. If you haven't already done so, go to your Social Media App Configuration Management page and click the button to 'Add Configuration' data.
  2. Update the fields listed on the Manage App Configuration Page with your customized information
  3. Reset the ADF

Social Media Service Management

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

  1. Go to your Web Admin Social Media Manangement page
  2. Under the Social Media Service tabs that are applicable to your organization click the 'Add New...' button and fill out and save the social media data.
    1. Facebook Pages
      1. Give the new record a friendly name
      2. Enter a Facebook Page Link (ie. the full URL of your organization Facebook page)
      3. Check the 'Feed Active' checkbox to enable the feed.
      4. Click Submit
      5. Repeat for each desired Facebook page
    2. Twitter Accounts and Keywords
      1. Enter a Twitter @Username or #Keyword
      2. Select if this is an 'Account' or a 'Keyword' entry
      3. Check the 'Feed Active' checkbox to enable the feed.
      4. Click Submit
      5. Repeat for each desired Twitter Accounts and/or keywords
    3. YouTube Channels
      1. Give the new record a friendly name (ie. the title of your Channel)
      2. Enter the YouTube channel username
      3. Check the 'Feed Active' checkbox to enable the feed.
      4. Click Submit
      5. Repeat for each desired YouTube Channel
    4. WordPress Blogs
      1. Give the new record a friendly name (ie. the Title of your Blog)
      2. Enter a Blog Link (the full URL of your Blog home page)
      3. Select (or upload) an Image icon to represent your Blog
      4. Check the 'Feed Active' checkbox to enable the feed.
      5. Click Submit
      6. Repeat for each desired WordPress Blog
Remember: Posts from these entries will not be visible until they are selected during the
Configure the Social Media Stream Page step.

Configure the Social Media Stream Page

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

  1. Go to the Social Media Stream Page you created in this step: Social Media Stream Page
  2. Switch the page into Author or Work on this Page 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' after that use the 'Data' icon to edit the Social Media Selector element.
  5. From the lightbox window that opens select the go to the first tab
    1. Display Properties
      1. Render Limit
      2. Display source links
      3. Twitter Tweet button options
      4. Facebook Like button options
      5. Lightbox option for YouTube video player (only applicable if a YouTube Channel is selected)
      6. YouTube Video Player size (only applicable if a YouTube Channel is seleted and the above YouTube Lightbox option is set to 'YES')
    2. Facebook tab
      1. Select one or more of the configured Facebook page by dragging any of the available options to the right column
    3. Twitter tab
      1. Select one or more of the configured Twitter accounts or keyword by dragging any of the available options to the right column
    4. YouTube tab
      1. Select one or more of the configured YouTube Channels by dragging any of the available options to the right column
    5. WordPress tab
      1. Select one or more of the configured WordPress Blogs by dragging any of the available options to the right column
  6. Click 'Save'
Remember: You can select any combination of the available pages, accounts and keywords to display
on your stream page.

Post Moderation

To blacklist a post so it will no longer display on the Social Media Stream page:

  1. While on the Social Media Stream Page
  2. Go in to Author or Work on this Page mode
  3. Click the 'Show Moderation Bars' button that appears on the right above or below the stream of posts
  4. Above each post will appear a "Remove This Post X" gray bar.
  5. Click the "Remove This Post X" and the post below the gray bar it will disappear and be blacklisted so it will no longer appear on the the Stream page for any user the next time the page is loaded.

Social Media Dashboard

(This section only applies to the Social Media App Version 1.2)

The Social Media Dashboard is divided in to three sections: Status, Tools, and Scheduled Tasks

App Status

This section contains information regarding the Service Feed Cache for the Social Media App.

  1. Service Feed Cache (Enable/Disable)
    • This displays the state of Service Feed Cache for the Social Media App (Enabled/Disabled)
    • The state of Service Feed Cache can be modified via the App Configuration Admin page.
  2. Service Feed Cache Last Build Date/Time
    • This displays the Date/Time Stamp of when the Service Feed Cache was last rebuilt

App Tools

This section contains buttons to activate background operations to help the performance of the Social Media App.

  1. Force Rebuild of the Feed Cache Button
    • Click this button to force the Feed Cache to be completely rebuilt
  2. Create 'Rebuild Feed Cache' Scheduled Task Button
    • Click this button to create the scheduled task in the Coldfusion Administrator to rebuild the Service Feed Cache. at regular intervals.
    • Once the scheduled task is complete it reschedules itself to trigger after the set interval.
    • Set the Rebuild Feed Cache Interval in the App Configuration Admin page.
    • This button will be disabled if a 'Rebuild Feed Cache' Scheduled task exists

App Scheduled Tasks

This section displays a table grid of information about the currently active Scheduled Tasks that belong to the Social Media App.

The Scheduled Tasks table grid displays:

  • Schedule Task Name
  • Interval - the pause time between the recurring tasks
  • Next Run Date
  • Next Run Time

Also:

  • Use the delete (trash can icon) to disable/remove a scheduled task.
  • Currently there is only one Schedule Task (Rebuild Feed Cache) that is utilized by the Social Media App.


Managing the 'Rebuild Feed Cache' Scheduled Task

Once the Rebuild Feed Cache task is scheduled it should repeat at the set interval.

Although, if your Social Media Stream Page does not appear to be updating. Check the "Next Run Date" and "Next Run Time" in the App Scheduled Tasks table grid of the Social Media Dashboard (Remember... refresh the Social Media Dashboard page if you have had the page open longer than the rebuild interval). If the date and time that are displayed appear to be in the past then the Scheduled task in not running and the Feed Cache data is not getting rebuilt.

Follow the steps below to reset the Rebuild Feed Cache scheduled task:

  • First, check to make sure the Social Media App can successfully rebuild the Feed Cache
  1. Click the Force Rebuild of the Feed Cache button
    • Remember... this can take some time to complete depending on the number of Social Media accounts you have configured
  2. Check to see if the Social Media posts on your "Stream Page" have updated
  3. If the posts on the "Stream Page" updated you can move to the next steps and reset the 'Rebuild Feed Cache' Scheduled task
  4. If not, you may need to check the logs to see if an error stopping the rebuild process from completing
  • Second, recreate the current Scheduled Task
  1. Remove the scheduled task by clicking the delete button (trash can icon)
  2. Click "OK" on the confirmation dialog
  3. Next, click the Create 'Rebuild Feed Cache' Scheduled Task button
    • The "Next Run Date" and "Next Run Time" in the App Scheduled Tasks table grid should now be in set for the future
    • Also, if you are have ROPS you will need to repeat this process via the Social Media Dashboard on each additional "Read Only" server.