# JPKCom ACF Jobs — Anleitung & Tipps

> Stellenanzeigen mit JPKCom ACF Jobs verwalten — Installation, Custom Post Types, Shortcodes, Template-Overrides und Praxis-Tipps für ACF-Pro-basierte Job-Listings.

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

JPKCom ACF Jobs ist ein Stellenanzeigen- und Bewerbungs-System auf Basis von **Advanced Custom Fields Pro**. Es bringt drei Custom Post Types (Jobs, Standorte, Unternehmen), JobPosting-Schema.org-Daten, Bootstrap-5-Templates und Shortcodes mit — gedacht für Karriereseiten, HR-Teams und Jobbörsen.

## Anleitung

### Voraussetzungen

Zwingend erforderlich:

- WordPress **6.9+** und PHP **8.3+**
- [Advanced Custom Fields Pro](https://www.advancedcustomfields.com/) (v6.0+)
- [ACF Quick Edit Fields](https://wordpress.org/plugins/acf-quickedit-fields/) (für Inline-Bearbeitung)

Optional: [WPML](https://wpml.org/) für mehrsprachige Stellenanzeigen.

### Installation

1. Lade die aktuelle Release-ZIP von der [GitHub-Releases-Seite](https://github.com/JPKCom/jpkcom-acf-jobs/releases) herunter.
2. Im Admin-Bereich: **Plugins → Installieren → Plugin hochladen**, ZIP wählen, **Jetzt installieren**, dann **Aktivieren**.
3. Stelle sicher, dass ACF Pro und ACF Quick Edit Fields **aktiv** sind.

Alternativ per FTP nach `/wp-content/plugins/` hochladen oder für die Entwicklung direkt klonen:

```bash
cd /pfad/zu/wordpress/wp-content/plugins/
git clone https://github.com/JPKCom/jpkcom-acf-jobs.git
```

Auf Multisite ist das Plugin netzwerkfähig (**Netzwerk-Admin → Plugins → Netzwerkweit aktivieren**).

### Erste Schritte

Nach der Aktivierung erscheinen die Menüpunkte **Jobs**, **Standorte (Locations)** und **Unternehmen (Companies)**. Empfohlener Ablauf:

1. Lege unter **Locations → Erstellen** einen Standort an.
2. Lege unter **Companies → Erstellen** ein Unternehmen an.
3. Erstelle unter **Jobs → Erstellen** eine Stelle, fülle die ACF-Felder (Jobtyp, Standort, Unternehmen, Gehalt) und weise rechts über die Taxonomie **Job-Attribute** zu (z. B. Benefits, Anforderungen).
4. Veröffentliche die Stelle — sie erscheint im Archiv unter `/jobs/` und wird mit JobPosting-Schema.org-Daten ausgezeichnet.

### Stellen ausgeben

Per Shortcode (alle Attribute optional):

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

`company` und `location` erwarten Post-IDs (im Admin in der URL sichtbar, `post=123`). Attribute (Benefits/Anforderungen) lassen sich separat ausgeben:

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

Alternativ erreichst du das Archiv direkt unter `/jobs/` oder baust eigene Ausgaben per `WP_Query` mit `post_type => 'job'`.

## Tipps & Tricks

- **Job-Archiv abschalten/umleiten:** Unter **Jobs → Options** kannst du das Archiv `/jobs/` deaktivieren und optional auf eine eigene URL (z. B. `/karriere/`) per HTTP-307 umleiten. Einzelne Job-Seiten bleiben erreichbar — praktisch, wenn du Stellen lieber per Shortcode auf eigenen Seiten zeigst.
- **Templates überschreiben** (Reihenfolge der Priorität):
  1. **Child-Theme** (empfohlen): Templates aus `plugins/jpkcom-acf-jobs/templates/` nach `dein-child-theme/jpkcom-acf-jobs/` kopieren.
  2. **Parent-Theme**: nach `dein-theme/jpkcom-acf-jobs/`.
  3. **MU-Plugin**: nach `mu-plugins/jpkcom-acf-jobs-overrides/templates/` für seitenweite Anpassungen.
- **Pfade programmatisch erweitern:** Über die Filter `jpkcom_acf_jobs_template_paths` bzw. `jpkcom_acfjobs_file_paths` lassen sich eigene Verzeichnisse voranstellen; `jpkcom_acf_jobs_final_template` erlaubt das dynamische Überschreiben des finalen Templates.
- **ACF-Felder mit Bootstrap-5-Markup rendern:** `jpkcom_render_acf_fields()` gibt alle ACF-Felder eines Beitrags aus; Template-Teile holst du mit `jpkcom_acf_jobs_get_template_part( 'partials/job/company' )`.
- **Schema.org ohne Konfiguration:** Die JobPosting-JSON-LD-Ausgabe ist automatisch aktiv und für Google for Jobs nutzbar — nichts einzustellen.
- **Mehrsprachig mit WPML:** Über `wpml-config.xml` sind Jobs, Standorte, Unternehmen und Taxonomien übersetzbar; die Felder tragen passende Übersetzungsstrategien (translate/copy/copy-once).
- **Updates & Sicherheit:** Das Plugin aktualisiert sich sicher über GitHub mit SHA256-Prüfsumme; Update-Hinweise erscheinen unter **Dashboard → Aktualisierungen** und auf der Plugins-Seite.

## Weiterführende Informationen

- Quellcode auf GitHub: <https://github.com/JPKCom/jpkcom-acf-jobs>
- API-Dokumentation (PHPDoc): <https://jpkcom.github.io/jpkcom-acf-jobs/docs/>
- Voraussetzungen: [ACF Pro](https://www.advancedcustomfields.com/), [ACF Quick Edit Fields](https://wordpress.org/plugins/acf-quickedit-fields/)
- [Changelog dieses Projekts](https://www.jpkc.com/db/changelog/jpkcom-acf-jobs/)