Difference between revisions of "PT Blogs Feature Tags"

From ADF Docs
Jump to: navigation, search
(→‎Tags Listing Page)
(→‎Tags Listing Template)
 
(6 intermediate revisions by the same user not shown)
Line 6: Line 6:
 
Follow the steps below to integrate the PT Tags into blog posts.
 
Follow the steps below to integrate the PT Tags into blog posts.
  
−
== Steps ==  
+
== Install PT Tags ==  
−
# 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.
 
 
# Install the PT Tags application on the site.  Follow the steps for the [http://community.paperthin.com/projects/pt_tags/docs/Version-1-Install.cfm installation].
 
# Install the PT Tags application on the site.  Follow the steps for the [http://community.paperthin.com/projects/pt_tags/docs/Version-1-Install.cfm installation].
−
# In the "Posts2" custom element, modify the "Tags" field to use the custom field type "Blog Tags Autocomplete".
 
−
## 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.
 
−
# 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.
 
  
 +
== Tags Listing Template ==
 
# Create a new page with the name "Blog Tags" from the "Blog Post" template.
 
# 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.
 
# Place the ''Tags'' Custom Element on this page.
 
# Click ''Render Mode'' in the element interface.
 
# Click ''Render Mode'' in the element interface.
−
# Select ''Display existing element data (content reuse)'' on the ''Rendering Mode'' tab.
+
## Select ''Display existing element data (content reuse)'' on the ''Rendering Mode'' tab.
−
# Select the ''Filter'' tab.  
+
## Select the ''Filter'' tab.  
−
# Select Filter Type to ''Show subset of records''.
+
### Select Filter Type to ''Show subset of records''.
−
# Select the field drop-down as the ''contentID'' field.  
+
### Select the field drop-down as the ''contentID'' field.  
−
# Select the operator as ''Equals''.
+
### Select the operator as ''Equals''.
−
# Click the '...' button to open the ColdFusion expression window.
+
### 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''.
+
### Enter the text ''request.page.metadata.blogs2.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 Sort Order field to ''Tags'' and Ascending.
+
### Select the ''Add Criteria'' drop-down and select ''AND''.
−
# Click ''OK'' on the render mode window.
+
### Select the field drop-down as the ''Active'' field.
−
## Ignore the error message for 'Error: Error evaluating a user-defined expresssion'.
+
### Select the operator as ''Equals''.
−
# 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.)
+
### Select "1" from the drop-down for Value.
−
# Click the element interface, and then ''more'' and select ''custom render handlers...''.
+
### Select the Sort Order field to ''Tags'' and Ascending.
−
# Select the ''Blog Listing'' render handler from the list.
+
## 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 ''Blog Listing'' Render Handler. (You may see an error on this page with the Render Handler.  That is OK at this point.)
 
# Submit Page and then Save as Template.
 
# Submit Page and then Save as Template.
 
# Remember to submit the template for public use.
 
# 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.
+
 
 +
== Blog Updates ==
 +
# In the "Posts2" custom element, modify the "Tags" field to use the custom field type "Blog Tags Autocomplete".
 +
## 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.
 
# 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.

Latest revision as of 15:55, 6 February 2012

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.

Install PT Tags

  1. Install the PT Tags application on the site. Follow the steps for the installation.

Tags Listing Template

  1. Create a new page with the name "Blog Tags" from the "Blog Post" template.
  2. Delete the Posts2 custom element from the page.
  3. Place the Tags Custom Element on this page.
  4. Click Render Mode in the element interface.
    1. Select Display existing element data (content reuse) on the Rendering Mode tab.
    2. Select the Filter tab.
      1. Select Filter Type to Show subset of records.
      2. Select the field drop-down as the contentID field.
      3. Select the operator as Equals.
      4. Click the '...' button to open the ColdFusion expression window.
      5. Enter the text request.page.metadata.blogs2.blogID as the expression and check the force cache checkbox. Click OK and then check the box to Ignore ColdFusion error, then click OK.
      6. Select the Add Criteria drop-down and select AND.
      7. Select the field drop-down as the Active field.
      8. Select the operator as Equals.
      9. Select "1" from the drop-down for Value.
      10. Select the Sort Order field to Tags and Ascending.
    3. Click OK on the render mode window.
  5. Ignore the error message for 'Error: Error evaluating a user-defined expresssion'.
  6. Click More in the element interface. Then the Custom Render Handlers menu option, and choose the Blog Listing Render Handler. (You may see an error on this page with the Render Handler. That is OK at this point.)
  7. Submit Page and then Save as Template.
  8. Remember to submit the template for public use.

Blog Updates

  1. 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.
  2. 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.
  3. On the "Blogs Manager" page, select the link for "Reset Site ADF" to have the updates take effect.
Retrieved from "http://community.paperthin.com/adf-docs/index.php?title=PT_Blogs_Feature_Tags&oldid=5488"