# 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.

Source: https://www.jpkc.com/db/en/guides/jpkcom-acf-jobs/

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:

- WordPress **6.9+** and PHP **8.3+**
- [Advanced Custom Fields Pro](https://www.advancedcustomfields.com/) (v6.0+)
- [ACF Quick Edit Fields](https://wordpress.org/plugins/acf-quickedit-fields/) (for inline editing)

Optional: [WPML](https://wpml.org/) for multilingual job postings.

### Installation

1. Download the latest release ZIP from the [GitHub Releases page](https://github.com/JPKCom/jpkcom-acf-jobs/releases).
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:

```bash
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):

```text
[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:

```text
[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

- Source code on GitHub: <https://github.com/JPKCom/jpkcom-acf-jobs>
- API documentation (PHPDoc): <https://jpkcom.github.io/jpkcom-acf-jobs/docs/>
- Requirements: [ACF Pro](https://www.advancedcustomfields.com/), [ACF Quick Edit Fields](https://wordpress.org/plugins/acf-quickedit-fields/)
- [This project's changelog](https://www.jpkc.com/db/en/changelog/jpkcom-acf-jobs/)