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.
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 (v6.0+)
- ACF Quick Edit Fields (für Inline-Bearbeitung)
Optional: WPML für mehrsprachige Stellenanzeigen.
Installation
- Lade die aktuelle Release-ZIP von der GitHub-Releases-Seite herunter.
- Im Admin-Bereich: Plugins → Installieren → Plugin hochladen, ZIP wählen, Jetzt installieren, dann Aktivieren.
- 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:
cd /pfad/zu/wordpress/wp-content/plugins/
git clone https://github.com/JPKCom/jpkcom-acf-jobs.gitAuf 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:
- Lege unter Locations → Erstellen einen Standort an.
- Lege unter Companies → Erstellen ein Unternehmen an.
- 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).
- 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):
[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:
[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):
- Child-Theme (empfohlen): Templates aus
plugins/jpkcom-acf-jobs/templates/nachdein-child-theme/jpkcom-acf-jobs/kopieren. - Parent-Theme: nach
dein-theme/jpkcom-acf-jobs/. - MU-Plugin: nach
mu-plugins/jpkcom-acf-jobs-overrides/templates/für seitenweite Anpassungen.
- Child-Theme (empfohlen): Templates aus
- Pfade programmatisch erweitern: Über die Filter
jpkcom_acf_jobs_template_pathsbzw.jpkcom_acfjobs_file_pathslassen sich eigene Verzeichnisse voranstellen;jpkcom_acf_jobs_final_templateerlaubt 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 mitjpkcom_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.xmlsind 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, ACF Quick Edit Fields
- Changelog dieses Projekts