JPKCom DB
View on GitHub

JPKCom ACF Jobs — Guide & Tips

Manage job postings with JPKCom ACF Jobs — installation, custom post types, shortcodes, template overrides and practical tips for ACF Pro-based job listings.

JPKCom ACF Jobs is a job listing and application management system built on Advanced Custom Fields Pro. It ships three custom post types (Jobs, Locations, Companies), JobPosting Schema.org data, Bootstrap 5 templates and shortcodes — aimed at career pages, HR teams and job boards.

Guide

Requirements

Required:

Optional: WPML for multilingual job postings.

Installation

  1. Download the latest release ZIP from the GitHub Releases page.
  2. In your admin panel: Plugins → Add New → Upload Plugin, choose the ZIP, Install Now, then Activate.
  3. Make sure ACF Pro and ACF Quick Edit Fields are active.

Alternatively upload via FTP to /wp-content/plugins/, or clone it for development:

cd /path/to/wordpress/wp-content/plugins/
git clone https://github.com/JPKCom/jpkcom-acf-jobs.git

On multisite the plugin is network-compatible (Network Admin → Plugins → Network Activate).

Getting started

After activation you'll see Jobs, Locations and Companies menu items. Recommended flow:

  1. Create a location under Locations → Add New.
  2. Create a company under Companies → Add New.
  3. Create a job under Jobs → Add New, fill the ACF fields (job type, location, company, salary) and assign job attributes via the taxonomy on the right (e.g. benefits, requirements).
  4. Publish the job — it appears in the archive at /jobs/ and is marked up with JobPosting Schema.org data.

Displaying jobs

Via shortcode (all attributes optional):

[jpkcom_acf_jobs_list type="FULL_TIME" company="6,8" location="1,3,7" limit="10" sort="DSC"]

company and location expect post IDs (visible in the admin URL, post=123). Attributes (benefits/requirements) can be rendered separately:

[jpkcom_acf_jobs_attributes id="3,7,21"]

Alternatively visit the archive at /jobs/ directly, or build custom output with WP_Query and post_type => 'job'.

Tips & Tricks

  • Disable/redirect the job archive: Under Jobs → Options you can disable the /jobs/ archive and optionally redirect it to a custom URL (e.g. /careers/) via HTTP 307. Individual job pages stay accessible — handy if you prefer to show jobs via shortcodes on your own pages.
  • Override templates (priority order):
    1. Child theme (recommended): copy templates from plugins/jpkcom-acf-jobs/templates/ to your-child-theme/jpkcom-acf-jobs/.
    2. Parent theme: copy to your-theme/jpkcom-acf-jobs/.
    3. MU-plugin: copy to mu-plugins/jpkcom-acf-jobs-overrides/templates/ for site-wide customization.
  • Extend paths programmatically: The filters jpkcom_acf_jobs_template_paths and jpkcom_acfjobs_file_paths let you prepend your own directories; jpkcom_acf_jobs_final_template allows overriding the final template dynamically.
  • Render ACF fields with Bootstrap 5 markup: jpkcom_render_acf_fields() outputs all ACF fields of a post; fetch template parts with jpkcom_acf_jobs_get_template_part( 'partials/job/company' ).
  • Schema.org with no configuration: JobPosting JSON-LD output is automatic and usable by Google for Jobs — nothing to configure.
  • Multilingual with WPML: Via wpml-config.xml, jobs, locations, companies and taxonomies are translatable; fields carry appropriate translation strategies (translate/copy/copy-once).
  • Updates & security: The plugin updates securely via GitHub with SHA256 checksum verification; update notices appear under Dashboard → Updates and on the Plugins page.

Further reading