1. Home
  2. Developer Customizations
  3. Show Recruiter Information On User Screens

Show Recruiter Information On User Screens

Depending on how your recruiting agency is structured, it may be important for you to publicize the role of the assigned recruiter when presenting a job to a user. While most of our users prefer to wait until a candidate is applied for them to be in contact with your recruiting staff, if your culture fosters direct relationships between applicants and recruiters, you likely will want the recruiter’s name and contact information to present on the front end of your web site. This is possible in Matador Jobs with a little developer elbow grease.

Recruiter Data Imported From Bullhorn

In order to power our email alerts, Matador Jobs imports recruiter data from Bullhorn and stores the data in the Job post meta. Bullhorn actually has three places where recruiter data is stored on the JobOrder object, and they are:

  • owner: the one recruiter “owner” of the job. This defaults to the person who first created the job, and can be changed in the create and edit screens.
  • assignedUsers: the one or many persons including and/or in addition to the owner who can access and perform actions on the job. This is set in the job create and edit screens.
  • responseUser: the one recruiter who is responsible for receiving and acting upon submissions for this job. This is set and changed in the publishing screen.

Based on how a company has set up its workflows, a company may use one or none of these fields. How a company uses Bullhorn will be important to understand before you use the data in any of these fields.

Accessing Important Recruiter Data

On any job, you can access imported recruiter data via a post/job meta call. A post meta call is to use the default WordPress get_post_meta() function, while using a matador_get_the_job_meta() will do some checks before calling into the data base. Here is an example using matador_get_the_job_meta() to call the owner data:

<?php
// Argument 2 is optional when in the loop, otherwise is the
// post ID of the job.
$recruiter = matador_get_the_job_meta( 'owner', 123 );

var_dump( $recruiter );

The var_dump() result will be something like this:

object(stdClass)#1014 (4) {
  ["id"]=> int(68)
  ["firstName"]=>  string(4) "John"
  ["lastName"]=>  string(5) "Smith"
  ["email"]=>  string(23) "john.smith@example.test"
}

Note that when calling assignedUsers, the response will be an array of the objects show above.

You can now validate and output this data on your job archive, job single, and application pages using standard WordPress templating and PHP. For example, you can add the following block of code to your job template to create something like this:

Recruiter: John Smith

$recruiter = matador_get_the_job_meta( 'owner' );

if ( $recruiter && $recruiter->firstName && recruiter->lastName && $recruiter->email ) {
echo '<div class="recruiter"><strong>Recruiter:</strong><a href="mailto:' . sanitize_email( $recruiter->email ) . '">' . esc_html( $recruiter->firstName . ' ' . recruiter->lastName ) . '</a></div>';
}

What If I Want More Data?

Typically, a user wants more than just name and email address. Examples of other data a user likes to show when sharing recruiter data includes:

  • Photo
  • Biography
  • Social Media Share Links
  • Phone Number
  • Mailing Address
  • Home Town

If you’d like to do this, our current recommendation is to do the following:

  1. Create a WordPress Custom Post Type for Recruiters.
  2. Create custom post meta fields for the Recruiters post type. You can do this with custom code or by using Custom Field Editors like Advanced Custom Fields. Build out a Recruiter Profile with all your desired public fields and make sure to add one additional field for “Bullhorn ID”.
  3. In your template, make a WP Query to the Recruiter Post Type with a Meta Query call on the Bullhorn ID field passing the Job Recruiter(s) ID(s) as the value.
  4. Display data from the found Recruiter(s) posts on your Jobs and Job pages.
Updated on March 4, 2021

Was this article helpful?

Related Articles