Recruitment

This module adds management for vacancies and candidates.

This module adds the following resources:

• Vacancies
• Candidates
• Job applications
• Recruitment emails

Installation

composer require qore/recruitment

Publish config, migration and frontend files:

php artisan qore:publish recruitment --all

Run migrations:

php artisan tenants:migrate

Dependencies

This module depends on the following modules:

• qore/address - General usage
• qore/ckeditor - Editor for vacancy content
• qore/contact-reports - To attach to candidates and job applications
• qore/glue - To glue to link to other resources
• qore/kanban - Job application kanban board
• qore/mailbox - Mailbox integration
• qore/openai - AI powered autofill
• qore/timeline - Candidate and job application timeline

These modules should be installed automatically when you install this package. Make sure you install, publish and migrate these modules as well.

Usage

Menu

To add the resources to your menu, go to GlobalsController and add:

app/Http/Controllers/Globals/GlobalsController.php

use function Qore\Recruitment\Helpers\recruitment;

if (module_is_active('qore/recruitment')) {
    $tab->addMenuGroup('Recruitment', function (MenuGroup $group) {
        $group->setIcon('groups');

        $group->addResourceMenuItem(resource('vacancies'));
        $group->addResourceMenuItem(resource('candidates'));
        $group->addResourceMenuItem(resource('job_applications'));

        if (recruitment()->mailbox()->isEnabled()) {
            $group->addResourceMenuItem(resource('recruitment_emails'));
        }
    });
}

General

The AI resume upload will only be enabled if:

• The Recruitment module is enabled
• The OpenAI plugin is enabled
• In the OpenAI plugin settings, Model and API Key are not empty
• In Recruitment settings, "Automatically fill fields when uploading resume" is enabled

The mailbox features will be enabled only if:

• The Recruitment module is enabled
• The Mailbox module is enabled
• A valid mailbox is set in the Recruitment settings

Settings

Tab	Setting	Type	Description
Vacancies	Pipelines	List of pipelines	Manage pipelines used for vacancies
Candidates	Insertion enabled	Checkbox	Whether the insertion field is used for candidates
Candidates	Name check	Percentage	Set the percentage threshold for when a candidate's name is considered equal to another
Candidates	Automatically fill fields when uploading resume	Checkbox	Whether to automatically fill fields using AI when uploading a resume
Job applications	Default mail template to use for rejecting	Mail template	Default selected mail template when rejecting a job application
AVG	AVG limit in days	Number	Default number of days to keep personal details
AVG	AVG expiration warning threshold in days	Number	Number of days before expiration date that is considered "soon"
Mailbox	Mailbox	Mailbox	Mailbox to use for receiving recruitment email

Integrations

Contact reports

You can attach contact reports to candidates and job applications. The contact reports module

Mailbox

The mailbox module is used to read emails and attach candidates and job applications to emails.

Upgrade Guide

To upgrade this module:

composer update qore/recruitment

If you need to upgrade migrations, config or Vue components:

php artisan qore:publish recruitment --config --force
php artisan qore:publish recruitment --migrations --force
php artisan qore:publish recruitment --frontend --force