Difference between revisions of "PT Social Media Version 2.1 Upgrade"
From ADF Docs
Gcronkright (talk | contribs) (→PTSocialMedia Configuration) |
Gcronkright (talk | contribs) (→Application Code) |
||
| (8 intermediate revisions by the same user not shown) | |||
| Line 12: | Line 12: | ||
##Field Name: apiTwitterCustomerKey | ##Field Name: apiTwitterCustomerKey | ||
##Field Label: apiTwitterCustomerKey | ##Field Label: apiTwitterCustomerKey | ||
| − | ##Description: <nowiki>The | + | ##Description: <nowiki>The Consumer Key you received when you registered your App with Twitter.</nowiki> |
##Required: No | ##Required: No | ||
##Properties: | ##Properties: | ||
| − | ###Size: | + | ###Size: 40 |
| − | ###Default Value: <nowiki></nowiki> | + | <!-- ###Default Value: <nowiki></nowiki> --> |
#a Twitter API v1.1 Customer Secret text field | #a Twitter API v1.1 Customer Secret text field | ||
| Line 22: | Line 22: | ||
##Field Name: apiTwitterCustomerSecret | ##Field Name: apiTwitterCustomerSecret | ||
##Field Label: apiTwitterCustomerSecret | ##Field Label: apiTwitterCustomerSecret | ||
| − | ##Description: <nowiki>The | + | ##Description: <nowiki>The Consumer Secret you received when you registered your App on Twitter.</nowiki> |
##Required: No | ##Required: No | ||
##Properties: | ##Properties: | ||
| − | ###Size: | + | ###Size: 40 |
| − | ###Default Value: <nowiki></nowiki> | + | <!-- ###Default Value: <nowiki></nowiki> --> |
#a Twitter API v1.1 POST oauth2/token URL text field | #a Twitter API v1.1 POST oauth2/token URL text field | ||
| Line 42: | Line 42: | ||
# Go to the Social Media App Configuration Manager and click the '''"Edit Configuration"''' button. | # Go to the Social Media App Configuration Manager and click the '''"Edit Configuration"''' button. | ||
# When the configuration form opens, go to the '''Twitter API''' tab, then add/update the the following fields with these new values: | # When the configuration form opens, go to the '''Twitter API''' tab, then add/update the the following fields with these new values: | ||
| − | ## apiTwitterCustomerKey: ''{Your | + | ## apiTwitterCustomerKey: ''{Your Twitter App Customer Key. [[PT_Social_Media_Twitter_App_Registration|more info...]] }'' |
| − | ## apiTwitterCustomerSecret: ''{Your | + | ## apiTwitterCustomerSecret: ''{Your Twitter App Customer Secret. [[PT_Social_Media_Twitter_App_Registration|more info...]] }'' |
## apiTwitterAuthTokenURL: <nowiki>https://api.twitter.com/oauth2/token</nowiki> | ## apiTwitterAuthTokenURL: <nowiki>https://api.twitter.com/oauth2/token</nowiki> | ||
## apiTwitterSearch: <nowiki>https://api.twitter.com/1.1/search/tweets.json?q={{searchterm}}</nowiki> | ## apiTwitterSearch: <nowiki>https://api.twitter.com/1.1/search/tweets.json?q={{searchterm}}</nowiki> | ||
## apiTwitterScreenName: <nowiki>https://api.twitter.com/1.1/statuses/user_timeline.json?screen_name={{screenname}}</nowiki> | ## apiTwitterScreenName: <nowiki>https://api.twitter.com/1.1/statuses/user_timeline.json?screen_name={{screenname}}</nowiki> | ||
| + | ## apiTwitterProfileURL: <nowiki>https://twitter.com/{{screenname}}</nowiki> | ||
## apiTwitterStatusURL: <nowiki>https://api.twitter.com/1.1/statuses/show/{{twitterid}}.json</nowiki> | ## apiTwitterStatusURL: <nowiki>https://api.twitter.com/1.1/statuses/show/{{twitterid}}.json</nowiki> | ||
| + | ## apiTwitterTweetURL: <nowiki>https://twitter.com/{{screenname}}/status/{{twitterid}}</nowiki> | ||
# Then click "Submit". | # Then click "Submit". | ||
# When the configuration page reloads click the '''"Reset ADF / App Configuration"''' button. | # When the configuration page reloads click the '''"Reset ADF / App Configuration"''' button. | ||
| + | |||
| + | - [[PT_Social_Media_Twitter_App_Registration|Twitter App Registration Instructions]] | ||
== Application Code == | == Application Code == | ||
# Rename directory "/ADF/apps/pt_socialmedia/" to "/ADF/apps/pt_socialmedia_v2_0/". | # Rename directory "/ADF/apps/pt_socialmedia/" to "/ADF/apps/pt_socialmedia_v2_0/". | ||
# Rename file "/ADF/apps/pt_socialmedia_v2_0/appBeanConfig.cfm" to "/ADF/apps/pt_socialmedia_v2_0/appBeanConfig.cfm.old". | # Rename file "/ADF/apps/pt_socialmedia_v2_0/appBeanConfig.cfm" to "/ADF/apps/pt_socialmedia_v2_0/appBeanConfig.cfm.old". | ||
| − | # Download the PT Social Media v2.1 and | + | # Download the PT Social Media v2.1 and copy the extracted files into the "/ADF/apps/pt_socialmedia/" directory. |
[[Reset ADF|Reset the ADF]] for the server and site. | [[Reset ADF|Reset the ADF]] for the server and site. | ||
Latest revision as of 15:18, 2 May 2014
Back to PT Social Media
Contents
Overview
The following guide is upgrading from v2.0 to v2.1.
Custom Element Updates
PTSocialMedia Configuration
Add the following new fields to the Twitter API tab of the ptSocialMedia Configuration element:
- a Twitter API v1.1 Customer Key text field
- Type: text
- Field Name: apiTwitterCustomerKey
- Field Label: apiTwitterCustomerKey
- Description: The Consumer Key you received when you registered your App with Twitter.
- Required: No
- Properties:
- Size: 40
- a Twitter API v1.1 Customer Secret text field
- Type: text
- Field Name: apiTwitterCustomerSecret
- Field Label: apiTwitterCustomerSecret
- Description: The Consumer Secret you received when you registered your App on Twitter.
- Required: No
- Properties:
- Size: 40
- a Twitter API v1.1 POST oauth2/token URL text field
- Type: text
- Field Name: apiTwitterAuthTokenURL
- Field Label: apiTwitterAuthTokenURL
- Description: Twitter API Oauth token request URL.
- Required: No
- Properties:
- Size: 60
- Default Value: https://api.twitter.com/oauth2/token
App Configuration Updates
After the new fields have been added to the PTSocialMedia Configuration element:
- Go to the Social Media App Configuration Manager and click the "Edit Configuration" button.
- When the configuration form opens, go to the Twitter API tab, then add/update the the following fields with these new values:
- apiTwitterCustomerKey: {Your Twitter App Customer Key. more info... }
- apiTwitterCustomerSecret: {Your Twitter App Customer Secret. more info... }
- apiTwitterAuthTokenURL: https://api.twitter.com/oauth2/token
- apiTwitterSearch: https://api.twitter.com/1.1/search/tweets.json?q={{searchterm}}
- apiTwitterScreenName: https://api.twitter.com/1.1/statuses/user_timeline.json?screen_name={{screenname}}
- apiTwitterProfileURL: https://twitter.com/{{screenname}}
- apiTwitterStatusURL: https://api.twitter.com/1.1/statuses/show/{{twitterid}}.json
- apiTwitterTweetURL: https://twitter.com/{{screenname}}/status/{{twitterid}}
- Then click "Submit".
- When the configuration page reloads click the "Reset ADF / App Configuration" button.
- Twitter App Registration Instructions
Application Code
- Rename directory "/ADF/apps/pt_socialmedia/" to "/ADF/apps/pt_socialmedia_v2_0/".
- Rename file "/ADF/apps/pt_socialmedia_v2_0/appBeanConfig.cfm" to "/ADF/apps/pt_socialmedia_v2_0/appBeanConfig.cfm.old".
- Download the PT Social Media v2.1 and copy the extracted files into the "/ADF/apps/pt_socialmedia/" directory.
Reset the ADF for the server and site.
Site Customizations
During the application implementation customizations may have been created. Check under the "/_cs_apps/pt_socialmedia/" directory under you site to see if any customizations exists. If you do have site customizations, you'll need to update these accordingly.
