About this plugin
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