What is the LOA Plugin?

The LOA plugin helps manage leave of absence requests for your community. It allows staff to submit LOA requests, manage them, and track the status of leaves for other staff members.

LOA requests can be created with specified reasons and durations, and staff can view or manage the LOA statuses of others.

How do I configure the LOA Plugin?

To set up the LOA plugin, use the /config command to open the configuration panel. In the Select Plugin dropdown, choose Moderation Plugins and then select LOA Plugin. Click Enable.

Once enabled, you can configure the following:

  • LOA Channel — the channel where LOA requests will be posted.
  • LOA Role(s) — roles that are given when the staff member’s LOA request has been accepted.

Make sure to configure the LOA Channel and LOA Role(s) for full functionality of the LOA plugin.

Commands

loa create

Create a leave of absence request. This command allows users to specify the reason for their leave and the duration of the absence.

Command Parameters

reason
string
required

A description of why the user is requesting a leave.

end_date
string
required

The end date of the leave. You can use shorthand durations (e.g., 1d for one day, 1w for one week, 1m for one month).

loa manage

Manage an LOA request for a staff member. This command is available only to users with the configured Management Role(s).

Command Parameters

staff
user
required

Select the staff member whose LOA request you want to manage.

loa view

Command Parameters

staff
user
required

Select the staff member whose LOA status you want to view.