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

From ADF Docs
Jump to: navigation, search
(PTSocialMedia Configuration)
 
(20 intermediate revisions by the same user not shown)
Line 1: Line 1:
Back to [[PT_Social_Media|Social Media]]
+
Back to [[PT_Social_Media|PT Social Media]]
  
  IMPORTANT: v1.2 IS NOT RELEASED AND THESE DOCS ARE NOT COMPLETE!!!
+
  IMPORTANT: '''ADF 1.5''' or greater is '''REQUIRED''' for this application.
 
 
<!-- IMPORTANT: '''ADF 1.5''' or greater is '''REQUIRED''' for this application. -->
 
  
 
== Overview ==
 
== Overview ==
This guide is to upgrade the PT Social Media from version 1.0 or 1.1 to version 1.2 of the application
+
This guide is to upgrade the PT Social Media from version 1.0 or 1.1 to version 1.2 of the application.
 
 
== Application Code ==
 
 
 
Remember: Please backup your pt_social_media directory and move the backup out of the ADF/apps directory
 
 
 
# Rename the directory "/ADF/apps/pt_social_media" to "/ADF/apps/pt_social_media_v1_0".
 
# Rename the file "/ADF/apps/pt_social_media_v1_0/appBeanConfig.cfm" to "/ADF/apps/pt_social_media_v1_0/appBeanConfig.cfm.old".
 
# Download PT Social Media v1.2 and copy the extracted files into the "/ADF/apps/pt_social_media/" directory.
 
  
 
== Custom Element Updates ==
 
== Custom Element Updates ==
  
 
=== PTSocialMedia Configuration ===
 
=== PTSocialMedia Configuration ===
Add the following new fields to the '''General Config''' tab:
+
Add the following new fields to the '''General Config''' tab of the ptSocialMedia Configuration element:
 
#a Select Service Types multi-checkbox field
 
#a Select Service Types multi-checkbox field
 
##Type: multicheckbox
 
##Type: multicheckbox
Line 53: Line 43:
 
###Checked by default: 0
 
###Checked by default: 0
 
#a Rebuild Feed Cache Interval integer field
 
#a Rebuild Feed Cache Interval integer field
##Type: integer
+
##Type: Number (integer)
 
##Field Name:  rebuildFeedCacheInterval
 
##Field Name:  rebuildFeedCacheInterval
 
##Field Label:  Rebuild Feed Cache Interval
 
##Field Label:  Rebuild Feed Cache Interval
Line 60: Line 50:
 
###Maxlength: 10
 
###Maxlength: 10
 
###Size: 10
 
###Size: 10
+
###Default Value: 15
 +
Remove the following field from the '''Facebook API''' tab of the ptSocialMedia Configuration element:
 +
#Field Name:  apiFacebookAPIKey
 +
 
 +
=== 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, add the '''default values''' from the list above as values for the new fields.
 +
# Then click "Submit".
 +
# When the configuration page reloads click the '''"Reset ADF / App Configuration"''' button.
 +
 
 +
== Application Code ==
 +
<!-- Remember: Please backup your pt_social_media directory and move the backup out<br>of the ADF/apps directory -->
 +
 
 +
# Rename the directory "/ADF/apps/pt_social_media" to "/ADF/apps/pt_social_media_v1_1".
 +
# Rename the file "/ADF/apps/pt_social_media_v1_1/appBeanConfig.cfm" to "/ADF/apps/pt_social_media_v1_1/appBeanConfig.cfm.old".
 +
# Download PT Social Media v1.2 and copy the extracted files into the "/ADF/apps/pt_social_media/" directory.
 +
 
 
== New Features ==
 
== New Features ==
 
# Social Media Service Feed Data Cache
 
# Social Media Service Feed Data Cache
Line 66: Line 73:
  
 
== Updates ==
 
== Updates ==
# Follow the [[PT Social Media Version 1.2 Install|v1.2 install guide]] to build the following admin page:
+
# Follow the [[PT Social Media Version 1.2 Install|v1.2 install guide]] to build the following admin dashboard page:
 
## [[PT Social Media Version 1.2 Install#Admin Pages|Admin Pages]] > [[PT Social Media Version 1.2 Install#Social Media Dashboard Page|Social Media Dashboard Page]]
 
## [[PT Social Media Version 1.2 Install#Admin Pages|Admin Pages]] > [[PT Social Media Version 1.2 Install#Social Media Dashboard Page|Social Media Dashboard Page]]
  
<!--
+
Go to the '''Social Media Dashboard''' section on the [[PT_Social_Media_Getting Started#Social Media Dashboard|Getting Started]] page for more information on usage of this page.
 
 
# Metadata Form:
 
## Rename the metadata form to "Blogs2" (from "Blogs").  Potential issue if you have the old Blog application installed and have a custom metadata form named "Blog" within your site.
 
## Update the Blog Post template render mode filter expression with "request.page.metadata.blogs2" metadata form.
 
## Update the Blog Post Landing Page and Tags Listing templates if they are created.
 
# CCAPI
 
## Update the CCAPI Page to include the "Blog2 Feature Data" element.  Review the V2.1 install guide for "CCAPI Configuration" to make sure all the CCAPI elements are configured.
 
## Update the CCAPI Page to include the "Blog2" element.  Review the V2.1 install guide for "CCAPI Configuration" to make sure all the CCAPI elements are configured.
 
# Blog Manager Page
 
## The new blog manager page has removed the "dashboard" link to an icon along side the edit and delete icons.   
 
## Follow the following steps to update the datasheet:
 
### Edit datasheet columns
 
### On the second column (blogID), change the render handler to:
 
#### /ADF/apps/pt_blog/datasheet-modules/blog_edit_delete.cfm
 
### On the first column, rename the header to "blogTemplate", and then delete the column from the datasheet.
 
## The datasheet will now show 3 icons in the first column of the datasheet.  The 3rd icon will open to the blog dashboard.
 
# Blog Subsite Field
 
## The subsite field in the Blog2 custom element has been replaced with a new field called 'subsiteURL''''All the blogs records (not the blog posts) need to be updated for this new field.''' Follow the steps below to remove this field.
 
### Navigate to the Blog Manager.  Edit all the blog records.  In the blog form, enter the subsite path in the 'subsiteURL' field that is displayed in the 'subsite' select field. 
 
### After all the blog records are updated.  On the site administrator and manage the elements.  Open the field definitions for the 'Blog2' custom element.  Delete the 'subsite' field from the custom element.
 
 
 
-->
 

Latest revision as of 18:32, 9 September 2015

Back to PT Social Media

IMPORTANT: ADF 1.5 or greater is REQUIRED for this application.

Overview

This guide is to upgrade the PT Social Media from version 1.0 or 1.1 to version 1.2 of the application.

Custom Element Updates

PTSocialMedia Configuration

Add the following new fields to the General Config tab of the ptSocialMedia Configuration element:

  1. a Select Service Types multi-checkbox field
    1. Type: multicheckbox
    2. Field Name: socialMediaServiceTypes
    3. Field Label: Select Service Types
    4. Required: No
    5. Properties:
      1. Option List Source: Value List
      2. Option List: Facebook,Twitter,YouTube,WordPress
      3. Default Value: Facebook,Twitter,YouTube,WordPress
  2. a Dashboard URL cs_url field
    1. Type: cs_url
    2. Field Name: dashboardURL
    3. Field Label: Dashboard URL
    4. Required: No
  3. a Serivce Manager URL cs_url field
    1. Type: cs_url
    2. Field Name: serviceManagerURL
    3. Field Label: Serivce Manager URL
    4. Required: No
  4. a Configuration Manger URL cs_url field
    1. Type: cs_url
    2. Field Name: configManagerURL
    3. Field Label: Configuration Manager URL
    4. Required: No
  5. a Enable Feed Cache checkbox field
    1. Type: checkbox
    2. Field Name: enableFeedCache
    3. Field Label: Enable Feed Cache
    4. Required: No
    5. Properties:
      1. Value: 1
      2. Checked by default: 0
  6. a Rebuild Feed Cache Interval integer field
    1. Type: Number (integer)
    2. Field Name: rebuildFeedCacheInterval
    3. Field Label: Rebuild Feed Cache Interval
    4. Required: No
    5. Properties:
      1. Maxlength: 10
      2. Size: 10
      3. Default Value: 15

Remove the following field from the Facebook API tab of the ptSocialMedia Configuration element:

  1. Field Name: apiFacebookAPIKey

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, add the default values from the list above as values for the new fields.
  3. Then click "Submit".
  4. When the configuration page reloads click the "Reset ADF / App Configuration" button.

Application Code

  1. Rename the directory "/ADF/apps/pt_social_media" to "/ADF/apps/pt_social_media_v1_1".
  2. Rename the file "/ADF/apps/pt_social_media_v1_1/appBeanConfig.cfm" to "/ADF/apps/pt_social_media_v1_1/appBeanConfig.cfm.old".
  3. Download PT Social Media v1.2 and copy the extracted files into the "/ADF/apps/pt_social_media/" directory.

New Features

  1. Social Media Service Feed Data Cache
  2. Social Media Dashboard Admin Page

Updates

  1. Follow the v1.2 install guide to build the following admin dashboard page:
    1. Admin Pages > Social Media Dashboard Page

Go to the Social Media Dashboard section on the Getting Started page for more information on usage of this page.