This plugin requires two main steps: configuring the element and setting up the mandatory cleanup workflow.
Step 1: Configuring the Detector Element

Place the Element: Drag the "Idle Detector" element onto any page or reusable element where you want to monitor inactivity. It is an invisible element.

Define the Inactivity Threshold: In the properties panel for the element, set the following field:

Idle Time (ms): Input the number of milliseconds of inactivity required before the trigger event fires (e.g., use 300000 for 5 minutes). This is a mandatory field.

Create the Workflow:

Go to the Workflow tab.

Create a new event: "Elements" > "An element fires a custom event".

Select your Idle Detector element and choose the event "user_became_idle".

Add the actions you want to run (e.g., Log the user out, display a warning pop-up, pause an application process).

Step 2: Critical Cleanup Workflow (Mandatory to Prevent Memory Leaks)

Because this plugin creates a global timer and attaches multiple global activity listeners, you must call the dedicated cleanup action when the page unloads or the element is hidden. Failing to implement this step will lead to performance degradation and memory leaks.

Create the Cleanup Action: Ensure your plugin contains the necessary Client-side Action, typically named "Stop Idle Detector", which is responsible for safely clearing the global timers and listeners.

Implement the Mandatory Cleanup Workflow: On every page that contains the Idle Detector element, you must run the "Stop Idle Detector" Action when the page is closed or navigation occurs. The recommended method is:

Go to the Workflow tab for the page.

Create a new event: "General" > "Page is loaded".

Add an action: "Plugins" > Stop Idle Detector.

Note: Treat the "Stop Idle Detector" action as a mandatory part of setting up this element to ensure application health and speed.