Custom Right-Click Calendar Context Menu

Resource Planner allows administrators to customize the right-click context menu displayed within the Resource Planner calendar. This menu provides quick access to actions that can be performed on a calendar entry or an empty calendar space. Custom menu items can be added to support organization-specific requirements.

Adding a Custom Context Menu Item

To add a custom right-click menu option:

1. Navigate to Administration → Advanced Customization → System Menus.

2. Locate and open the RP_CustContextMenu menu.

3. Add the required menu item.

4. Set the action to Custom File.

5. Specify the callback function that will handle the custom action.

For the custom menu item to function correctly, it must be linked to the RP_CustContextMenuCallbacks.js file. The corresponding JavaScript function must also be implemented within this file to execute the required action when the menu item is selected.

Example

The documentation includes an example where a custom menu item named Hello World is created.

In this example:

• The menu item is named Hello World.

• The action type is set to Custom File.

• The custom file is specified as helloworld.

• A corresponding function is implemented in RP_CustContextMenuCallbacks.js to handle the menu action.

This approach allows developers to extend the Resource Planner calendar by adding custom actions that integrate with their organization's business processes.

Custom Right-Click Functions – RP_CustContextMenuCallbacks.js

All custom functions used by the Resource Planner right-click context menu must be defined in the RP_CustContextMenuCallbacks.js file.

This file is located in:

/CustomPages/Enbu/ResourcePlanner

Each custom menu item created in RP_CustContextMenu must have a corresponding JavaScript function with the same name defined in this file. When the menu item is selected, the associated function is executed.

Example

In the previous section, a custom context menu item named Hello World was created with the custom file name helloworld.

To implement this menu item:

1. Open the RP_CustContextMenuCallbacks.js file.

2. Create a function named helloworld.

3. Add the required JavaScript logic inside the function.

In the example provided, a simple JavaScript alert statement is used to display a message when the menu item is selected.

Testing the Custom Function

After saving the JavaScript function:

1. Open the Resource Planner.

2. Right-click anywhere within the Resource Planner grid.

3. Select the Hello World menu option.

If the function has been implemented correctly, the configured JavaScript alert message is displayed, confirming that the custom context menu item is working successfully.