WPJobBoard

Custom Fields Rendering

WPJobBoard has pretty powerful Custom Fields system, but sometimes you might want to display data in the frontend (on job/resumes/company details page)  differently then on the form, for example you might want the custom url user enters in the form to display as clickable link or maybe as a YouTube video, this article will explain how to do this easily without modifying original files.

This will require some programming, all the code that will be shown below you can either add to your theme functions.php file or even better create a new WordPress plugin and put the code there.

First thing we will need is to go to wp-admin / Settings (WPJB) / Custom Fields / Job Form panel, and add a Textbox and name it for example custom_url, as on the screen below:

Now save the form and go to wp-admin / Job Board / Jobs panel, edit one of existing jobs, fill the “Custom URL” field and save the job. This is technically optional step but we want to have some data to test on.

Of course if you already have a custom field created you can skip this step.

 Custom Renderers (requires WPJobBoard 4.2.1)

First, we need to create wpjb_scheme filter that will add custom rendering function for “custom_url” field, this requires pretty basic PHP code and almost always the code will be the same for your custom fields, in the code snippet you will be only changing “custom_url” to your custom field actual name.

add_filter("wpjb_scheme", "my_wpjb_scheme", 10, 2);
function my_wpjb_scheme($scheme, $object) {
 if(isset($object->meta->custom_url)) {
   $scheme["field"]["custom_url"]["render_callback"] = "my_render_as_link";
 }
 return $scheme;
}

Next we need “my_render_as_link” function that will be used to render custom_url on job details page instead of default rendering function.

function my_render_as_link($object) {
 $url = $object->meta->custom_url->value();
 echo sprintf('<a href="%s" target="_blank">%s</a>', esc_attr($url), esc_html($url));
}

Below you can see the result:

What if all your URLs will be links pointing to some video or audio files, or YouTube URLs? You will probably want to allow users to play them on site without sending them to third party site, if that’s the case simply modify your my_render_as_link function to look like this:

function my_render_as_link($object) {
 echo wp_video_shortcode(array("src"=>$object->meta->custom_url->value()));
}

That’s it. The code basically executes video shortcode, so you can add some parameters to the function if you want to customize how the video will be played, also note that if you are going to play videos not uploaded to your site there is (for security reasons) curated list of sites from which you can embed content, see more here.

Last trick, if you would made the custom_url, File field instead of Textfield, you could modify your my_render_as_link function like in the example below to play your files on site instead of allowing to download them:

function my_render_as_link($object) {
 echo wp_video_shortcode(array("src"=>$object->file->custom_url[0]->url));
}