Difference between revisions of "PT Social Media Version 2.1 Upgrade"

From ADF Docs
Jump to: navigation, search
(Application Code)
(Application Code)
 
(11 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 Customer Key you receive when you register your App with Twitter.</nowiki>
+
##Description: <nowiki>The Consumer Key you received when you registered your App with Twitter.</nowiki>
 
##Required: No
 
##Required: No
 
##Properties:
 
##Properties:
###Size: 60
+
###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 Customer Secret you receive when you register your App on Twitter.</nowiki>
+
##Description: <nowiki>The Consumer Secret you received when you registered your App on Twitter.</nowiki>
 
##Required: No
 
##Required: No
 
##Properties:
 
##Properties:
###Size: 60
+
###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 unique Twitter App Customer Key. Click here for More Info}''
+
## apiTwitterCustomerKey: ''{Your Twitter App Customer Key. [[PT_Social_Media_Twitter_App_Registration|more info...]] }''
## apiTwitterCustomerSecret: ''{Your unique Twitter App Customer Secret. Click here for More Info}''
+
## 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 export it into the "/ADF/apps/pt_socialmedia/" directory.
+
# 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

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:

  1. a Twitter API v1.1 Customer Key text field
    1. Type: text
    2. Field Name: apiTwitterCustomerKey
    3. Field Label: apiTwitterCustomerKey
    4. Description: The Consumer Key you received when you registered your App with Twitter.
    5. Required: No
    6. Properties:
      1. Size: 40
  1. a Twitter API v1.1 Customer Secret text field
    1. Type: text
    2. Field Name: apiTwitterCustomerSecret
    3. Field Label: apiTwitterCustomerSecret
    4. Description: The Consumer Secret you received when you registered your App on Twitter.
    5. Required: No
    6. Properties:
      1. Size: 40
  1. a Twitter API v1.1 POST oauth2/token URL text field
    1. Type: text
    2. Field Name: apiTwitterAuthTokenURL
    3. Field Label: apiTwitterAuthTokenURL
    4. Description: Twitter API Oauth token request URL.
    5. Required: No
    6. Properties:
      1. Size: 60
      2. Default Value: https://api.twitter.com/oauth2/token

App Configuration Updates

After the new fields have been added to the PTSocialMedia Configuration element:

  1. Go to the Social Media App Configuration Manager and click the "Edit Configuration" button.
  2. When the configuration form opens, go to the Twitter API tab, then add/update the the following fields with these new values:
    1. apiTwitterCustomerKey: {Your Twitter App Customer Key. more info... }
    2. apiTwitterCustomerSecret: {Your Twitter App Customer Secret. more info... }
    3. apiTwitterAuthTokenURL: https://api.twitter.com/oauth2/token
    4. apiTwitterSearch: https://api.twitter.com/1.1/search/tweets.json?q={{searchterm}}
    5. apiTwitterScreenName: https://api.twitter.com/1.1/statuses/user_timeline.json?screen_name={{screenname}}
    6. apiTwitterProfileURL: https://twitter.com/{{screenname}}
    7. apiTwitterStatusURL: https://api.twitter.com/1.1/statuses/show/{{twitterid}}.json
    8. apiTwitterTweetURL: https://twitter.com/{{screenname}}/status/{{twitterid}}
  3. Then click "Submit".
  4. When the configuration page reloads click the "Reset ADF / App Configuration" button.
- Twitter App Registration Instructions

Application Code

  1. Rename directory "/ADF/apps/pt_socialmedia/" to "/ADF/apps/pt_socialmedia_v2_0/".
  2. Rename file "/ADF/apps/pt_socialmedia_v2_0/appBeanConfig.cfm" to "/ADF/apps/pt_socialmedia_v2_0/appBeanConfig.cfm.old".
  3. 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.