Difference between revisions of "PT Forums Manage User Settings"

From ADF Docs
Jump to: navigation, search
(Created page with '== 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 fo…')
 
 
(15 intermediate revisions by 2 users not shown)
Line 1: Line 1:
 +
Back to [[PT Forums Build Templates Pages|Build Templates/Pages]]
 +
 
== Overview ==
 
== 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.
 
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.
Line 6: Line 8:
 
#In the main content of the page, add a Custom Script element.
 
#In the main content of the page, add a Custom Script element.
 
#From the Custom Script element interface, click the "Edit" icon.
 
#From the Custom Script element interface, click the "Edit" icon.
#Enter the following text into the Explicit Module path: /ADF/apps/pt_forums/customcf/manage_usersettings_header.cfm
+
#Enter the following text into the Explicit Module path: /ADF/apps/pt_forum/customcf/manage_usersettings_header.cfm
 
# From the Datasheet element interface, click the "Datasheet" icon.
 
# From the Datasheet element interface, click the "Datasheet" icon.
 
# From the "Datasheet Views" dialog, follow the "Click here to create a new datasheet view" link.
 
# From the "Datasheet Views" dialog, follow the "Click here to create a new datasheet view" link.
Line 16: Line 18:
 
## Datasheet Source: Form Result/Custom Element Sheet
 
## Datasheet Source: Form Result/Custom Element Sheet
 
# From the Datasheet Source dialog choose the "Forum User Settings" custom element and click "Next".
 
# From the Datasheet Source dialog choose the "Forum User Settings" custom element and click "Next".
# From the Datasheet Columns Dialog select the columns userSettingsID, profileID and Messages from the Available Columns list and move them to the Selected Columns list and then click "Finish".
+
# 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".
 
# You will be brought to the Datasheet View page; click "Close" to return to your page.
 
# You will be brought to the Datasheet View page; click "Close" to return to your page.
 
# You will see the datasheet element on this page now. Click the Datasheet element interface icon again and this time choose "Edit Columns".
 
# You will see the datasheet element on this page now. Click the Datasheet element interface icon again and this time choose "Edit Columns".
Line 27: Line 29:
 
## Modules: edit-form-data.cfm
 
## Modules: edit-form-data.cfm
 
# From the Datasheet View Column Properties dialog, choose the link for "Add a new action column" again.
 
# From the Datasheet View Column Properties dialog, choose the link for "Add a new action column" again.
# Within the Action Column Properties dialog enter the following information and click "Finish":
+
# Within the Action Column Properties dialog enter the following information: :
 
## Header: Delete
 
## Header: Delete
 
## Hide Header: Checked
 
## Hide Header: Checked
Line 33: Line 35:
 
## Window Target Name: <leave blank>
 
## Window Target Name: <leave blank>
 
## Modules: delete-form-data.cfm
 
## Modules: delete-form-data.cfm
 +
## Click Finish.
 +
# Within the Datasheet View Column Properties dialog choose the PROFILEID column and click "edit":
 +
##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
 +
## Click Finish.
 +
## In the Header field, switch the text to 'User Name'
 +
## Click Finish
 
# Close the Edit Column window.
 
# Close the Edit Column window.
 +
# Now go back to the datasheet element. Click on the Layout icon
 +
## Uncheck "Allow JavaScript data sorting"
 +
## Click save
 
# Publish this page.
 
# 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
 +
#Copy the 'after--login.cfm' file from the ''/ADF/apps/pt_forum/site-files/'' folder  into the root of your site .
 +
#Restart Coldfusion
 +
 +
*If you currently have an 'after--login.cfm' file 
 +
#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.
 +
#Restarting Coldfusion should not be needed.
 +
  
 
[[Category:Forums]]
 
[[Category:Forums]]

Latest revision as of 19:33, 7 September 2010

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.