Docs » Help » Consultant data with JobRelay

Consultant data

Many websites want to show consultant data alongside the current job, usually with the name of the consultant who is responsible for the job advert and maybe contact details etc.

When a job gets delivered from the posting service via JobRelay, the following consultant data is delivered too:

• contact_name – this is the name of the consultant who posted the job
• contact_email – the email address of the consultant, as registered in the consultants profile with the posting service (e.g. Broadbean)
• contact_telephone – the contact number of the consultant
• contact_url – an associated website address for the consultant

In some instances, the values of these fields may not be the consultant details posting the job. This is to do with the way in which your organisation is setup in your posting provider. Please speak to them about the values that are being sent.

The values of these fields can be saved as post meta against the newly created job, when the job is sent from JobRelay. To make sure these values are saved, add the following to your meta mappings setting in the Settings > JobRelay Settings page in the WordPress admin area.

{
	"_contact_name":"contact_name",
	"_contact_email":"contact_email",
	"_contact_telephone":"contact_telephone",
	"_contact_url":"contact_url"
}

In the example above, the consultants email address can then be obtained in WordPress using the following code.

<?php echo esc_html( get_post_meta( $post->ID, '_contact_email', true ); ?>

The contact email address is the unique piece of information here.

Setting the job post author

By default, JobRelay tries to set a WordPress user as the author of each job that is delivered. WordPress takes the value sent in the contact_email field and tries to find a user with a matching email address.

If a user is found, this user is then assigned as the author of the job post in WordPress.

Storing consultant details in a post type

Often, sites want a specific post type for consultants or team members. This is often because this means each consultant with have a front end URL or permalink page.

If this is the case, you may want to store the post ID of the corresponding consultant when a new job is delivered from JobRelay.

The code below, added to either your themes functions.php file or better still a plugin with save the consultant post ID (if it exists) with a meta key of _consultant_post_id.

<?php
/**
 * Saves the consultant post ID when a new job is posted.
 *
 * @param integer $job_post_id The post ID of the newly created or updated job.
 * @param array   $job_data    An array of all the job data posted via JobRelay.
 */
function hd_save_consultant_post( $post_id, $job_data ) {

	// if we don't have a contact email in the feed - do nothing.
	if ( empty( $job_data['contact_email'] ) ) {
		return;
	}

	// query for a consultant post, based on the contact email.
	$consultant = get_posts(
		[
			'post_type'      => 'hd_consultant', // change for the name of the consultant post type.
			'post_status'    => 'publish',
			'fields'         => 'ids',
			'posts_per_page' => 100, // if you have more than 100 consultants, increase this.
			'meta_query'     => [
				[
					'key'     => '_consultant_email', // change for the meta key storing the consultant email.
					'value'   => sanitize_email( $job_data['contact_email'] ),
				]
			],
		]
	);

	// grab the last post returned - there should only be one.
	$consultant_id = array_pop( $consultants->posts );

	// if we have no consultant id.
	if ( empty( $consultant_id ) ) {
		return;
	}

	// save the consultant id as meta data against the job.
	update_post_meta( $job_post_id, '_consultant_post_id', $consultant_id );

}

add_action( 'jobrelay_wpcon_job_inserted_complete', 'hd_save_consultant_post', 10, 2 );