PT Blog Version 2.1 Upgrade

From ADF Docs
Jump to: navigation, search

Overview

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

Application Code

  1. Rename directory "/ADF/apps/pt_blog" to "/ADF/apps/pt_blog_v2_0".
  2. Rename file "/ADF/apps/pt_blog_v2_0/appBeanConfig.cfm" to "/ADF/apps/pt_blog_v2_0/appBeanConfig.cfm.old".
  3. Download the PT Blog v2.1 and exported into the "/ADF/apps/pt_blog/" directory.

Custom Element Updates

PTBlog2 Configuration

Create the following new tabs:

  1. Features:
    1. Display Name: Features
    2. Sort Name: 2-features
  2. Tags Feature:
    1. Display Name: Tags Feature
    2. Sort Name: 3-tags-feature
  3. Update the first have "Sort Name" = "1-blog-configuration" to fix the tab in the first position.

Add the following new fields:

  1. Name: blogIndexTemplate
    1. In the "Features" tab
    2. Type: Template Select
    3. Label: Create Blog Landing Page Template
    4. Description: Select the template for the blog landing page to be created. The auto create for the blog landing is enabled/disabled at the blog level.
  2. Name: enableSubsiteDate
    1. In the "Features" tab
    2. Type: Selection List
      1. Option Source List = Value List
      2. Option List = True,False
      3. Default Value = True
    3. Label: Enable Date Subsite
    4. Description: Check the box to enable the blog subsite path to build date subsites based on the blog post date. If checked, enter the subsite date format mask in the text field below.
  3. Name: dateSubsiteFormat
    1. In the "Features" tab
    2. Type: Text
      1. Size = 40
      2. Default Value = YYYY
    3. Label: Date Subsite Format
    4. Description: Enter the date format mask for the subsite path for the blogs. For example, the text "YYYY" will create the subsite path "/myBlog/2011/". The text "YYYY/MM" will create the subsite path "/myBlog/2011/02/".
  4. Name: tagsIntegrated
    1. In the "Tags Feature" tab
    2. Type: Selection List
      1. Option Source List = Value List
      2. Option List = True,False
      3. Default Value = False
    3. Label: PT Tags Integrated
    4. Description: Select True/False for if the PT Tags has been integrated into the blog posts for the tags field.
  5. Name: tagsPageTemplate
    1. In the "Tags Feature" tab
    2. Type: Template Select
    3. Label: Tags Listing Page Template
    4. Description: Select the template for the blog tags listing page to be created from. The auto create for the blog tag listing page is enabled/disabled at the blog level.

Blog2

Create the following new tabs:

  1. Landing Page:
    1. Display Name: Landing Page
    2. Sort Name: 2-landing-page
  2. Tags:
    1. Display Name: Tags
    2. Sort Name: 3-tags
  3. Notifications:
    1. Display Name: Notifications
    2. Sort Name: 4-notifications
  4. Update the first have "Sort Name" = "1-blog2" to fix the tab in the first position.

Add the following new fields:

  1. Name: SubsiteURL
    1. In the "Blog2" tab.
    2. Type: Text
      1. Maximum Length = 255
      2. Size = 40
    3. Label: Subsite URL
    4. Description: Enter the subsite path for the blog post pages (and landing or tags listing pages) to be created in.
      Example: "/mysite/blogs/" or "/mysite/my-blog/"
    5. Move the field to under the "name" field.
    6. Important Note: This field is going to replace the 'subsite' field that currently exists. The steps below will walk through this update.
  2. Name: autoLandingPage
    1. In the "Landing Page" tab
    2. Type: Selection List
      1. Option Source List = Value List
      2. Option List = True,False
      3. Default Value = True
    3. Label: Create Landing Page
    4. Description: Enable or disable the landing page from being auto generated.
  3. Name: landingPageName
    1. In the "Landing Page" tab
    2. Type: Text
      1. Default Value = index
      2. Size = 40
    3. Label: Landing Page Name
    4. Description: If Create Landing Page is enabled, enter the page name for the landing page to be created.
  4. Name: rssFeed
    1. In the "Landing Page" tab
    2. Type: Selection List
      1. Option Source List = Value List
      2. Option List = True,False
      3. Default Value = True
    3. Label: Display RSS Feed
    4. Description: Select the option to enable/disable the RSS feed icon to display on the blog landing page.
  5. Name: autoTagsPage
    1. In the "Tags" tab
    2. Type: Selection List
      1. Option Source List = Value List
      2. Option List = True,False
      3. Default Value = True
    3. Label: Create Tags Listing Page
    4. Description: Enable or disable the tags listing page from being auto generated.
  6. Name: tagsPageName
    1. In the "Tags" tab
    2. Type: Text
      1. Default Value = tags
      2. Size = 40
    3. Label: Tags Listing Page Name
    4. Description: If Create Tags Listing Page is enabled, enter the page name for the tags listing page to be created.
  7. Name: notificationGroups
    1. In the "Notifications" tab
    2. Type: General Chooser
      1. Chooser Bean Name: blogsUserGroupsGC
    3. Label: Groups

New Features

  1. Import the "Blog2 Feature Data" custom element.
  2. Follow the V2.1 install guide to build the following templates and pages:
    1. Templates > Landing Page Template
    2. Create Blog Feature Data Management Page

Updates

  1. Metadata Form:
    1. 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.
    2. Update the Blog Post template render mode filter expression with "request.page.metadata.blogs2" metadata form.
    3. Update the Blog Post Landing Page and Tags Listing templates if they are created.
  2. CCAPI
    1. 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.
    2. 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.
  3. Blog Manager Page
    1. The new blog manager page has removed the "dashboard" link to an icon along side the edit and delete icons.
    2. Follow the following steps to update the datasheet:
      1. Edit datasheet columns
      2. On the second column (blogID), change the render handler to:
        1. /ADF/apps/pt_blog/datasheet-modules/blog_edit_delete.cfm
      3. On the first column, rename the header to "blogTemplate", and then delete the column from the datasheet.
    3. The datasheet will now show 3 icons in the first column of the datasheet. The 3rd icon will open to the blog dashboard.
  4. Blog Subsite Field
    1. 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.
      1. 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.
      2. 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.