PT Blog Upgrade v3

Overview

This guide is to upgrade the PT Blog v2.3 application. If upgrading from a lower version than v2.3, please follow the Version 2.2 Install Guide to validate your installation.

Application Code

1. Renamed directory "/ADF/apps/pt_blog" to "/ADF/apps/pt_blog_v2_3".
2. Renamed file "/ADF/apps/pt_blog_v2_3/appBeanConfig.cfm" to "/ADF/apps/pt_blog_v2_3/appBeanConfig.cfm.old".
3. Downloaded the PT Blog v3 and exported into the "/ADF/apps/pt_blog/" directory.

Custom Elements

Blog2

Add the following new fields:

1. Name: notificationFrom
   1. Tab: Notifications
      1. Move this field to the first field in the Notifications tab.
   2. Label: From Email Address
   3. Type: Email
   4. Description: Email address to be used as the FROM email for the notification emails.
   5. Properties:
      1. Size: 40

Templates

Blog Post Template

Navigate to the Blog Post template that was created from the installation. Rename the page to add "template" into the title for easy recognition.

On the page, open the dialog "Actions > Rename Page..". Update the form fields with the following:

1. Name: template-blog-post-template
2. Title: Blog Post Template
3. Title Bar Caption: Blog Post Template

Landing Page Template

Navigate to the Landing Page template that was created from the installation. Rename the page to add "template" into the title for easy recognition.

On the page, open the dialog "Actions > Rename Page..". Update the form fields with the following:

1. Name: template-Blog-Landing-Template
2. Title: Blog Landing Template
3. Title Bar Caption: Blog Landing Template

Blog Manager

Navigate to the Blog Manager page. Edit each blog record to assign a value into the "notificationFrom" field. If no value is assigned, then the CommonSpot site administrator email will be used as the from address for notification emails.

After modifying the template names above, please edit and review the settings for the for the "Edit App Configuration" form fields for the template select are correct. Additionally, edit and review the blog records to make sure the "Blog Post Template" select field has the correct template selected.

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.

Reset the ADF

Reset the ADF for the server and site.