Difference between revisions of "Calendar Events Mangement Pages-Deprecated"

Revision as of 16:10, 17 September 2025

Calendar Events - Deprecated

Manage Events Datasheet - Deprecated

The Calendar Event Details element is a global custom element. Managing data for global custom elements can be configured easily through the use of Datasheets. The following steps will describe how to configure the datasheet to manage the Calendar Events.

1. Create a new page called 'Manage Calendar Events' from the Base Plus One (or a Web Admin template) and in the /webadmin/calendar/ subsite.
2. In the main content container 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_calendar/customcf/manage_events_filtering_tools.cfm
5. Add another Custom Script element to the main content container of the page.
6. From the Custom Script element interface, click the "Edit" icon.
7. Enter the following text into the Explicit Module path:
   • /ADF/apps/pt_calendar/customcf/manage_calendar_event_details_header.cfm
8. From the Datasheet element interface, click the "Datasheet" icon.
9. From the "Datasheet Views" dialog, follow the "Click here to create a new datasheet view" link.
10. Enter the following information and then click "Next":
    1. Name: All Event Details View
    2. Private: unchecked
    3. Default View: checked
    4. Description: View to manage events
    5. Datasheet Source: Form Result/Custom Element Sheet
11. From the Datasheet Source dialog, choose the "Calendar Event Details" custom element and click "Next".
12. From the Datasheet Columns Dialog select the columns UniqueID, Title, EventDateTimeIDList, EventRecurrenceID, Category, Organization, EventApproved and ApprovalUserID from the Available Columns list and move them to the Selected Columns list and then click "Finish".
13. You will be brought to the Datasheet View page; click "Close" to return to your page.
14. You will see the datasheet element on this page now. Click the Datasheet element interface icon again and this time choose "Filter".
    1. Select the "Subset of records" filter type.
    2. Apply the following filter:
       1. Field = Calendar_Event_Details.uniqueID
       2. Operator = Value Contained In List
       3. Value = request.ptCalendar.eventManager.eventIDlist (note: use the UDE button)
    3. Click Finish or Save
15. You will see the datasheet element on this page now. Click the Datasheet element interface icon again and this time choose "Edit Columns".
16. Within the Datasheet View Column Properties dialog, choose the UniqueID 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_calendar/datasheet-modules/event-edit-delete-copy.cfm
    2. Click Finish or Save.
    3. In the Header field, switch the text to 'Edit/Delete/Copy'
    4. Click Finish or Save
17. Now, within the Datasheet View Column Properties dialog, choose the EventDateTimeIDList 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_calendar/datasheet-modules/convert-id-list-to-date-time-blocks.cfm
    2. Click Finish or Save.
    3. In the Header field, switch the text to 'Event Dates/Times'
    4. Click Finish or Save
18. Now, within the Datasheet View Column Properties dialog, choose the EventRecurrenceID 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_calendar/datasheet-modules/convert-id-list-to-recurrence-properties.cfm
    2. Click Finish or Save.
    3. In the Header field, switch the text to 'Recurrence Properties'
    4. Click Finish or Save
19. Now, within the Datasheet View Column Properties dialog, choose the Category 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_calendar/datasheet-modules/convert-id-list-to-cat-names-with-icons.cfm
    2. Click Finish or Save.
    3. In the Header field, switch the text to 'Categories'
    4. Click Finish or Save
20. Now, within the Datasheet View Column Properties dialo,g choose the Organization 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_calendar/datasheet-modules/convert-id-list-to-org-names.cfm
    2. Click Finish or Save.
    3. In the Header field, switch the text to 'Organizations'
    4. Click Finish or Save
21. Now, within the Datasheet View Column Properties dialo,g choose the EventApproved 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_calendar/datasheet-modules/convert-approval-status.cfm
    2. Click Finish or Save.
    3. In the Header field, switch the text to 'Approval Status'
    4. Click Finish or Save
22. Now, within the Datasheet View Column Properties dialog, choose the AppovalUserID 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/extensions/datasheet-modules/1.0/userID-to-name.cfm
    2. Click Finish or Save.
    3. In the Header field, switch the text to 'Approver'
    4. Click Finish or Save
    5. Click Finish or Save
23. Close the Edit Column window.
24. Go back to the Datasheet element interface, select the Layout button
    1. Default Sorting = EVENTS DATES AND TIMES Ascending
    2. Uncheck "Show Alphabet Characters for Filtering"
    3. Uncheck "Allow JavaScript data sorting"
    4. Click Save
25. Publish this page.

Manage Events Grid - Deprecated

The Calendar Event can also be managed using the Calendar Event Grid view. This is a custom management interface that does NOT use a datasheet. This view will be used to manage recurring events. The following steps will describe how to configure the custom scripts to manage the Calendar Events.

1. Create a new page called 'Manage Calendar Events Grid' from the Base Plus One (or a Web Admin template) and in the /webadmin/calendar/ subsite.
2. In the main content container 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_calendar/customcf/manage_events_filtering_tools.cfm
5. On the Parameters tab of the custom script element add following parameter:
   • editType=Grid        <---This is a very important
6. Click Save
7. Add another Custom Script element to the main content container of the page.
8. From the Custom Script element interface, click the "Edit" icon.
9. Enter the following text into the Explicit Module path:
   • /ADF/apps/pt_calendar/customcf/manage_calendar_events_month_grid.cfm
10. Click Save
11. Publish this page.

Manage Events Filtering Parameters (Optional)

The optional Filtering Tools custom script parameters can be used to create a Calendar Events management page that only displays Events from a specific Organization and/or Category, and also limits what filtering options are available.

• "OrganizationName" - Add a valid Organization Name to only show events for a specific organization
• "OrganizationID" - Add a valid OrganizationID to only show events for a specific organization
• "CategoryName" - Add a valid Category Name to only show events for a specific category
• "CategoryID" - Add a valid CategoryID to only show events for a specific category
• "hideOrganizationFilter" (true/false - default:false) -
• "hideCategoryFilter" (true/false - default:false) -
• "showAdvancedFilter" (true/false - default:true) -

Custom Script Parameters List Example (with Names only showing the Category filter):
organizationID=Athletics
categoryID=Soccer
hideOrganizationFilter=false
hideCategoryFilter=true
showAdvancedFilters=true

Custom Script Parameters Grid Example (with only a category ID and all the Advanced filters hidden):
editType=Grid
categoryID=DDD4997D-DEED-E699-7912617222570D25
showAdvancedFilters=false

Note: If an Organization parameter is used with a Category parameter, it must be a valid category for that specific organization

Manage Events Filtering Parameters (Optional)

The optional Filtering Tools custom script parameters can be used to create a Calendar Events management page that only displays Events from a specific Organization and/or Category, and also limits what filtering options are available.

• "OrganizationName" - Add a valid Organization Name to only show events for a specific organization
• "OrganizationID" - Add a valid OrganizationID to only show events for a specific organization
• "CategoryName" - Add a valid Category Name to only show events for a specific category
• "CategoryID" - Add a valid CategoryID to only show events for a specific category
• "hideOrganizationFilter" (true/false - default:false) -
• "hideCategoryFilter" (true/false - default:false) -
• "showAdvancedFilter" (true/false - default:true) -

Custom Script Parameters List Example (with Names only showing the Category filter):
organizationID=Athletics
categoryID=Soccer
hideOrganizationFilter=false
hideCategoryFilter=true
showAdvancedFilters=true

Custom Script Parameters Grid Example (with only a category ID and all the Advanced filters hidden):
editType=Grid
categoryID=DDD4997D-DEED-E699-7912617222570D25
showAdvancedFilters=false

Note: If an Organization parameter is used with a Category parameter, it must be a valid category for that specific organization