Shortcode Reference

WP Job Manager adds several shortcodes which you can use to display jobs and forms. These are listed below.

An important note for all shortcodes: Ensure they are not wrapped with any tags when adding them to your posts/pages. To check this, view the page content in ‘html’ mode and remove any formatting surrounding the shortcodes. This will prevent styling issues.

jobs

The [jobs] shortcode outputs a list of your jobs as well as filters for searching.

An example of the jobs shortcode
An example of the jobs shortcode

This shortcode takes the following arguments:

  • per_page – Defaults to the ‘per page’ option in settings. This controls how many jobs get listed per page.
  • orderby – Defaults to ‘featured’. Supports title, ID, name, date, modified, rand, featured, and rand_featured (random but keeps featured at top). Since WP Job Manager v.2.4.0, you can set additional parameter featured_first to true in addition to order_by to display featured jobs at the top of the list.
  • order – Defaults to ‘desc’. Can be set to ‘asc’ or ‘desc’ to choose the sorting direction.
  • show_filters – Defaults to true. Shows filters above the job list letting the user narrow the list by keyword, location, and job type. Once a filter is chosen, active filters are listed above the jobs, as is an ‘RSS’ link for the current search.
  • show_pagination – Defaults to false. Enable this to show numbered pagination instead of the ‘load more jobs’ link.
  • show_categories – Defaults to true when categories are enabled. If enabled, the filters will also show a dropdown letting the user choose a job category to filter by.
  • categories – Comma separate slugs to limit the jobs to certain categories. This option overrides ‘show_categories’ if both are set.
  • job_types – Comma separate slugs to limit the jobs to certain job types.
  • selected_job_types – Comma separate slugs to select by default.
  • location – Enter a location keyword to search by default.
  • keywords – Enter a keyword to search by default.
  • featured – Set to true to show only featured jobs, false to show no featured jobs, or leave out entirely to show both (featured first).
  • filled – Set to true to show only filled jobs, false to show no filled jobs, or leave out entirely to respect the default settings.
  • post_status – Set to ‘publish’ to display active jobs, set to ‘expired’ to show expired jobs.

If the URL of the page contains a query string and location or keywords is set, the values in the query string will populate the location and keywords fields instead of the above options.

Examples

Show 12 of the most recent jobs without filters and pagination:

[jobs per_page="12" show_filters="false"]

Show 20 jobs at a time, ordered by title, with categories disabled:

[jobs per_page="20" orderby="title" show_categories=false]

job

Outputs a single job by ID. You can find the id by viewing the list of jobs in admin. Example:

[job id="10"]

The listing will be output like a single job listing.

job_summary

Outputs a single job’s summary by ID.

Screen-Shot-2013-07-10-at-20.28.44

You can find the id by viewing the list of jobs in admin. Example:

[job_summary id="10"]

post_status

Show only expired jobs: [jobs post_status="expired"]
Show only active jobs: [jobs post_status="publish"]

submit_job_form

This shortcode outputs the frontend submit job form. There are no other arguments needed for this shortcode – just add it to a page.

[submit_job_form]

You can read more about the job submission form here.

job_dashboard

This shortcode outputs the job dashboard used by logged in users.

[job_dashboard]

You can also change the number of listings shown per page in the dashboard by using the posts_per_page parameter, like so:

[job_dashboard posts_per_page="10"]

The default is 25 jobs; it won’t show pagination unless there are multiple pages.

You can read more about the job dashboard here.

Advanced Usage Documentation