Greenhouse Job Board

Description

Plugin to pull a job board from greenhouse.io via their API and display it on your WordPress site. Use a shortcode with your URL Token to pull the data. Find your URL token on this page when you are logged into your greenhouse account. Place [greenhouse url_token="your_url_token"] in your page or post.

Requirements:

• Must have a greenhouse account.
• Enter your URL Token & API key.

Initial Setup:

• For ease of use, setup your URL Token within Settings->Greenhouse. (NOTE: you can also set this inline with shortcode attributes.)
• Add shortcode or use the wizard to add a job board to any page or post.

Know the code!

• To post your job board on a page, simply add the shortcode: [greenhouse]. By default, this will display all of the postings you currently have, along with the forms for applying. These forms are actually hosted at Greenhouse.io.

Current Features of the [greenhouse] shortcode:

Filter the jobs displayed. These filters can be combined to create complex filters.

Department Filtering

• Want to filter results by department? Show only one deparment or a couple? Exclude a whole department?
• Add the department_filter attribute: [greenhouse department_filter="Value1|Value2"]
• supports single or multiple values, pipe-delimited
• supports either using the department name OR the department id as the value.
• supports negated values – Excludes department(s) and display others. (example: department_filter="-Value3|-Value4")

Job Filtering

• Want to filter results by job? display only specific jobs? Exclude specific jobs?
• Add the job_filter attribute: [greenhouse job_filter="Value1|Value2"]
• supports single or multiple values, pipe-delimited
• supports either using the job title OR the job id as the value.
• supports negated values – Excludes this job and show others. (example: job_filter="-Value3|-Value4")

Office Filtering

• Want to filter results by office? Show only jobs from a specific office or exclude a specific office?
• Add the office_filter attribute: [greenhouse office_filter="Value1|Value2"]
• supports single or multiple values, pipe-delimited
• supports either using the office name OR the office id as the value.
• supports negated values – Excludes office(s) and only display jobs from elsewhere. (example: office_filter="-Value3")

Location Filtering

• Want to filter results by location? Show only jobs from a specific location or exclude a specific location?
• Add the location_filter attribute: [greenhouse location_filter="Value1|Value2"]
• supports single or multiple values, pipe-delimited
• supports location text value, since there is no id associated to locations in greenhouse.
• supports negated values – Excludes location(s) and only display jobs from elsewhere. (example: location_filter="-Value3")

Hiding Forms

• If you don’t want application forms to display and simply want to display listings, just add the hide_forms attribute
• ex. [greenhouse hide_forms="true"]

Sort Jobs

• Want to sort the jobs listed in your job board?
• Add the orderby attribute to the shortcode.
• Values allowed: title, date, id, department, office, location and random.
• For example: [greenhouse orderby="title"]
• Need to customize the order more?
• There is an order attribute as well, supported values: DESC (default) and ASC.
• There is a sticky option as well, force a single job to the top or bottom of the board.
• Sticky attribute format: ‘top’ or ‘bottom’ followed by a pipe ‘|’ and then the id for the job to stick.
• For example: [greenhouse orderby="department" order="ASC" sticky="top|18590"]

Group Jobs

• Want to group the jobs listed in your job board by department, office or location?
• Add the group attribute to the shortcode.
• Values accepted: department, office or location.
• By default the group name will be used as a headline to seperate each group.
• To omit group headlines, include shortcode attribute: group_headline=”false”.
• For example: [greenhouse group="department" group_headline="false"

Coming Soon

Roadmap

• Add filter hooks for customizing output
• Cleaner, smarter interface
• Widget
• Templating for your own layout