Appearance

Jobs Module ​

The Jobs module allows you to create job postings, manage applications, and track applicants. This comprehensive guide covers all job board and recruitment features.

Table of Contents ​

  1. Overview
  2. Accessing Jobs
  3. Creating a Job
  4. Job Categories
  5. Managing Jobs
  6. Job Applications
  7. Application Management
  8. Frontend Job Board
  9. Best Practices

Overview ​

Features ​

  • ✅ Create and manage job postings
  • ✅ Job categories
  • ✅ Application management
  • ✅ Resume/CV uploads
  • ✅ Application status tracking
  • ✅ Applicant communication
  • ✅ Featured jobs
  • ✅ Job expiration dates
  • ✅ Frontend job board
  • ✅ Application filtering

Admin Routes ​

  • Job List: /admin/jobs
  • Create Job: /admin/jobs/create
  • Edit Job: /admin/jobs/{id}/edit
  • Applications: /admin/jobs/applications or /admin/job-applications

Frontend Routes ​

  • Jobs Page: /jobs
  • Job Detail: /jobs/{slug}
  • Apply: /jobs/apply

Accessing Jobs ​

From Admin Panel ​

  1. Log in to admin panel
  2. Navigate to Business → Jobs
  3. Or go directly to: /admin/jobs

Permissions Required ​

  • View Jobs: view jobs permission
  • Create Jobs: create jobs permission
  • Edit Jobs: edit jobs permission
  • Delete Jobs: delete jobs permission
  • Manage Jobs: manage jobs permission

Creating a Job ​

Step 1: Access Create Page ​

  1. Go to Jobs → Create New Job
  2. Or navigate to: /admin/jobs/create

Step 2: Basic Information ​

Job Title ​

  • Position title
  • Required field
  • Be specific and clear
  • Example: Senior Web Developer

Slug ​

  • Auto-generated from title
  • Can be edited manually
  • Must be unique
  • Used in job URL
  • Example: senior-web-developer

Short Description ​

  • Brief job summary
  • Shown in job listings
  • Recommended: 100-200 characters
  • Example: Join our team as a Senior Web Developer

Step 3: Job Details ​

Full Description ​

Use rich text editor for detailed job description:

Include:

  • About the Role: What the job entails
  • Responsibilities: Key duties
  • Requirements: Qualifications needed
  • Benefits: Compensation and perks
  • Company Culture: Work environment
  • Application Process: How to apply

Job Requirements ​

Required Skills:

  • List technical skills
  • List soft skills
  • Experience level
  • Education requirements

Nice to Have:

  • Preferred qualifications
  • Additional skills
  • Certifications

Step 4: Job Information ​

Job Type ​

Options:

  • Full-time: Full-time employment
  • Part-time: Part-time employment
  • Contract: Contract position
  • Temporary: Temporary position
  • Internship: Internship opportunity
  • Freelance: Freelance work

Location ​

Options:

  • Remote: Work from anywhere
  • On-site: Office location
  • Hybrid: Mix of remote and office
  • Multiple Locations: Various locations

Location Details:

  • City, State/Province
  • Country
  • Address (if on-site)
  • Time zone (if remote)

Salary Information ​

Options:

  • Salary Range: Min - Max
  • Hourly Rate: For hourly positions
  • Negotiable: Salary negotiable
  • Not Disclosed: Keep private

Example:

  • $60,000 - $80,000 per year
  • $30 - $40 per hour

Application Deadline ​

  • Set closing date
  • Applications close automatically
  • Can extend deadline
  • Optional field

Step 5: Additional Settings ​

Status ​

  • Published: Visible on job board
  • Draft: Saved but not published
  • Closed: No longer accepting applications
  • Archived: Hidden from listings
  • Toggle: Mark as featured
  • Featured jobs highlighted
  • Shown prominently
  • Use for priority positions

Application Settings ​

Application Method:

  • Online Form: Use built-in form
  • Email: Apply via email
  • External URL: Link to external application
  • Multiple Methods: Allow different options

Required Documents:

  • Resume/CV (always required)
  • Cover Letter (optional)
  • Portfolio (optional)
  • References (optional)

Step 6: SEO Settings ​

Meta Information ​

  • Meta Title: Search engine title
  • Meta Description: Search result description
  • Keywords: Relevant keywords

Step 7: Save Job ​

  • Save Draft: Save without publishing
  • Publish: Make job live
  • Toggle Status: Quick status change
  • Toggle Featured: Quick featured toggle

Job Categories ​

Creating Categories ​

  1. Go to Jobs → Categories
  2. Click Create New Category
  3. Enter:
    • Name: Category name
    • Slug: URL-friendly version
    • Description: Category description
  4. Click Save

Common Categories ​

  • Technology: IT and tech jobs
  • Marketing: Marketing positions
  • Sales: Sales roles
  • Design: Design positions
  • Management: Leadership roles
  • Operations: Operations jobs
  • Customer Service: Support roles

Managing Jobs ​

Job List View ​

Access at: /admin/jobs

List Features ​

Search:

  • Search by title
  • Search by description
  • Search by location
  • Real-time results

Filters:

  • Category: Filter by category
  • Status: Published/Draft/Closed
  • Featured: Featured/Not Featured
  • Job Type: Full-time/Part-time/etc.
  • Location: Filter by location

Sorting:

  • By Title (A-Z, Z-A)
  • By Date (Newest/Oldest)
  • By Application Count
  • By Status

Displayed Information ​

  • Job Title: Position name
  • Category: Job category
  • Location: Job location
  • Type: Job type
  • Status: Published/Draft/Closed
  • Featured: Featured badge
  • Applications: Application count
  • Date: Posted date

Editing Jobs ​

  1. Click Edit on job
  2. Make changes
  3. Click Update
  4. Changes saved

Deleting Jobs ​

  1. Click Delete on job
  2. Confirm deletion
  3. Warning: Cannot be undone
  4. Job removed
  5. Applications preserved (for records)

Quick Actions ​

Toggle Status ​

Route: /admin/jobs/{job}/toggle-status

  1. Click Toggle Status button
  2. Status changes immediately
  3. Published ↔ Draft

Route: /admin/jobs/{job}/toggle-featured

  1. Click Toggle Featured button
  2. Featured status changes
  3. Instant update

Bulk Operations ​

Bulk Delete ​

  1. Select multiple jobs
  2. Click Bulk Actions → Delete
  3. Confirm deletion
  4. All selected jobs deleted

Job Applications ​

Viewing Applications ​

Route: /admin/jobs/applications or /admin/job-applications

Features:

  • All applications across all jobs
  • Filter by job, status, date
  • Search functionality
  • Application statistics

Application Information ​

Displayed:

  • Applicant: Name and contact
  • Job: Position applied for
  • Date: Application date
  • Status: Application status
  • Resume: Resume file
  • Cover Letter: Cover letter text

Application Details ​

Route: /admin/jobs/applications/{application} or /admin/job-applications/{application}

Includes:

  • Applicant information
  • Contact details
  • Resume/CV download
  • Cover letter
  • Application answers (if custom form)
  • Status history
  • Notes

Application Management ​

Application Status ​

Status Options ​

  • Pending: New application, not reviewed
  • Under Review: Being evaluated
  • Shortlisted: Selected for next round
  • Interview Scheduled: Interview arranged
  • Accepted: Job offer extended
  • Rejected: Not selected
  • Withdrawn: Applicant withdrew

Updating Application Status ​

Route: /admin/jobs/applications/{application}/status or /admin/job-applications/{application}/update-status

  1. Open application
  2. Select new status
  3. Add notes (optional)
  4. Click Update
  5. Applicant notified (if enabled)

Downloading Resume ​

Route: /admin/jobs/applications/{application}/resume or /admin/job-applications/{application}/download-resume

  1. Click Download Resume
  2. Resume file downloads
  3. View applicant's CV
  4. File format: PDF, DOC, DOCX

Application Actions ​

View Application ​

  1. Click on application
  2. View full details
  3. Review resume
  4. Read cover letter

Update Status ​

  1. Select new status
  2. Add internal notes
  3. Save changes
  4. Status updated

Delete Application ​

  1. Click Delete
  2. Confirm deletion
  3. Application removed
  4. Resume file deleted

Frontend Job Board ​

Jobs Page ​

URL: /jobs

Features:

  • All published jobs
  • Category filtering
  • Job type filtering
  • Location filtering
  • Search functionality
  • Job cards showing:
    • Job title
    • Company/Organization
    • Location
    • Job type
    • Salary (if shown)
    • Posted date
    • Apply button

Job Detail Page ​

URL: /jobs/{slug}

Features:

  • Full job description
  • Job requirements
  • Salary information
  • Location details
  • Application form
  • Share buttons
  • Related jobs

Application Form ​

URL: /jobs/apply

Form Fields:

  • Personal Information:

    • First Name
    • Last Name
    • Email
    • Phone

  • Application Materials:

    • Resume/CV upload (required)
    • Cover Letter (optional)
    • Portfolio link (optional)

  • Additional Questions:

    • Custom questions (if configured)
    • Availability
    • Salary expectations

Submission Process:

  1. Fill out form
  2. Upload resume
  3. Submit application
  4. Receive confirmation
  5. Application number provided

Best Practices ​

Job Posting ​

  1. Clear Descriptions:

    • Be specific about role
    • List all requirements
    • Include salary range
    • Set expectations

  2. Attractive Listings:

    • Use compelling titles
    • Highlight benefits
    • Show company culture
    • Include growth opportunities

  3. Regular Updates:

    • Update job status
    • Close filled positions
    • Refresh listings
    • Remove expired jobs

Application Management ​

  1. Quick Response:

    • Acknowledge applications
    • Review promptly
    • Update status regularly
    • Communicate decisions

  2. Organized Process:

    • Use status workflow
    • Take notes on candidates
    • Track interview schedules
    • Document decisions

  3. Professional Communication:

    • Respond to all applicants
    • Provide feedback when possible
    • Be respectful
    • Maintain records

Troubleshooting ​

Job Not Displaying ​

Solutions:

  1. Check status (must be Published)
  2. Verify not past deadline
  3. Clear cache
  4. Check frontend settings

Applications Not Receiving ​

Solutions:

  1. Verify application form works
  2. Check email settings
  3. Verify file upload limits
  4. Check spam folder

Resume Not Downloading ​

Solutions:

  1. Verify file exists
  2. Check file permissions
  3. Verify file format supported
  4. Check download settings

Last Updated: [Date will be updated during final review]

Released under the MIT License.

Copyright © 2024 OmniSuite CMS