1

hiring

Unstable Kitsune edited this page 2025-09-24 00:32:19 -04:00

Table of Contents

• Hiring Cog
• 1. Features
• 2. User Workflow
• For the /hire Command:
• For the /work Command:
• 3. Admin Commands
• /hiringset

Hiring Cog

The Hiring cog is a specialized ticket system designed to streamline the application and hiring process for staff members. It provides a professional, form-based interface for applicants and a persistent, public-facing application button for ongoing recruitment.

---

1. Features

• Multi-Role Applications: A single /hire command provides distinct application paths for different roles (Staff, PM, HPM).
• Form-Based Submissions: Uses Discord Modals (pop-up forms) with custom fields to ensure all necessary information is collected from applicants.
• Automated Ticket Management: Automatically creates private ticket channels for each applicant and sorts them into pre-configured categories.
• Persistent Application Button: The /work command creates a persistent "Apply" button in a public channel for ongoing PM recruitment.
• DataManager Integration: Logs the timestamp of completed applications, making it compatible with the DataManager cog for automatic data purging.
• Hybrid Commands: All administrative commands work with both slash commands (/) and your bot's prefix ([p]).

---

2. User Workflow

For the /hire Command:

1. An administrator runs the /hire command in a channel.
2. The bot posts an embed with three buttons: "Staff," "PM," and "HPM."
3. A user clicks the button corresponding to the role they are applying for.
4. The bot instantly creates a new private channel for that user in the appropriate category.
5. The bot presents the user with a pop-up form (Modal) containing the specific questions for that role.
6. The user fills out the form and submits it.
7. The bot posts the user's formatted application into their private ticket channel for staff to review.

For the /work Command:

1. An administrator runs the /work command.
2. The bot posts a permanent message with an "Apply for PM Position" button to a designated public channel.
3. Any user can click this button at any time to begin the PM application process, which follows the same steps as the /hire workflow.

---

3. Admin Commands

/hiringset

The main command group for configuring the Hiring system. Requires Manage Server permissions.

Prefix Version: [p]hiringset or [p]hset

• /hiringset staffcategory <#category>
  • Sets the category where new Staff application tickets will be created.
• /hiringset pmcategory <#category>
  • Sets the category where new PM application tickets will be created.
• /hiringset hpmcategory <#category>
  • Sets the category where new HPM application tickets will be created.
• /hiringset workchannel <#channel>
  • Sets the public channel where the persistent "Apply" button from the /work command will be posted.