Difference between revisions of "PT Blogs Feature Tags"

From ADF Docs
Jump to: navigation, search
(Tags Listing Page)
Line 12: Line 12:
 
## If a "tags" field does not exists, you can add it into the "Posts2" custom element.
 
## If a "tags" field does not exists, you can add it into the "Posts2" custom element.
 
# Navigate to the "Blogs Manager" page and "Edit App Configuration" to open the configuration custom element form.  On the "Features" tab, set the "PT Tags Integrated" select field to "True" and submit the form.
 
# Navigate to the "Blogs Manager" page and "Edit App Configuration" to open the configuration custom element form.  On the "Features" tab, set the "PT Tags Integrated" select field to "True" and submit the form.
# On the "Blogs Manager" page, select the link for "Reset Site ADF" to have the updates take effect.
 
 
== Tags Listing Page ==
 
The following steps with setup the process to auto-create a tags listing page for the blog.  This feature allows the blog administrator to enable/disable the blog listing page from being created within the blog subsite and define the page name.
 
 
# Create a new page with the name "Blog Tags" from the "Blog Post" template.
 
# Delete the ''Posts2'' custom element from the page.
 
# Place the ''Tags'' Custom Element on this page.
 
# Click ''Render Mode'' in the element interface.
 
# Select ''Display existing element data (content reuse)'' on the ''Rendering Mode'' tab.
 
# Select the ''Filter'' tab.
 
# Select Filter Type to ''Show subset of records''.
 
# Select the field drop-down as the ''contentID'' field.
 
# Select the operator as ''Equals''.
 
# Click the '...' button to open the ColdFusion expression window.
 
# Enter the text ''request.page.metadata.blogs.blogID'' as the expression and check the ''force cache'' checkbox.  Click ''OK'' and then check the box to ''Ignore ColdFusion error'', then click ''OK''.
 
# Select the ''Add Criteria'' drop-down and select ''AND''.
 
# Select the field drop-down as the ''Active'' field.
 
# Select the operator as ''Equals''.
 
# Select "1" from the drop-down for Value.
 
# Select the Sort Order field to ''Tags'' and Ascending.
 
# Click ''OK'' on the render mode window.
 
## Ignore the error message for 'Error: Error evaluating a user-defined expresssion'.
 
# Click ''More'' in the element interface.  Then the ''Custom Render Handlers'' menu option, and choose the ''Main Display'' Render Handler. (You may see an error on this page with the Render Handler.  That is OK at this point.)
 
# Click the element interface, and then ''more'' and select ''custom render handlers...''.
 
# Select the ''Blog Listing'' render handler from the list.
 
# Submit Page and then Save as Template.
 
# Remember to submit the template for public use.
 
# Navigate to the "Blogs Manager" page and "Edit App Configuration" to open the configuration custom element form. On the "Features" tab, set the "Tags Listing Page Template" field to the template that was created and submit the form.
 
 
# On the "Blogs Manager" page, select the link for "Reset Site ADF" to have the updates take effect.
 
# On the "Blogs Manager" page, select the link for "Reset Site ADF" to have the updates take effect.

Revision as of 19:37, 25 November 2011

Overview

PT Tags has been integrated into the PT Blogs application to allow blog contributors to build a collection of user defined tags, or keywords, to associate to the blog post.

Tags are associated to a specific blog instance. This means that only the blog posts within the blog can share tags. The tags are not shared globally for all the blogs.

Follow the steps below to integrate the PT Tags into blog posts.

Steps

  1. Verify that the "ptBlog2 Configuration" custom element has been updated to contain the "PT Tags Integrated" field. If not updated, then follow the v2.1 upgrade guide to upgrade the custom elements.
  2. Install the PT Tags application on the site. Follow the steps for the installation.
  3. In the "Posts2" custom element, modify the "Tags" field to use the custom field type "Blog Tags Autocomplete".
    1. If a "tags" field does not exists, you can add it into the "Posts2" custom element.
  4. Navigate to the "Blogs Manager" page and "Edit App Configuration" to open the configuration custom element form. On the "Features" tab, set the "PT Tags Integrated" select field to "True" and submit the form.
  5. On the "Blogs Manager" page, select the link for "Reset Site ADF" to have the updates take effect.