Difference between revisions of "PT Social Media"

From ADF Docs
Jump to: navigation, search
(→‎Overview)
 
(76 intermediate revisions by 3 users not shown)
Line 1: Line 1:
 +
Back to [[View_All|All Projects]]
 +
 
== About the Social Media App ==
 
== About the Social Media App ==
 
The Social Media application is built using the [[Overview|Application Development Framework (ADF)]].  
 
The Social Media application is built using the [[Overview|Application Development Framework (ADF)]].  
 +
<!--
 +
IMPORTANT:
 +
  v1.x of this application requires '''ADF 1.5''' or greater
 +
  v2.x of this application requires '''ADF 1.6''' or greater
 +
-->
  
−
*Important: ADF 1.5 or greater is REQUIRED for this application.
+
== Overview ==
 +
The Social Media application provides a tool to allow your organization's social media live data streams from your Facebook Pages, your Instagram posts, your YouTube Channels, and your WordPress blog posts  to be combined in various configurations to be displayed in one or in various strategic locations on your CommonSpot site.
 +
* Any number of supported social media accounts can be set up in the app
 +
* Ready-made render handlers are provided to display your social media streams and can be updated to display your streams in any way you see fit
 +
* Posts can be moderated/filtered using either a blacklist or a whitelist
 +
* Social media feeds can be pulled regularly and cached for display purposes to avoid exceeding API quota limits
  
−
== Overview ==
+
IMPORTANT: X/Twitter support has been discontinued due to the termination of public API access.
−
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 keyword searches, your YouTube Channels and your WordPress blog posts to be combined and displayed in strategic locations on your CommonSpot site.
+
 
 +
<!-- , your Twitter accounts and targeted Twitter keyword searches -->
  
 
== Requirements ==
 
== Requirements ==
 
ADF Library components that are required for the Calendar application:
 
ADF Library components that are required for the Calendar application:
−
* CEData_1_0
+
* CEData_1_1
−
* CSData_1_0
+
* CSData_1_1
−
* Data_1_0
+
* Data_1_1
−
* Date_1_0
+
* Date_1_1
−
* Forms_1_0
+
* Forms_1_1
−
* Scripts_1_0
+
* UI_1_0
 +
* Scripts_1_1
 +
* JSON
 
* CCAPI
 
* CCAPI
  
−
The ADF must be configured correctly for your site. The [[Site Configuration (ADF.cfc)]] wiki page has instructions for configuration.
+
App v1.2 and higher also requires:
 +
* CSContent_1_0
 +
* Scheduler_1_0
 +
* Utils_1_1
 +
 
 +
The ADF 1.5.x must be configured correctly for your site. The [[Site Configuration (ADF.cfc)]] wiki page has instructions for configuration.
  
 
== Contents ==
 
== Contents ==
 
The Social Media application contains the following:
 
The Social Media application contains the following:
 
* Custom Coding - various components and scripts.
 
* Custom Coding - various components and scripts.
−
* CommonSpot Components:
+
 
−
<!--
+
* '''Custom Elements:'''
−
**[[Calendar2]]
+
**[[SocialMedia Selector]] - Custom Element
−
**[[Event Categories]]
+
**[[SocialMedia Filtering]] - Custom Element
−
**[[Event Organizations]]
+
<!-- **[[Twitter Accounts Keywords]] - Custom Element -->
−
**[[Calendar2 Page Map]]
+
**[[WordPress Blogs]] - Custom Element
−
**[[ptCalendar2 Configuration]]
+
**[[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.
 
Note: Elements may contain one or more: Render Handlers or Custom Field Types. They do NOT use Display Templates.
  
 
== Pre-installation Considerations ==
 
== Pre-installation Considerations ==
−
The [[Overview|ADF]] must be setup and configured on the server for the site that will be implementing the Profile application.  For detailed instructions follow the [[Overview|ADF Overview]] wiki page for Site Configurations.
+
The [[Overview|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 [[Overview|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.)
 
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 ==
 
== Installation/Setup ==
 
Each of the following steps should be completed fully and in the order presented:
 
Each of the following steps should be completed fully and in the order presented:
−
<!--
+
# [[PT Social Media Extract Application|Download/Extract PT Social Media Application]]
−
# [[PT Calendar2 Extract Application|Download/Extract PT Calendar2 Application]]
+
# [[PT Social Media ADF Configuration|PT Social Media ADF Configuration]]
−
# [[PT Calendar2 ADF Configuration|PT Calendar2 ADF Configuration]]
+
# [[PT Social Media Styles|Styles]]
−
# [[PT Calendar2 Styles|Styles]]
+
# [[PT Social Media Import Custom Elements|Import Custom Elements]]
−
# [[PT Calendar2 Import Custom Elements|Import Custom Elements]]
+
# [[PT Social Media Site Configuration|Site Configuration]]
−
# [[PT Calendar2 Site Configuration|Site Configuration]]
+
# [[PT Social Media Build Subsites Templates and Pages|Build Subsites, Templates and Pages]]
−
# [[PT Calendar2 Build Subsites Templates and Pages|Build Subsites, Templates and Pages]]
+
 
 
-->
 
-->
  
Line 52: Line 76:
 
== Features ==
 
== Features ==
 
The Social Media application provides the following features:
 
The Social Media application provides the following features:
 +
* [[PT_Social_Media_Facebook_Like|Facebook Like]]
 +
* [[PT_Social_Media_Twitter_Tweet|Twitter Tweet]]
 +
-->
 +
 +
== Installation Guides ==
 +
''' Current ADF 2.7 Release Version:'''
 +
* v3.4:
 +
** [[PT_Social_Media_Version_3.4_Release_Notes|Version 3.4 Release Notes]]
 +
** [[PT_Social_Media_Version_3.4_Install|Version 3.4 Install Guide]]
 +
** [[PT_Social_Media_Version_3.4_Upgrade|Version 3.4 Upgrade Guide]] (from v3.3)
  
−
* [[PT_Social_Media_Lightbox|Lightbox]]
+
'''IMPORTANT''': The above version of this application requires '''ADF 2.7.0''' or greater and '''CommonSpot 11.0.0, 10.9.1 or 10.8.3''' or greater.
  
−
== Guides ==
+
'''Previous ADF 2.5.x and 2.6.x Release Versions:'''
−
* Getting Started
+
* v3.3:
 +
** [[PT_Social_Media_Version_3.3_Release_Notes|Version 3.3 Release Notes]]
 +
** [[PT_Social_Media_Version_3.3_Install|Version 3.3 Install Guide]]
 +
** [[PT_Social_Media_Version_3.3_Upgrade|Version 3.3 Upgrade Guide]] (from v3.2)
 +
 
 +
* v3.2:
 +
** [[PT_Social_Media_Version_3.2_Release_Notes|Version 3.2 Release Notes]]
 +
** [[PT_Social_Media_Version_3.2_Install|Version 3.2 Install Guide]]
 +
** [[PT_Social_Media_Version_3.2_Upgrade|Version 3.2 Upgrade Guide]] (from v3.1)
 +
 
 +
'''IMPORTANT''': The above versions of this application require '''ADF 2.5''' or greater and '''CommonSpot 10.5.2 or 10.6.1''' or greater.
 +
 
 +
'''Previous ADF 2.4.x Versions:'''
 +
* v3.1:
 +
** [[PT_Social_Media_Version_3.1_Release_Notes|Version 3.1 Release Notes]]
 +
** [[PT_Social_Media_Version_3.1_Install|Version 3.1 Install Guide]]
 +
** [[PT_Social_Media_Version_3.1_Upgrade|Version 3.1 Upgrade Guide]] (from v3.0)
 +
 
 +
* v3.0:
 +
** [[PT_Social_Media_Version_3.0_Release_Notes|Version 3.0 Release Notes]]
 +
** [[PT_Social_Media_Version_3.0_Install|Version 3.0 Install Guide]]
 +
** [[PT_Social_Media_Version_3.0_Upgrade|Version 3.0 Upgrade Guide]] (from v2.2)
 +
'''IMPORTANT''': The 'ADF 2.4.x Versions' of this application require '''ADF 2.0 to 2.4.x''' and '''CommonSpot 10 up to 10.5.1 or 10.6'''
 +
 
 +
'''Previous ADF 1.8 Version:'''
 +
* v2.2:
 +
** [[PT_Social_Media_Version_2.2_Release_Notes|Version 2.2 Release Notes]]
 +
** [[PT_Social_Media_Version_2.2_Install|Version 2.2 Install Guide]]
 +
** [[PT_Social_Media_Version_2.2_Upgrade|Version 2.2 Upgrade Guide]] (from v2.1)
 +
'''IMPORTANT''': v2.x of this application requires '''ADF 1.6''' or greater. '''ADF 1.8.x''' is recommended.
 +
 
 +
 
 +
'''Previous ADF 1.x Versions:'''
 +
* v2.1:
 +
** [[PT_Social_Media_Version_2.1_Release_Notes|Version 2.1 Release Notes]]
 +
** [[PT_Social_Media_Version_2.1_Install|Version 2.1 Install Guide]]
 +
** [[PT_Social_Media_Version_2.1_Upgrade|Version 2.1 Upgrade Guide]] (from v2.0)
 +
 
 +
* v2.0:
 +
** [[PT_Social_Media_Version_2.0_Release_Notes|Version 2.0 Release Notes]]
 +
** [[PT_Social_Media_Version_2.0_Install|Version 2.0 Install Guide]]
 +
** [[PT_Social_Media_Version_2.0_Upgrade|Version 2.0 Upgrade Guide]] (from v1.2)
 +
 
 +
'''IMPORTANT''': v2.x of this application requires '''ADF 1.6''' or greater
 +
 
 +
* v1.2:
 +
** [[PT_Social_Media_Version_1.2_Release_Notes|Version 1.2 Release Notes]]
 +
** [[PT_Social_Media_Version_1.2_Install|Version 1.2 Install Guide]]
 +
** [[PT_Social_Media_Version_1.2_Upgrade|Version 1.2 Upgrade Guide]] (from v1.0 or v1.1)
 +
 
 +
* v1.1
 +
** [[PT_Social_Media_Version_1.1_Release_Notes|Version 1.1 Release Notes]]
 +
** [[PT_Social_Media_Version_1.1_Install|Version 1.1 Install Guide]]
 +
 
 +
* v1.0
 +
** [[PT_Social_Media_Version_1.0_Release_Notes|Version 1.0 Release Notes]]
 +
** [[PT_Social_Media_Version_1.0_Install|Version 1.0 Install Guide]]
 +
 
 +
'''IMPORTANT''': v1.x of this application requires '''ADF 1.5''' or greater
 +
 
 +
<!--
 +
'''Current Development Build:'''
 +
* v2.3:
 +
** [[PT_Social_Media_Version_2.3_Release_Notes|Version 2.3 Release Notes]]
 +
** [[PT_Social_Media_Version_2.3_Install|Version 2.3 Install Guide]]
 +
** [[PT_Social_Media_Version_2.3_Upgrade|Version 2.3 Upgrade Guide]] (from v2.2)
 
-->
 
-->
 +
 +
== Getting Started Guide ==
 +
* [[PT_Social_Media_Getting Started|Getting Started]]
 +
 +
== Features ==
 +
The social media application provides the following features:
 +
* [[PT_Social_Media_Facebook|Facebook Pages Data Stream]]
 +
* [[PT_Social_Media_Instagram|Instagram Posts Data Stream]]
 +
<!-- * [[PT_Social_Media_Twitter|Twitter Accounts and Keywords Data Stream]] -->
 +
* [[PT_Social_Media_YouTube|YouTube Channels Data Stream]]
 +
* [[PT_Social_Media_WordPress|WordPress Blogs Data Stream]]
  
 
== Known Issues/Bugs ==
 
== Known Issues/Bugs ==

Latest revision as of 23:06, 6 February 2025

Back to All Projects

About the Social Media App

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

Overview

The Social Media application provides a tool to allow your organization's social media live data streams from your Facebook Pages, your Instagram posts, your YouTube Channels, and your WordPress blog posts to be combined in various configurations to be displayed in one or in various strategic locations on your CommonSpot site.

  • Any number of supported social media accounts can be set up in the app
  • Ready-made render handlers are provided to display your social media streams and can be updated to display your streams in any way you see fit
  • Posts can be moderated/filtered using either a blacklist or a whitelist
  • Social media feeds can be pulled regularly and cached for display purposes to avoid exceeding API quota limits
IMPORTANT: X/Twitter support has been discontinued due to the termination of public API access.


Requirements

ADF Library components that are required for the Calendar application:

  • CEData_1_1
  • CSData_1_1
  • Data_1_1
  • Date_1_1
  • Forms_1_1
  • UI_1_0
  • Scripts_1_1
  • JSON
  • CCAPI

App v1.2 and higher also requires:

  • CSContent_1_0
  • Scheduler_1_0
  • Utils_1_1

The ADF 1.5.x 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 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 Guides

Current ADF 2.7 Release Version: 

IMPORTANT: The above version of this application requires ADF 2.7.0 or greater and CommonSpot 11.0.0, 10.9.1 or 10.8.3 or greater.

Previous ADF 2.5.x and 2.6.x Release Versions: 

IMPORTANT: The above versions of this application require ADF 2.5 or greater and CommonSpot 10.5.2 or 10.6.1 or greater.

Previous ADF 2.4.x Versions: 

IMPORTANT: The 'ADF 2.4.x Versions' of this application require ADF 2.0 to 2.4.x and CommonSpot 10 up to 10.5.1 or 10.6

Previous ADF 1.8 Version: 

IMPORTANT: v2.x of this application requires ADF 1.6 or greater. ADF 1.8.x is recommended.


Previous ADF 1.x Versions: 

IMPORTANT: v2.x of this application requires ADF 1.6 or greater

IMPORTANT: v1.x of this application requires ADF 1.5 or greater


Getting Started Guide

Features

The social media application provides the following features:

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.

Retrieved from "https://community.paperthin.com/adf-docs/index.php?title=PT_Social_Media&oldid=8403"