Plugin to pull a job board from greenhouse.io via their API.
Author: | Brown Bag Marketing (profile at wordpress.org) |
WordPress version required: | 3.0 |
WordPress version tested: | 4.9.4 |
Plugin version: | 2.7.3 |
Added to WordPress repository: | 20-03-2015 |
Last updated: | 03-04-2018
Warning! This plugin has not been updated in over 2 years. It may no longer be maintained or supported and may have compatibility issues when used with more recent versions of WordPress.
|
Rating, %: | 84 |
Rated by: | 5 |
Plugin URI: | https://wordpress.org/plugins/greenhouse-job-... |
Total downloads: | 8 765 |
Active installs: | 400+ |
Click to start download |
Screenshots
Shortcode in action. Notice the 'Add Greenhouse Job Board' button.
View the job board list.
Click to view description of each job.
Click to apply for each job.
View the 'Add Greenhosuse Job Board' button modal wizard. This will allow you to easily configure your board with all the settings. It will insert the configured shortcode into the content editor.
Any Requirements?
Yes, this plugin requires that you have a greenhouse.io account. You will need to enter your url token as well as your API key.
Server requirements
If you desire inline forms rather than iframe forms, to submit applications to the greenhouse API the web server must support cURL since it is used for the proxy data submission as to not expose your API key to the public.
Can I add my own styles?
Yes, you can add your own custom CSS on the plugin options page.
I made edits in my Greenhouse account, but I’m not seeing those edits on my website, what gives?
This plugin connects to Greenhouse to retreive data and saves it locally in your WordPress database for a while so your site will load faster and not have to wait for Greenhouse API everytime your job board loads. Go to the settings page and check your cache expiration setting to see how long this temporary or transient data will be stored locally, and also notice the checkbox option to clear the cache. To force fresh data to your site, check this box and save changes.
Can I add social share links or something relative to the job listing?
Yes, there is a php filter in place for after the job title on the full job listing template. It is called: ghjb_single_job_template_after_title
. Place a function with this name into your theme functions file or your theme plugin php and you may add content following the title of each job. Note that this refers to the full job display and not the job list display. Here’s a simple example usage:
add_action(‘ghjb_single_job_template_after_title’, ‘add_note_to_single_job_template’, 10, 1);
function add_note_to_single_job_template ($html){
$html .= '<h2>Job Subtitle</h2>';
$html .= '<a href="#facebook-share-url">Share this job with friends</a>';
return $html;
}
Can I customize the job board job excerpts?
You can add your own content or edit the job excerpt on the job board via a javascript hook. This works much in the same way as a WordPress hook, but it’s javascript based rather than php. Simply add a javascript function to your site named: ghjb_excerpt_filter
and it will automatically be called and executed as the plugin creates the job board list. Here’s an example use to trim the excerpt to 100 characters and add an ellipsis.:
//greenhouse job board plugin js filters
function ghjb_excerpt_filter(content) {
var short_content_start = 0;
var short_content_end = 100;
var new_content = content.substring(short_content_start, short_content_end) + ' …';
return new_content;
}
Can I customize the fields in use on my forms?
You can customize the inline forms, but not the iframe forms. There is a hook available for use via javascript to filter the fields on inline forms called ghjb_questions_filter
. Call it in your theme or plugin javascript. It will receive as parameter the array of questions as returned by the greenhouse api for each job and your filter must return a similarly formatted array of questions, but you may rearrange the fields or change labels field types, etc. Here’s an example use that customizes some fields:
function ghjb_questions_filter( questions ) {
//find field indexes
var remove_index, coverletter_index, resume_index;
for ( var i = 0; i < questions.length; i++){
if ( questions[i].label === 'Resume' ) {
resume_index = i;
}
if ( questions[i].label === 'Cover Letter' ) {
coverletter_index = i;
}
if ( questions[i].label === 'Remove Me' ) {
remove_index = i;
}
}
//remove field
questions.splice(remove_index,1);
//set default file_input type to textarea rather than file upload
questions[coverletter_index].fields.reverse();
//change label
questions[coverletter_index].label = "Updated Cover Letter Label";
//move to last field
var coverletter_question = questions.splice(coverletter_index, 1);
questions.push ( coverletter_question[0] );
var resume_question = questions.splice(resume_index, 1);
questions.push ( resume_question[0] );
//return customized questions array
return questions;
}
Can I have some custom tracking when the form a successful submission completes?
There is a javascript hook you can add to your theme code that will work here. The function is ghjb_after_thanks
and is called after the thank you message is processed and displayed on the page.
2.7.3
- Updated Admin page to allow a selection for “Use Custom CSS”. The Custom CSS text area is now hidden unless the checkbox is selected.
- Updated jobs sort to only occur when shortcodes are used.
- Updated Admin page to allow user to remove “excerpt” via checkbox when the “cycle” Type is selected for the job board.
2.7.2
- Fix bug with department filter not firing properly when not in debug mode.
2.7.0
- Add new setting for a custom error message when an application submission fails.
- Adding support for hidden input fields in inline forms.
- Better support for js thank you hook.
2.6.1
- Fix a bug that jumped to the top of the page when using iframe forms.
2.6.0
- Update validation script to work better on older browsers.
- Added js hook for when form validation fails:
ghjb_form_validate_fail
- Add css border to fields when they fail validation:
#apply_form.invalid .field_required input:invalid
, easy to override in your theme styles.
2.5.0
- Update ajax submit to only allow one submission if response is slow. Disables submit button on submit.
2.4.0
- Add js hook for after thanks is displayed
- Fix bug with department filter
- Add support for new custom question field types: Yes/No & Single Select
- Expose the cycle transition type on the options page
- Better error logging
- Fix bug with no cache option
2.3.0
- Adding a js hook for after apply form is build.
- Add optional attribute value for form inputs on job questions.
- Allow for html5 form field types.
- Bugfix for multiple boards on one page.
2.2.0
- Use job title rather than id when possible (in the hash linking)
- Allow paragraphs and line breaks in thank you message.
- Add filter for job questions (js).
- Add filter for job excerpts (js).
- Add more classes to form elements for easier styling.
- Minor bug fixes.
2.1.0
- Add grouping and grouping headling options.
- General code cleanup.
2.0.2
- Update compatability notice.
- Check that new debug and analytics values are set properly.
2.0.1
- Load css conditionally – only on pages with the job board shortcode. (props – bsteinlo)
2.0
- Add filter for single job template. (ghjb_single_job_template_after_title)
- Add google analytics integration
- Add debugging option
- Update inline job submission script to be more compatible with current WordPress best practices. (props – bsteinlo)
1.9
- Load assets (css & js) conditionally – only on pages with the job board shortcode. (props – bsteinlo)
- Check if cycle2 js library is already loaded and only load it if it’s needed still.
- Add sorting options to job board.
- Add sticky option to have jobs stick to top or bottom when sorting.
- Ensure to only allow inline forms after API key is entered.
- Set cache expiration limits and clear cached data from Greenhouse API.
- Minor code clean up and documnetation updates.
1.8
- Fix minor bug in shortcode wizard for form type setting.
- Fix bug when submitting optional files.
- Allow multiple shortcodes on one page.
1.7
- Add cycle option for the job board layout.
- Add inline form option, no longer need to load an iframe (may take special setup and requires).
- Add custom css block.
- Various bug fixes.
- Cache greenhouse data for faster performance.
1.6
- Adding options to customize display of job data: location, office, department and description.
- Also adding options to customize labels for each of the above.
- Minor Bug fixes.
1.5
- Adding add job board media button and wizard to help construct your shortcode.
- Bug fixes – compatability with ACF Pro.
- Bug fixes – unexpected output.
- Updates – requiring a url_token with user feedback on error.
1.4
- Adding support for location filter (include and exclude).
- Adding support for office filter by name/title or id(include and exclude).
- Adding another global settings for the text strings used on the job list.
- Cleaning up toggle scripts.
1.3
- Adding support for job filter (include and exclude).
- Adding support to filter by name/title or id.
- Adding global settings for the text strings used on the job list.
1.2
- Adding support for department filter (include and exclude departments).
- Adding support for hiding forms from the job board.
1.1
- Adding settings page with global default settings.
1.0
- Initial release