PT Blog Version 4.5 Upgrade

From ADF Docs
Revision as of 21:07, 5 February 2025 by Gcronkright (talk | contribs) (Disabling the CCAPI for Custom Elements)
Jump to: navigation, search

Back to PT Blogs

IMPORTANT: v4.5 of this application requires ADF 2.7.0 or greater and CommonSpot 11.0.0, 10.9.1 or 10.8.2 or greater.

Overview

This guide for upgrading the PT Blog v4.5 application from v4.4. If you are upgrading from a version earlier than v4.7, please complete the v1.0 - v4.5 Upgrade Guides in order.

Application Code

  1. Rename directory "/ADF/apps/pt_blog" to "/ADF/apps/pt_blog_v4_4".
  2. Rename file "/ADF/apps/pt_blog_v4_4/appBeanConfig.cfm" to "/ADF/apps/pt_blog_v4_4/appBeanConfig.cfm.old".
  3. Download the PT Blog v4.5 and extract the files and folder structure into the "/ADF/apps/pt_blog/" directory.
  4. Reset the ADF.

Site Level Customizations Review

This is only for reviewing the site-level customizations in the "/_cs_apps/pt_blog/" directory, not in the ADF directory.

  1. Analyze the updated app code compared to the app customization code on your server.
    1. Identify any customizations that you have made to the application code to make sure these are updated with any functionality.
    2. Again, Beyond Compare is a good tool to compare the new and current file to identify the exact lines of code that have been changed.
    3. This is important for components that have customized functions to the site level "/_cs_apps/". The best practice is to identify the function that have been customized and compare with the new app function to identify any updates. A good help is to check the function comment header to see if any updates have been made.
  2. Once completed, Reset the ADF.

Disabling the CCAPI for Custom Elements

IMPORTANT: For CommonSpot 11.x or above. If you are using this app with CommonSpot 10.9.1 or 10.8.3 or below, DO NOT disable the CCAPI for Custom Elements for this App!! 
  1. Find your CCAPI conduit page for the Calendar App. This page is generally called 'ccapiCalendar' built from the 'Blank Layout Template.
    1. The ccapiCalendar.cfm page may be located in the '/webadmin/calendar/' subsite.
  2. Once you find the CCAPI Conduit page that has the Blog App elements on it, disable this page.
  3. In the '/_cs_apps/config/ccapi.cfm' file for the site remove the <Blog>, <BlogFeatureData>, <BlogPost>, and <Comments> nodes from the <elements> section of the XML block.
  4. Once completed, Reset the ADF.
Note: If no other CE nodes are listed in the <elements> node, other ADF CCAPI functions may still use the <wsVars> configuration information, so do not remove this file.