PT Forums Manage User Settings

Back to Build Templates/Pages

Overview

The Forum User Settings element is a global custom element. Managing data for global custom elements can be configured easily through the use of Datasheets. The following sections will describe how to configure the datasheet to manage the Forum User Settings element data.

Steps

1. Create a new page called 'Manage Forum User Settings' from the Base Plus One (or a Web Admin) template and in the /webadmin/forums/ subsite.
2. In the main content of the page, add a Custom Script element.
3. From the Custom Script element interface, click the "Edit" icon.
4. Enter the following text into the Explicit Module path: /ADF/apps/pt_forum/customcf/manage_usersettings_header.cfm
5. From the Datasheet element interface, click the "Datasheet" icon.
6. From the "Datasheet Views" dialog, follow the "Click here to create a new datasheet view" link.
7. Enter the following information and then click "Next":
   1. Name: Forum User Settings
   2. Private: unchecked
   3. Default View: unchecked
   4. Description: View to manage the Forum User Settings
   5. Datasheet Source: Form Result/Custom Element Sheet
8. From the Datasheet Source dialog choose the "Forum User Settings" custom element and click "Next".
9. From the Datasheet Columns Dialog select the columns userSettingsID, profileID and MessageQty from the Available Columns list and move them to the Selected Columns list and then click "Finish".
10. You will be brought to the Datasheet View page; click "Close" to return to your page.
11. You will see the datasheet element on this page now. Click the Datasheet element interface icon again and this time choose "Edit Columns".
12. From the Datasheet View Column Properties dialog choose the link for "Add a new action column" again.
13. Within the Action Column Properties dialog enter the following information and click "Finish":
    1. Header: Edit
    2. Hide Header: Checked
    3. Column Text: edit
    4. Window Target Name: <leave blank>
    5. Modules: edit-form-data.cfm
14. From the Datasheet View Column Properties dialog, choose the link for "Add a new action column" again.
15. Within the Action Column Properties dialog enter the following information: :
    1. Header: Delete
    2. Hide Header: Checked
    3. Column Text: delete
    4. Window Target Name: <leave blank>
    5. Modules: delete-form-data.cfm
    6. Click Finish.
16. Within the Datasheet View Column Properties dialog choose the PROFILEID column and click "edit":
    1. In the Render Handler field, select the Change button. Enter the following value into the Explicit Module text box: /ADF/apps/pt_forum/datasheet-modules/manage-convert-id-list-cs-usernames.cfm
    2. Click Finish.
    3. In the Header field, switch the text to 'User Name'
    4. Click Finish
17. Close the Edit Column window.
18. Now go back to the datasheet element. Click on the Layout icon
    1. Uncheck "Allow JavaScript data sorting"
    2. Click save
19. Publish this page.

Automatically adding a user to Forum User Settings

The Forum User Setting custom element is used to store forum specific user data (date joined, number of posts, etc.) An important aspect of this is making sure a user is added to this global custom element before they post a message. One way to achieve this is through the use of the CommonSpot 'after--login.cfm' hook to automatically add the user during the login process (if they don't already exist).

• If you do not currently have an 'after--login.cfm' file

1. Copy the 'after--login.cfm' file from the /ADF/apps/pt_forum/site-files/ folder into the root of your site .
2. Restart Coldfusion

• If you currently have an 'after--login.cfm' file

1. Copy and Paste the code from the 'after--login.cfm' file in the /ADF/apps/pt_forum/site-files/ folder into your current 'after--login.cfm' file on the root of your site.
2. Restarting Coldfusion should not be needed.