Über dieses Plugin

IDF vCard verbindet ACF-Felder einer Profilseite mit dem vCard-3.0-Standard. Im Plugin-Admin werden benannte Mapping-Sets gepflegt; auf der Profilseite wählt der Shortcode das Set per set-Attribut aus und liefert QR-Code und .vcf-Download. Leere oder nicht gemappte Felder bleiben in der vCard weg.

Features

  • Mapping-Sets: Pro Set ein Name, ein Slug und eine ACF-zu-vCard-Tabelle. Sets sind nicht an einen CPT gebunden: Derselbe Slug kann auf beliebigen Profilseiten genutzt werden.
  • Bezugs-CPT (optional): Filtert die ACF-Feld-Auswahl im Editor auf einen Post-Type, damit das Mapping übersichtlich bleibt. Im Frontend irrelevant.
  • vCard 3.0 nach RFC 2426: Strukturierte N- und ADR-Properties, Telefon-/E-Mail-Typen, X-SOCIALPROFILE für LinkedIn, Xing, GitHub, Bluesky, Mastodon.
  • QR-Code als Inline-SVG: Shortcode [idf_vcard_qr set="..."] rendert die vCard direkt auf der Seite (SVG-Erzeugung über das Plugin IDF QR-Codes).
  • .vcf-Download mit Foto: Shortcode [idf_vcard_download set="..."] liefert die vollständige vCard inklusive PHOTO und LOGO aus ACF-Bildfeldern.
  • Globale QR-Defaults: Größe, Fehlerkorrektur, Farben und Quiet-Zone zentral einstellbar, pro Shortcode-Aufruf überschreibbar.
  • Filter für Entwickler: idf/vcard/properties, idf/vcard/build, idf/vcard/qr_options, idf/vcard/filename.
  • Voraussetzungen: WordPress 6.0+, PHP 8.1+, Advanced Custom Fields, IDF QR-Codes 1.1.0+. Optional IDF Home für Lizenzprüfung und automatische Updates.

Changelog

v0.3.1

Behoben

  • Der Dependency-Checker heisst jetzt IDF_VCARD_Dependency_Checker. Der geteilte Klassenname IDF_Dependency_Checker, den fast alle IDF-Plugins mitbringen, wird nicht mehr angefasst. Die eigene Kopie war durch ihre bedingte Deklaration selbst geschuetzt, wirkte aber als Ausloeser: sobald sie die geteilte Klasse zuerst deklarierte, starb die frueh gebundene Kopie eines anderen IDF-Plugins. Sobald ein zweites IDF-Plugin dieselbe Klasse deklarierte, starb jeder Request mit "Cannot declare class IDF_Dependency_Checker" - auf k1.de hat das am 03.09.2026 zweimal die ganze Website lahmgelegt, weil die Aktivierung durchlief und der Fehler erst im Folge-Request entstand. Die Installationsreihenfolge der IDF-Plugins ist damit ohne Bedeutung.

v0.3.0

Geändert

  • Admin-Menü: ein Eintrag unter IDF Home statt eines eigenen Top-Level-Menüs mit vier Untereinträgen. Einstellungen, Hilfe und Deinstallation sind jetzt Reiter auf der Mapping-Sets-Seite.
  • Ohne IDF Home bleibt das eigene Top-Level-Menü als Rückfalloption erhalten, mit derselben Oberfläche.
  • Alle bisherigen Seiten-URLs bleiben gültig.

v0.2.0

Geändert

  • Mappings sind jetzt eigenständige Sets mit Namen und Slug - im Shortcode per set="..." gewählt, nicht länger automatisch über den Post-Type aufgelöst.
  • Set-Editor hat einen optionalen Bezugs-CPT, der die ACF-Feld-Auswahl im Editor filtert. Im Frontend bleibt das Set CPT-agnostisch.
  • Admin-Bereich: Übersicht aller Sets mit Bearbeiten/Löschen/Neu-Anlegen statt CPT-Tabs.

v0.1.0

Hinzugefügt

  • ACF-Felder werden auf vCard-3.0-Properties gemappt; leere Felder bleiben in der vCard weg.
  • vCard als Inline-SVG-QR-Code und als .vcf-Download auf jeder Profilseite.
  • Foto und Logo aus ACF-Bildfeldern landen im Download-vCf, nicht im QR.
  • Admin-Bereich „vCards" mit Mapping-Editor, globalen QR-Defaults und Hilfe-Seite.

0 Comments

Info
  • Version: 0.3.1
  • Version vom: 3. September 2026
  • WordPress-Version: 6.0
  • Getestet bis WP-Version: 6.5
  • PHP-Version: 8.1
  • Kompatible Themes: alle
  • Erforderliche Plugins: Advanced Custom Fields (ACF)
  • Mitwirkende: Joerg Martin