PT Blogs Feature Tags

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.

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.

1. Create a new page with the name "Blog Tags" from the "Blog Post" template.
2. Place the Tags Custom Element on this page.
3. Click Render Mode in the element interface.
4. Select Display existing element data (content reuse) on the Rendering Mode tab.
5. Select the Filter tab.
6. Select Filter Type to Show subset of records.
7. Select the field drop-down as the contentID field.
8. Select the operator as Equals.
9. Click the '...' button to open the ColdFusion expression window.
10. 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.
11. Select the Sort Order field to Tags and Ascending.
12. Click OK on the render mode window.
    1. Ignore the error message for 'Error: Error evaluating a user-defined expresssion'.
13. 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.)
14. Click the element interface, and then more and select custom render handlers....
15. Select the Blog Listing render handler from the list.
16. Submit Page and then Save as Template.
17. Remember to submit the template for public use.
18. 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.
19. On the "Blogs Manager" page, select the link for "Reset Site ADF" to have the updates take effect.