Integrating and sharing OrangeHRM vacancies in to your Website, Job Boards or Social Media – OrangeHRM

You can add the vacancies of OrangeHRM to your organization's website with these easy and simple steps. In this way, candidates can apply for the vacancies directly. It will save you from the hassle of adding their information and uploading their resumes to the system manually.

It’s best to get this done by your IT staff or any other 3rd party who is maintaining your corporate website.

Obtain the job list page of your OrangeHRM system. It will be the address of your OrangeHRM system, followed by /jobs.php.

If you are using OrangeHRM SaaS platform, it will be:
https://yourcompany.orangehrmlive.com/jobs.php.
If you have hosted OrangeHRM within your organization, it will be:
https://your-orangehrm-address/jobs.php

2. Embed this within your careers page, using the HTML code below:

PRO TIP #1:

If you are using your own theme and have added your own company logo to your OrangeHRM system, you can display it on your jobs page. Instead of simply using the /jobs.php, use /recruitmentApply/jobs.html?logo=1.

Example:
https://yourcompany.orangehrmlive.com/recruitmentApply/jobs.html?logo=1

Once it’s done, the code in the website would look something similar to this:

<div class="row">

    <iframe id="info" src="https://yourcompany.orangehrmlive.com/jobs.php"
      name="info" width="100%" height="400" align="left"
      frameborder="0"></iframe>

</div>

PRO TIP #2:

If your OrangeHRM is hosted on OrangeHRM’s servers, your domain will be yourcompany.orangehrmlive.com. If you are using Content-Security-Policy headers on your corporate website, ensure that correct frame-ancestors are added there, so that the jobs page can be embedded.

Example: Content-Security-Policy: frame-ancestors 'self' yourcompany.orangehrmlive.com;

PRO TIP #3:

If your OrangeHRM is hosted on your own server, and has implemented Content-Security-Policy or X-Frame-Options: SAMEORIGIN HTTP headers, ensure that you allow the OrangeHRM URL to be embedded within your corporate website.

Your corporate domain and your OrangeHRM domain may differ from each other most probably. Therefore, you need to ensure that the X-Frame-Options header is not sent for the following URLs:

https://orangehrm.yourcompany.com/recruitmentApply/*

https://orangehrm.yourcompany.com/jobs.php

If you are using Content-Security-Policy headers on your corporate website, ensure that correct frame-ancestors are added there, so that the jobs page can be embedded.

Example: Content-Security-Policy: frame-ancestors 'self' orangehrm.yourcompany.com;

Here is how it will look. This is how we at OrangeHRM have done it on our website:

What if OrangeHRM is hosted in an internal network, and is not accessible from the internet?

In this scenario, you can allow the public to access the job application URLs via the internet with the following steps.

We recommend you create a separate subdomain of your corporate domain, for this purpose. (For example jobs.yourcompany.com). This subdomain should be mapped to the internet-facing host on your internal network. This host needs to have reverse-proxy capabilities.

Let's assume that your OrangeHRM instance is hosted in the local IP address 192.168.1.100.

Forward traffic for jobs.yourcompany.com to 192.168.1.100 using a reverse proxy. For security purposes, limit the forwarding only for the HTTPS port (443).
Block access to all other URLs on this subdomain, except for the following:
/recruitmentApply/*
/jobs.php

Based on your network's setup, you can use the internal web server settings (where OrangeHRM is hosted) or any other mechanism such as a firewall or the reverse proxy itself to implement this restriction.

Once this is configured properly, the URLs such as /auth/login will not be accessible via the internet. But ones such as /jobs.php and /recruitmentApply/jobs.html?logo=1 will be accessible on https://jobs.yourcompany.com.

Then, you can embed these URLs using an <iframe> to your corporate website.

How to implement search/filter options to the OrangeHRM vacancy list?

Once the vacancies are published on OrangeHRM, organizations integrate these vacancies onto their website or share these vacancies with job boards where applicants can apply directly from the website to the vacancy published in OrangeHRM.

In such situations, you may require to search or filter vacancies based on certain criteria. OrangeHRM in order to support your requirement provides you 3 options from which you can filter the vacancies in the OrangeHRM vacancy list.

Access to the vacancy directly in OrangeHRM

We can pass the vacancy code into the URL and it will filter the specific vacancy upon clicking on the website vacancy box. Please see the below two URLs which open only the specific vacancy;

Example 01 - https://abcd.orangehrmlive.com/recruitmentApply/3/view

Example 02 - https://abcd.orangehrmlive.com/recruitmentApply/21/view

Here, the highlighted number is the vacancy code that will take the applicant directly into the vacancy. To Get this URL, Go to the job posting section of the vacancy that you have published and click on the Website link highlighted.

The system opens the selected vacancy in a new window. The user can copy the direct access URL to the vacancy.

Filter the vacancy list based on the county

Large organizations with multi-country presence will publish vacancies required for multiple countries. If you need to filter the vacancies based on the country in order to incorporate the vacancy list in their regional website or just to have a filter option on your careers page, We can pass the country code into the vacancy URL and it will filter only respective countries' vacancies. See the below URLs for a set of locations you have in the website;

Example 01 - Dubai:

https://abcd.orangehrmlive.com/recruitmentApply/jobs.html?countryCode=AE

Example 02 - Germany:

https://abcd.orangehrmlive.com/recruitmentApply/jobs.html?countryCode=DE

Example 03 - The United States:

https://abcd.orangehrmlive.com/recruitmentApply/jobs.html?countryCode=US

Highlighted here is the Standard Alpha 2 code of the specific country which you can use to filter vacancies based on the country. As per the above example, refer the below table to

Country	Alpha 2 Code
Dubai	AE
Germany	DE
United States	US

To know your country code, please visit ISO’s (International Organization for Standardization) Online Browsing Platform [Click Here] and select the country codes and search.

Filter the vacancy list based on the location

Applicants who look for vacancies in organizations with multiple locations may require to look for vacancies in their closest location. Therefore, OrangeHRM can provide vacancies based on the location of their availability. In order to do that, you can pass the Location ID into the vacancy URL and it will filter only the respective location's vacancies. Please see the below URL which filters the location-specific vacancies;

Example 01 - https://abcd.orangehrmlive.com/recruitmentApply/jobs.html?locationId=4

Example 02 - https://itwp.orangehrmlive.com/recruitmentApply/jobs.html?locationId=3

If the website provides the function to filter based on the location, the above example shows how the redirect URL should be used to filter the criteria.

To get these Location IDs, please contact your implementation consultant or OrangeHRM support team.

Publishing Vacancies in Social Media

Users can share and find suitable candidates for their vacancies through their social media platforms such as LinkedIn, Facebook, or Twitter. In order to do that, once the vacancy is published on Orange HRM, the user can share that link on their preferred social network.

Step 1 - Go to the vacancies tab in the recruitment module.