Open Source Career Portal Overview

The Open Source Career Portal (OSCP) is a customizable job portal that makes it easy to publish your company’s open jobs directly to your website. Built with lightweight JavaScript, HTML, and CSS, it’s a free and flexible solution that allows you to give job seekers a seamless way to view and apply for your jobs.

The OSCP is a free download from our Github site and will need to be configured to work with your website so you may need assistance from a web developer.

About Open Source Career Portal Versions 3.0 and Above

General Information

On October 30, 2019, our OSCP was updated to version 3.0. This version introduces a number of enhancements, including:

  • A new look and feel.
  • The ability for a web developer to configure Google Analytics to track Job views and applications.
  • The ability to easily display additional Job fields from Bullhorn ATS.

Also included in versions 3.0 and higher is a new way for your web developer to set up the OSCP on your website. This is referred to as OSCP with Advanced Hosting and must be hosted to take advantage of server-side rendering using Node.js scripts. This will require knowledge of server administration and we recommend the use of a web developer.

This version will allow you to take advantage of the following features:

  • Everything included with the Standard OSCP.
  • The ability for a web developer to configure Google Jobs support.
  • The ability for a web developer to access an RSS feed (XML feed) of the OSCP.
  • Rich social sharing. Job titles, links, and thumbnails can all be included when sharing Jobs to social media.

Directions on setting up the OSCP with Advanced Hosting can be found on Github.

What the OSCP Looks Like

Take a look at our sample career portal here to see what it looks like out of the box.

A web developer with CSS knowledge can customize the OSCP to a greater extent.

If your career portal looks different, you may have an older version of the OSCP installed.

How the OSCP Works

When applicants apply using your Open Source Career Portal, they are added into Bullhorn ATS as a new candidate record with the status of New Lead.

When a candidate who already exists in your database applies for a job, Bullhorn does one of two things:

  • Automatically updates the candidate's existing record by parsing the new resume. The new resume is also added as an attachment under the Files tab on the candidate record.
  • Attaches the candidate's new resume to their existing record without overwriting information on the record. This prevents any important information from being unnecessarily overwritten.
    • ​In this case, you should review the newly attached resume and if it is more up-to-date than the information on the record, then you can parse it as an existing candidate from the Files tab.

If you would like to change the default behavior when existing candidates apply for jobs on your OSCP, please contact Bullhorn Support.

Before You Begin

This section outlines important information you need to know before starting your OSCP set up.

Enhancing or Customizing Your OSCP

See Enhancing and Customizing the OSCP for information on the available integrations for your OSCP.

Bullhorn WordPress Plugin

For an easier way to add a career portal to your website, Bullhorn offers an official WordPress plugin. This plugin is compatible with the latest version of the Open Source Career Portal (OSCP) and doesn't require direct file upload access.

You can find enablement steps here. Before you install the plugin, you must contact Bullhorn Support and complete the Enablement Form. You can find the specific setup steps on the Bullhorn's Github page.

Key Considerations for the WordPress Plugin

  • Version Compatibility: The plugin works with OSCP v3.0 but is not compatible with the advanced hosting version.

  • URL Restrictions: The URL for the career portal created with the WordPress plugin cannot be changed due to WordPress restrictions. If you need a different URL, you can embed the plugin within an i-frame.

  • No File Access Needed: The plugin is designed to be simple to use and does not require a web developer to manually upload files.

Web Developers

If you don't have a web developer, we offer several Marketplace Partners that can assist with setting up the OSCP:

As an alternative, if you want to have a custom career portal set up that includes features similar to the OSCP with Advanced Hosting, the below partners can assist you:

Setting Up Your OSCP

Initial Steps

This section will walk you through the steps listed on our GitHub page to get your career portal up and running.

We recommend you have a Web Developer assist you in setting up the OSCP on your website. While Bullhorn Support can assist with setting up the Standard OSCP with the steps on Github, we will be unable to access your website's web server.

If your web developer has any questions about the OSCP, including setup, troubleshooting, and customizations, they can reach out to other developers directly on Github.

  1. Download the Latest Release.
    • The necessary files can be downloaded from our GitHub page under the Releases section.
  2. Contact Bullhorn Support and Complete the Enablement Form.
    • You’ll need to contact Bullhorn Support to get your company’s Corp Token and Swimlane number, which are required for configuring the OSCP.
    • Support will also provide you with the Career Portal Enablement Form that needs to be filled out and returned after you finish the steps in this article and GitHub.
      • Alternatively, you can download the form located at the bottom of this article. An Account or Support contact will need to open a ticket with Support and include the completed form.
  3. Configure and Upload the Career Portal Files.
    • You or a web developer will need to look at the Downloading and Configuring section of our GitHub page to ensure all files are properly configured before you upload them to your website.
  4. Send Bullhorn Support the Career Portal Enablement Form.
    • You must contact Bullhorn Support when the above is completed so we can perform the necessary steps on our end.
    • When everything above is completed and the files are uploaded to your site, fill out the information contained within the Career Portal Enablement Form attached to this article. Once it's filled out, send it back to Bullhorn Support.

Next Steps

After we perform the steps on our end, you can begin utilizing your OSCP! Take a look at the below articles to familiarize yourself with the OSCP:

OSCP Support

Bullhorn Support can help with the below:

  • Uploading the standard OSCP. This includes the steps in the Setting Up the OSCP section above.
  • Troubleshooting general OSCP issues, including:
    • Job posting issues for a career portal that has not been customized in any way.
    • Missing or duplicate web responses.
    • The inability for Candidates to apply to Jobs.
  • Displaying additional Job fields on the OSCP (Job Chips) - Only in versions 3.0 and higher.

Bullhorn Support cannot help with the below:

  • Customizing or troubleshooting customizations for the OSCP (colors, styles, logos, etc.).
    • Basic customization options can be found here.
    • Portal configuration options can be found here.
  • Google Analytics. Requires version 3.0 or higher.
  • Google Jobs. Only available with the OSCP with Advanced hosting. Requires version 3.0 or higher.
  • Exporting the OSCP’s RSS feed (XML feed). Only available with the OSCP with Advanced hosting. Requires version 3.0 or higher.
  • Configuring social sharing to include more job details. Only available with the OSCP with Advanced hosting. Requires version 3.0 or higher.