JobRoller Theme Broadbean Add-on WordPress Plugin

Over the last 2 years I have been building solutions to integrate Broadbean (and more recently LogicMelon) with WordPress websites. Starting with the stand-alone WP Broadbean plugin I have then started to provide integration solutions for some of the more popular job board plugins and themes. Continuing with this I have now launched, available for sale, my JobRoller Broadbean Add-on plugin for WordPress, to integrate WordPress sites running the JobRoller theme with Broadbean or LogicMelon.

Continue reading JobRoller Theme Broadbean Add-on WordPress Plugin

Introducing the WP Job Manager Broadbean Add-on

A few years ago I built the WP Broadbean WordPress plugin in order to integrate Broadbean job posting with a WordPress website. This is has proved a highly successful plugin with a number of sites now actively using this. In fact Broadbean themselves are keen for WordPress users to adopt its use. Recently I have been working on another solution for WordPress sites which integrates the very popular WP Job Manager plugin with Broadbean. Allow me to introduce the WP Job Manager Broadbean Add-on.

WP Job Manager Add-on Settings TabWP Job Manager Broadbean Add-on

The WP Job Manager plugin has a number of add-ons that are listed on the add-ons page of the website. You will now see a Broadbean add-on listed, and many thanks to the team for allowing this add-on onto their page for third party add-ons.

I have decided that the plugin will be a paid for product, much like the other add-ons on that page and also that it will be licensed. like many other commercial current commercial plugins. There are two type of license, each lasting for a period of 12 months, giving purchasers support throughout that period as well as updates. The licenses are either for 1 site, priced at £99.99 or for unlimited sites priced at £199.99.

Getting Started

The add-on is activated like a normal plugin would be and contains a settings tab under the WP Job Managers settings page. On here users can set a username and password for their incoming feed as well as activating their license. Also on this page are instructions on what information to pass through to the team at Broadbean in order for them to send the job data to your site.

It is worth noting here that the plugin is dependent on data being sent from Broadbean. This is something that would be specific to your site and therefore needs to be built by the Broadbean integrations team. For this reason they will probably have a charge for this too and it is worth speaking with your Broadbean account manager about this.

So if you are a recruitment business using Broadbean and you have a WordPress website of you own running the WP Job Manager plugin to show jobs on your site, you can know include jobs you post through Broadbean on your site as well. There will no longer be the need to add them in two places!

View the WP Job Manager Broadbean Add-on
Purchase the WP Job Manager Broadbean Add-on

Broadbean Integration with WP Job Manager

For past couple of years I have worked on a plugin called WP Broadbean. This plugin integrates Broadbean‘s job Adcourier posting service with your WordPress site, allowing jobs posting through Broadbean to delivered to your site. While this plugin is working well, I have had multiple enquiries about integrating Broadbean job posting with the popular WP Job Manager plugin. Well today I am announcing that I can now offer this integration too. Let me explain a little more.

The WP Job Manager plugin is a plugin to provide Job board functionality to your WordPress site and was developed by Mike Jolly who works on the WooCommerce project. The plugin is very good and provides a jobs post type and associated taxonomies and meta fields for jobs, similar to the WP Broadbean plugin. It also has a nice AJAX style search built in to allow candidates to search for jobs in specific categories etc. as well as allowing candidates to apply for a job through the site.

These are mainly the features that the WP Broadbean plugin has. Although using my stand-alone plugin is more specific to Broadbean job posting itself, I can see the advantages of using the WP Job Manager plugin with its community and increased usage.

So onto my integration then. I have a built a WordPress plugin which acts as an addon for the WP Job Manager plugin. This provides an additional settings screen where site owners can create a username and password in order to setup their feed with Broadbean.

The plugin works even with sites that have registered additional fields in the WP Job Manager plugin so that it picks these up without any additional development, assuming of course they have been added correctly using the hooks and filters provided by WP Job Manager.

It also hooks into the application form to allow candidate applications made on the WordPress site to be tracked in from within Broadbean along with applications for other sources or job boards.

If you are interested in integrating Broadbean with the WordPress and the WP Job Manager plugin then please do get in touch for a quote.

WP Broadbean Plugin Updates

In early 2014 I launched the first beta version of the WP Broadbean WordPress plugin. This is a plugin to integrate Broadbean Adcourier job postings with a WordPress website. The plugin has evolved and changed since then and therefore lets take a look at some of the plugins features.

Lets outline some of the new features of the plugin which have been introduced after the initial launch:

Extensibility

The plugin has been made as extensible as possible from the start. However as development has progressed it has become more obvious that additional extensible features could be utilised. Many of these have come from developers in the community using the plugin and feeding back to me.

There are now a number of hooks and filters that allow developers to extend upon and alter the functionality of the plugin. For example developers can use a different inbox.php file which processes each job simply by using a template override. Developers can also use filters to add additional job fields and taxonomies to the job postings should they wish to.

It is worth remembering however the more customisations made with the plugin through its extensible features, the more changes Broadbean will need to make to the feed which is used to send jobs to your site.

Below are some of the new filters you can use:

  • wpbb_query_var_value – allows you to change the URL query var to which jobs are posted to. This defaults to broadbean but developers could change this to something else.
  • wpbb_application_form_html – using this filter would allow developers to alter the markup of the application form used to allow candidates to apply for jobs
  • wpbb_application_allowed_file_types – a filter that allows editing of the file types that are allowed by default in the CV upload field on the application form
  • wpbb_apply_url – with this filter you can amend the URL used for applying for jobs. This means you could change the URL completely, maybe to use your own form or you could perhaps add additional query variables to the URL which you may use in your application form.
  • wpbb_admin_sub_menus – allows developers to add a sub menu beneath the main WP Broadbean menu
  • wpbb_registered_settings – add additional settings to the WP Broadbean settings admin page

There are many new action hooks you can utilise too:

  • wpbb_job_term_added – a hook that fires after a term has been added to a job when sent through from Broadbean
  • wpbb_job_field_added – this hooks fires after a field is added (post meta) to a job when sent through from Broadbean
  • wpbb_job_added – after the job is added along with all the fields and the terms this hook is fired. Can be good for actioning things like clearing search caches etc. which need to be re-built when a new job or post is added.

There are many more and I would encourage you to search the code-base for apply_filters and do_action.

Application Form

The application form has changed along the way to, for the better I think. It now no longer uses a shortcode but instead you select which is your apply page in the WP Broadbean settings page. The application form is then appended to any page content you may have on that page.

The form also now includes a field for a message, something which many users requested.

Finally the form now also allows the upload of Word and Pages documents as well as the original PDF document type. Even these can be changed with a filter.

Attachments to Email Notifications

One of the initial issues with the plugin which was reported to me was that the application form was not emailing Broadbean correctly or not attaching the applicants CV to the email. This is something that is important for the tracking of an application from within the Adcourier system.

These issues have now been fixed and all the emails that are sent through to Broadbean will have the applicants CV attached.

Those are the main changes and alterations to the plugin which I hope make it much better for users and developers to take advantage of. Do remember that I offer a Broadbean Assist service where I can integrate Broadbean with your WordPress site for just £599 which takes the hassle out of doing it yourself.

Over the coming months I have some additional plans for the Broadbean plugin with a view to integrating this into some other services – watch this space. Oh and don’t forget that I recently launched a plugin for integrating WordPress with LogicMelon over at wplogicmelon.com – you can read a little more about this here!

Introducing WP Broadbean

The WP Broadbean plugin has now been released on WordPress.org…

A while ago I wrote about integrating Broadbean with WordPress. This has proved to be a very popular post on this blog and has resulted in a number of enquiries with several people requesting assistance in this very task. With this in mind I have decided to package this work into a plugin named WP Broadbean.

For those not aware, Broadbean Technology runs a service known as Broadbean Adcourier multi-job posting. This enables jobs to be added to the Adcourier service and then broadcast to a number of popular job boards. On top of this, the broadcast and can setup to integrate with your own site. This means that users have to enter a job posting once and it is automatically published on a number of sites including your own.

A couple of years ago, working with Pixel Junction, we had a client who needed to integrate this with a WordPress site we had built for them. The solution I outlined in the original post was the method I took, however having had a number of further projects that needed the same, I decided it would be best to package this up into a plugin. Therefore let me introduce you to WP Broadbean.

The plugin is currently in the alpha stage, although I have integrated a version of it on a few sites. Before releasing it to the public (under the GPL license) I need to make some changes to make it much easier to use “out-of-the-box”. Below is a quick summary of what the plugin will do:

  • A Jobs custom post type
  • Custom taxonomies for job type, job location, job location tags and job categories
  • Custom post type for applications
  • A shortcode for embedding an application form onto your website, which integrates with the jobs custom post type, to allow people to apply for the listed jobs
  • Integrate with your current WordPress theme without creating template files, however you can override these in your theme

If you run a WordPress website that deals with recruitment and you use, or are thinking of using the Broadbean service, please take a look and get involved. I will need beta testers in then next few months! Meanwhile check out the new WP Broadbean holding page and keep an eye on progress on WP Broadbean Github repository.

Integrating BroadBean Job Posting with WordPress

banner-772x250

I now have a plugin to integration Broadbean and WordPress, and an Add-on for the WP Job Manager plugin.


A few months ago one of our biggest clients came along with a request to integrate the BroadBean Job posting solution into their website. Of course I had built the recruitment website using WordPress in order to for them to post jobs to their site and enable them to recruit people to specific jobs etc. As part of the build it was important that as well as being able to post jobs to the site using the normal WordPress way (writing posts etc) they wanted to be able to use external sources to post to their site too, in this case Broadbean. Here is how I went about this with help from colleague David Hassen.

Let me outline first what Broadbean actually is and how it works. Recruitment companies need to get their job posts out to a wide variety of clients across the UK and beyond and therefore as well as posting jobs to their own website they need to tap into other job posting sites. This means a lot of repetition in terms of writing the advertisement on all of these sites. This is were the Broadbean system comes in. With it, you write one job listing and then Broadbean system sends this job to many of the jobs sites including your own website. It was the later which myself and colleagues needed to integrate into the clients WordPress site.

Broadbean provide you with either an XML feed or a they use the PHP Post method in order to send the completed job form to your site. Therefore we designate a URL to which this ‘feed’ is sent to and then at this URL we need some code to interoperate this feed and then add a post to our WordPress site including the information in the feed.

As we were using the post method the first stage of this was to get the value from the posted information and separate them, storing each as PHP variables. In the example below, we are assuming that there are 4 pieces of information that are sent. These are the job title, job category, job description and job type (part time or permanent etc.). To start with we grab the information and store it as variables like this:

[php]
$pj_jobTitle = $_POST[“job_title”];
$pj_jobCategory = $_POST[“job_category”];
$pj_jobDescription = $_POST[“job_description”];
$pj_jobType = $_POST[“job_type”];
[/php]

The variables names prefixed with ‘pj_’ are the names I have chosen to store the values in. Always prefix you variables names to avoid clashes in your system. In the square brackets above are the names of the values sent by Broadbean (they will ask you for these when you set up this system).

Now we have the information, we need to add this to our WordPress website, probably as a post. To do this we make use of the wp_insert_post() WordPress function. Before we get into that lets think about each piece of information and how we would add it to a WordPress post.

To start with the Job Title (we have this as the variable $pj_jobTitle) can be added as the title of the post. The job category will be added as a post category and the job description will be added as the post content. The job type will need to be added as a custom field (meta data) to the post once we have created the post. First lets create a new post using job title, job category and job description. This is where the wp_insert_post() comes into play and we do it like this:

[php]
// create post object
$pj_post = array(
‘post_title’ => $pj_jobTitle,
‘post_category’ => array($pj_jobCategory),
‘post_content’ => $pj_jobDescription,
‘post_author’ => ‘4’,
‘post_status’ => ‘publish’,
);
// adds the post and return the post id to this variable
$pj_jobpostid = wp_insert_post($pj_post);
[/php]

The first part here we simple create a variable that stores all of our post data as an array (all except our custom meta data – the job type). The second part using the wp_insert_post() adding our variable containing the post data to the function. The wp_insert_post() function, when successful returns the ID of the post that is created so we are going to store this ID (we will need it to add the meta data) in the variable $pj_jobpostid.

Now we can add the job type as a custom field. To do this we are going to use the add_post_meta() function. This adds a custom field to a post given the posts ID (in our case $pj_jobpostid) the custom field key (in this case pj_job_type) and the value you want for this custom field (in our case $pj_jobType. This is added using the following code:

[php]
if($pj_jobpostid != 0) {
add_post_meta($pj_jobpostid, ‘pj_job_type’, $pj_jobType, true);
}
[/php]

We wrap this code in an IF statement that basically says if the value of $pj_jobpostid is anything but 0 (i.e. the wp_insert_post() has worked) then add our custom field.

The final thing to do is to give the user and Broadbean some feedback in order to check whether the whole process has worked. To so this we can add to our IF statement above something like the following:

[php]
if($pj_jobpostid != 0) { // if adding job is successful
add_post_meta($pj_jobpostid, ‘pj_job_type’, $pj_jobType, true);
echo ‘Nice one! The job has been added.’;
} else { // if adding the job failed
echo ‘There has been an error adding the post to the database!’;
}
[/php]

So there we have it. A system that allows you to use Broadbean in order to add jobs to your WordPress website as posts.