README

Inspeya Jobs Manager extension for Hyvä Theme enables you to seamlessly integrate a comprehensive job board into your eCommerce store. This powerful extension allows you to efficiently manage the entire hiring process by creating and posting various types of job listings, categorized by type, location, department, and tags. Enhance your website's functionality by allowing potential candidates to discover and apply for positions directly through your store, streamlining your talent acquisition process.

The Jobs Manager extension is designed to be a robust solution for businesses looking to expand their team and find the right talent using their eCommerce platform. With this extension, you can create a dedicated job managers section on your website, making it easier for job seekers to find and apply for open positions. Administrators can manage all aspects of job listings, including the creation of job types, departments, multiple companies, locations, and tags, all from the Magento backend.

This extension not only simplifies the process of posting and managing job listings but also ensures that your job board is fully integrated with your existing website design and functionality. The intuitive backend interface allows administrators to quickly update job postings, review applications, and manage applicant data. Additionally, automated email notifications keep both applicants and administrators informed throughout the hiring process.

Furthermore, this module is specifically designed for seamless integration with the Hyvä theme, ensuring a modern, fast, and visually appealing frontend experience for your job board. The Hyvä theme enhances the overall performance and user experience, making it an ideal choice for Magento 2 stores.

Features

• Comprehensive Job Listings: Create and manage multiple job listings with detailed descriptions.
• Customizable Categories: Categorize jobs by type (full-time, part-time, freelance), location, department, and tags.
• Direct Applications: Allow candidates to apply directly through your website, simplifying the application process.
• Easy Management: Easily update and maintain job listings to ensure current openings are accurately represented.
• JobManager Section: Enhance your eCommerce site by adding a dedicated job manager section, attracting high-quality talent.
• Job Types and Departments: Admins can create and manage various job types and departments from the backend.
• Job Tags: Add and manage tags for job listings to improve searchability and organization.
• Multiple Companies and Locations: Support for creating and managing multiple companies and their respective locations.
• User-Friendly Backend Interface: Manage all aspects of job listings, types, departments, companies, locations, and tags through an intuitive backend interface.
• Email Notifications: Automatically send email notifications to applicants and administrators upon job application submissions.
• SEO Friendly: Ensure job listings are SEO optimized to attract more candidates through search engines.
• Application Tracking: Track the status of applications and manage the hiring process efficiently.
• Responsive Design: Job listings and application forms are fully responsive, ensuring a seamless experience across all devices.
• Customizable Templates: Use customizable templates to match the job board's appearance with your store’s theme.
• Role-Based Access Control: Define user roles and permissions for managing job postings and applications.
• Hyvä Theme Compatibility: Fully compatible with the Hyvä theme, providing a fast and modern frontend experience.

Installation

Installation via Composer (Recommended)

1. Require the package via Composer:

   composer require mhinspeya/job-manager-hyva
   

2. Enable the module and compile:

   bin/magento module:enable MHinspeya_JobManager
   bin/magento setup:upgrade
   bin/magento setup:di:compile
   bin/magento setup:static-content:deploy
   bin/magento cache:clean
   

Manual Installation

If you are installing the module manually (by copying files to app/code/MHinspeya/JobManager):

1. Enable the module:

   bin/magento module:enable MHinspeya_JobManager
   

2. Run setup upgrade & compile:

   bin/magento setup:upgrade
   bin/magento setup:di:compile
   

3. Deploy static view files:

   bin/magento setup:static-content:deploy
   

4. Clear the cache:

   bin/magento cache:clean
   bin/magento cache:flush
   

Configuration & Frontend Access

The module comes with a custom router that maps a SEO-friendly custom URL directly to the Jobs Manager frontend board.

System Configuration

1. In the Magento Admin Panel, navigate to Stores > Configuration > Inspeya Extensions > Job Manager.
2. Enable Job Manager: Toggle this setting to Yes to activate the frontend job board.
3. Custom URL: Enter your desired custom URL key for the job board (e.g., karriere.html or jobs).
   • Default Fallback: If left empty, the module defaults to karriere.html.

Testing & Verifying Functionality on the Frontend

Once the module is configured and enabled, you can verify the functionality using the following URLs:

1. Main Job Board / Search Page:

   • Access the board using your configured URL key, e.g., http://<your-magento-domain>/karriere (or whatever key you specified in the configuration).
   • Alternatively, you can access the direct path: http://<your-magento-domain>/job/index/newsearch
   • On this page, candidates can search and filter job openings by company, department, and location.

2. Job Detail Page:

   • Clicking on any job listing redirects the user to the job detail page: http://<your-magento-domain>/job/index/jobdetail?jobid=<job_id>
   • This displays the job description, required skills, and other details.

3. Job Application Form:

   • Clicking the Apply button on the details page opens the multi-step application form: http://<your-magento-domain>/job/index/applyjob?jobid=<job_id>
   • Applicants can fill in their contact information, answer job-specific questions, and upload their CV/documents.

4. Customer Account Portal (Applied Jobs):

   • Logged-in customers can track their job applications by navigating to: http://<your-magento-domain>/job/customer/appliedjobs/

Usage in Admin Panel

Creating Job Listings

1. Navigate to the Magento admin panel.
2. Go to Inspeya > Job Manager Configuration > Create jobs > Add New Job.
3. Fill in the job details, including title, description, type, location, department, and tags.
4. Save the job listing.

Managing Job Listings

1. Navigate to the Magento admin panel.
2. Go to Inspeya > Job Manager Configuration > Create jobs.
3. Edit or delete existing job listings as necessary.

Managing Questions (Add, Import, and Select for Particular Jobs)

A. Add a New Question manually:

1. Navigate to Inspeya > Job Manager Configuration > Ask Questions.
2. Click Add New Question.
3. Fill in the Question title and options (Option 1 to Option 5).
4. Save the question.

B. Import Questions in Bulk:

1. Navigate to Inspeya > Job Manager Configuration > Ask Questions.
2. Click Import Questions (redirects to the CSV Upload page).
3. Click Download Sample CSV to get the correct import template.
4. Populate your CSV file following the template structure (Columns: Question, Option 1, Option 2, Option 3, Option 4, Option 5, Sorting).
5. Choose the CSV file and click Import to load the questions.

C. Select / Assign Questions to Particular Jobs:

1. Navigate to Inspeya > Job Manager Configuration > Create jobs.
2. Edit an existing job or click Add New Job.
3. In the left-hand menu of the job edit form, open the Questions tab.
4. Check/tick the specific questions you want to assign to this job.
5. Provide a sorting position in the Position field next to each selected question.
6. Click Save to apply. The assigned questions will automatically render on the frontend application form for that job.

Managing Companies and Locations

1. Navigate to the Magento admin panel.
2. Go to Jobs Manager > Companies or Jobs Manager > Locations.
3. Add and manage multiple companies and their respective locations.

Support

For any issues or support requests, please contact us at support@inspeya.com.

License

This project is licensed under the OSL-3.0 License - see the LICENSE file for details.

Developed by Inspeya

Visit us at inspeya.com