Difference between revisions of "PT Social Media"
Gcronkright (talk | contribs) (→Installation Guides) |
Gcronkright (talk | contribs) |
||
(5 intermediate revisions by the same user 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: | IMPORTANT: | ||
Line 9: | Line 10: | ||
== Overview == | == Overview == | ||
− | The Social Media application provides a tool to allow your | + | 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 | + | * 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 | * 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 | * Posts can be moderated/filtered using either a blacklist or a whitelist | ||
− | * Social media feeds can be pulled | + | * 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. | ||
+ | |||
+ | <!-- , your Twitter accounts and targeted Twitter keyword searches --> | ||
== Requirements == | == Requirements == | ||
Line 41: | Line 46: | ||
**[[SocialMedia Selector]] - Custom Element | **[[SocialMedia Selector]] - Custom Element | ||
**[[SocialMedia Filtering]] - Custom Element | **[[SocialMedia Filtering]] - Custom Element | ||
− | **[[Twitter Accounts Keywords]] - Custom Element | + | <!-- **[[Twitter Accounts Keywords]] - Custom Element --> |
**[[WordPress Blogs]] - Custom Element | **[[WordPress Blogs]] - Custom Element | ||
**[[ptSocialMedia Configuration]] - Custom Element | **[[ptSocialMedia Configuration]] - Custom Element | ||
Line 82: | Line 87: | ||
** [[PT_Social_Media_Version_3.4_Upgrade|Version 3.4 Upgrade Guide]] (from v3.3) | ** [[PT_Social_Media_Version_3.4_Upgrade|Version 3.4 Upgrade Guide]] (from v3.3) | ||
− | '''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. | + | '''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 Release Versions:''' | + | '''Previous ADF 2.5.x and 2.6.x Release Versions:''' |
* v3.3: | * v3.3: | ||
** [[PT_Social_Media_Version_3.3_Release_Notes|Version 3.3 Release Notes]] | ** [[PT_Social_Media_Version_3.3_Release_Notes|Version 3.3 Release Notes]] | ||
Line 160: | Line 165: | ||
* [[PT_Social_Media_Facebook|Facebook Pages Data Stream]] | * [[PT_Social_Media_Facebook|Facebook Pages Data Stream]] | ||
* [[PT_Social_Media_Instagram|Instagram Posts Data Stream]] | * [[PT_Social_Media_Instagram|Instagram Posts Data Stream]] | ||
− | * [[PT_Social_Media_Twitter|Twitter Accounts and Keywords Data Stream]] | + | <!-- * [[PT_Social_Media_Twitter|Twitter Accounts and Keywords Data Stream]] --> |
* [[PT_Social_Media_YouTube|YouTube Channels Data Stream]] | * [[PT_Social_Media_YouTube|YouTube Channels Data Stream]] | ||
* [[PT_Social_Media_WordPress|WordPress Blogs Data Stream]] | * [[PT_Social_Media_WordPress|WordPress Blogs Data Stream]] |
Latest revision as of 23:06, 6 February 2025
Back to All Projects
Contents
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 Elements:
- SocialMedia Selector - Custom Element
- SocialMedia Filtering - Custom Element
- WordPress Blogs - 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 Guides
Current ADF 2.7 Release Version:
- v3.4:
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:
- v3.3:
- v3.2:
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:
- v3.0:
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:
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:
- v2.0:
IMPORTANT: v2.x of this application requires ADF 1.6 or greater
- v1.2:
- Version 1.2 Release Notes
- Version 1.2 Install Guide
- Version 1.2 Upgrade Guide (from v1.0 or v1.1)
IMPORTANT: v1.x of this application requires ADF 1.5 or greater
Getting Started Guide
Features
The social media application provides the following features:
- Facebook Pages Data Stream
- Instagram Posts Data Stream
- YouTube Channels Data Stream
- WordPress Blogs Data Stream
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.