WP2Amparex

Professionelles Terminbuchungstool mit Amparex-Anbindung für WordPress.
Ermöglicht Ihren Kunden, online Termine zu buchen.

Voraussetzungen:

  1. Sie verfügen über eine funktionierende WordPress Website
  2. Sie nutzen AMPAREX und verfügen über einen funktionierenden AMPAREX API Zugang.
Fassung 2.6.1 Aktualisiert 18. Juni 2026 PHP 7.4+ Lizenz: 1 Jahr(e) 1 Datei

Änderungsprotokoll

2.6.1

Veröffentlichungsdatum: Juni 2026

  • Fix: Bei konkreten Mitarbeiter/Raum-Kombinationen sendet WP2Amparex jetzt allGivenResourcesMustBeAvailable=true an den Amparex-FreeBusy-Endpunkt.
  • Fallback: Wenn die API den AND-Pfad mit einem Fehler beantwortet oder bei vielen Kombinationen die lokale Strategie weniger API-Calls benoetigt, nutzt WP2Amparex weiterhin die lokale Schnittmenge aus Einzelressourcen.
  • Booking-Guard: Vor dem finalen Booking-Call prueft WP2Amparex den gewaehlten Mitarbeiter/Raum/Slot zuerst cachefrei ueber die Amparex-AND-Abfrage und faellt nur bei API-Fehlern auf die lokale Einzelpruefung zurueck.
  • Debug: Der Support-/Debugbereich zeigt bei kombinierten Ressourcen sichtbar, ob das AND-Flag gesendet wird.
  • Dokumentation: Die Amparex-FreeBusy-Dokumentation beschreibt Primaerpfad, Fallback und den verifizierten Vollbach/Paderborn-Regressionsfall.

2.6.0

Veröffentlichungsdatum: Juni 2026

  • Neu: Die Filialauswahl kann per validiertem Deep-Link uebersprungen werden. Der Parameter lautet wp2a_branch und erwartet die Amparex-Filial-ID.
  • Sicherheit: Die uebergebene Filial-ID wird serverseitig gegen die aktuelle Amparex-Filialliste geprueft. Ungueltige, geloeschte oder mandantenfremde IDs fallen sauber auf die normale Filialauswahl zurueck.
  • Admin-UX: Im Settings Center unter "Amparex & Terminlogik > Filialen & Berater > Filialen" zeigt jede Filiale jetzt einen fertigen Deep-Link mit "Link kopieren"-Button.
  • Navigation: Bei gueltigen Deep-Links fuehrt "Zurueck" entweder zur Referrer-Seite oder, falls kein Referrer vorhanden ist, zur normalen Filialauswahl.
  • Robustheit: Die Settings-JavaScripts werden zuverlaessiger als Inline-Adminscript ausgegeben, damit Copy-Buttons und bestehende Admin-Interaktionen stabil initialisieren.

2.5.2

Veröffentlichungsdatum: Juni 2026

  • Fix: Bei Terminen mit Mitarbeiter- und Raumressourcen wird die Amparex-Freebusy-Antwort fuer mehrere resourceIDs nicht mehr als gemeinsame Verfuegbarkeit interpretiert. Stattdessen fragt WP2Amparex Mitarbeiter und Raum einzeln ab und berechnet lokal nur echte Schnittmengen.
  • Fix: Vor dem finalen Booking-Call prueft WP2Amparex den ausgewaehlten Mitarbeiter/Raum/Slot frisch und cachefrei. Ist eine der Ressourcen nicht frei, wird die Buchung vor dem Amparex-Booking-Endpunkt abgebrochen.
  • Verbesserung: Die erste Kalenderansicht nutzt die 4-Wochen-Verfuegbarkeit effizienter und leitet die aktuelle Woche daraus ab, statt die Amparex-API doppelt fuer aktuelle Woche und Vorschau abzufragen.
  • Dokumentation: Die bestaetigte Amparex-Freebusy-OR-Semantik, der lokale AND-Workaround und der verifizierte Vollbach/Paderborn-Regressionsfall sind in Repo-Doku und Wiki dokumentiert.

2.5.1

Veröffentlichungsdatum: Mai 2026

  • Im Lizenzbereich kann jetzt manuell nach Plugin-Updates gesucht werden. Dabei wird nur der WP2Amparex-Updatecache geleert und WordPress prueft den EDD-Updatekanal neu.
  • Nach einem frischen Release koennen Installationen sofort pruefen, ob EDD / isla-stud.io die aktuelle Version ausliefert, ohne Amparex- oder Termincaches zu leeren.

2.5.0

Veröffentlichungsdatum: Mai 2026

  • Filialen koennen im Settings Center per Drag & Drop oder ueber Hoch/Runter-Buttons sortiert werden; die gespeicherte Reihenfolge wird in der Frontend-Filialauswahl angewendet.
  • Berater/Mitarbeiter koennen ebenfalls sortiert werden; die Frontend-Beraterauswahl uebernimmt die gespeicherte Reihenfolge, wenn die Beraterschritte aktiv sind.
  • Filial- und Beraterreihenfolgen werden pro verbundenem Amparex-Setup gespeichert und beim Zurueckwechseln wieder geladen.
  • Neue oder bisher nicht sortierte Amparex-Eintraege erscheinen stabil hinter den gespeicherten Positionen. Nicht mehr gelieferte Eintraege beschaedigen die Oberflaeche nicht und bleiben fuer ein spaeteres Wiederauftauchen erhalten.
  • Gespeicherte Amparex-Setups zeigen jetzt auch die Anzahl der Filial- und Beraterpositionen an und entfernen diese Daten beim gezielten Loeschen des Setups.

2.4.0

Veröffentlichungsdatum: Mai 2026

  • Terminkategorien, Tagesbeginn/Tagesende, die Option "Beraterschritte deaktivieren" sowie Filial- und Beraterbilder werden pro verbundenem Amparex-Setup gespeichert und beim Zurueckwechseln wiederhergestellt.
  • Gespeicherte Amparex-Setups koennen im Settings Center gezielt geloescht werden; betroffen sind mandantenbezogene Kategorien, Terminlogik, Filialbilder und Beraterbilder.
  • Neue Mainline-Installationen zeigen keinen vorausgefuellten Verbandskey mehr und verwenden neutrale Lizenztexte. Bereits gespeicherte Lizenzschluessel bleiben erhalten.

2.3.1

Veröffentlichungsdatum: Mai 2026

  • Fix: Bei online gebuchten Amparex-Terminen wird das Feld "Text" geleert und der Kommentar nach der Buchung auf den reinen fachlichen Buchungstext normalisiert.
  • Fix: Interne Template-, Ort- und Icon-Marker wie Ort_..., O-Service oder fas fa-... erscheinen nicht mehr am Anfang des Amparex-Kommentarfelds.

2.3.0

Veröffentlichungsdatum: Mai 2026

  • In der Übersicht zeigt die Amparex-Konfiguration bei vollständiger Verbindung jetzt den verbundenen Amparex-Mandanten statt der technischen API-URL.
  • Filial- und Beraterkacheln können optional eigene Bilder aus der WordPress-Mediathek anzeigen; ohne Zuordnung bleiben die bisherigen Icons erhalten.
  • Die Bildzuordnung ist pro Amparex-Mandant getrennt und bleibt bei geänderten technischen API-Zugangsdaten erhalten.
  • Der veraltete Einstellungsbereich für die frühere "Alle"-Option und verborgene Terminkategorien wurde entfernt.
  • Admin-Workflows, mobile Reiter, Hilfetexte sowie Support- und Designbereiche wurden geglättet.
  • Der EDD-only Release-Builder ist nicht mehr fest auf Version 2.2.0 verdrahtet und baut Stable-Artefakte aus der aktuellen Plugin-Version.

2.2.0

Veröffentlichungsdatum: März 2026

  • ACF wurde aus dem Plugin entfernt und durch ein eigenes WP2Amparex Settings Center ersetzt.
  • Bestehende ACF-Optionsdaten werden einmalig in native wp_options migriert; Legacy-Daten bleiben zunächst für Rollbacks erhalten.
  • API-Zugang, Terminlogik, Design, E-Mails, Support/Debug und Lizenzverwaltung sind jetzt in einem eigenen Adminbereich gebündelt.
  • Das Release enthält keine ACF-Runtime mehr.

2.1.0

Veröffentlichungsdatum: Januar 2026

  • Lizenz und Updates laufen jetzt ueber EDD / isla-stud.io.
  • Freemius und Kestrel sind aus dem gepflegten Release-Zweig entfernt.
  • Der Lizenzstatus beeinflusst nur Updates und Admin-Notices; Einstellungen und Frontend bleiben immer zugänglich.

2.0.1

Veröffentlichungsdatum: Februar 2026

  • Neue Brueckenversion fuer Bestandskunden auf dem alten Freemius-Kanal.
  • Wird aus dem aktuellen refaktorierten Code gebaut und enthaelt bereits den EDD-Lizenz- und Updatepfad.
  • Freemius bleibt nur fuer diesen einen Update-Sprung enthalten; danach folgt der Wechsel auf isla-stud.io / EDD.

2.0.0

Veröffentlichungsdatum: Januar 2026

Version 2.0.0 ist eine umfassende Überarbeitung von WP2Amparex. Der gesamte Buchungsablauf wurde technisch neu aufgebaut, zahlreiche Verbesserungen für Endnutzer eingeführt und die Wartbarkeit des Codes deutlich erhöht.

Lizenz und Einstellungen

  • Neues eigenes Menü "WP2Amparex" im WordPress-Backend.
  • Die refaktorierte Codebasis bildet die Grundlage fuer den spaeteren Freemius->EDD-Wechsel.

Buchungsablauf – angenehmer für Nutzerinnen und Nutzer

  • Wenn nur eine Filiale existiert, wird der Schritt "Filiale wählen" übersprungen; die Buchung startet direkt mit der Terminkategorie.
  • Wenn in der ersten angezeigten Kalenderwoche keine buchbaren Termine mehr sind (z. B. alles schon vergeben), springt der Kalender automatisch zur ersten Woche, in der noch Termine frei sind – sowohl mit als auch ohne Wunschberater.
  • Die Kalenderansicht hat nun durchgängig gleiche Spaltenhöhen pro Tag; Überlappungen bei Terminblöcken (z. B. "belegt" und "frei") werden sauber dargestellt.

Terminslots und Anzeige

  • Verbesserte Erkennung freier Termine: Alle relevanten Räume (inkl. Räume mit individuellen Kennungen im "description"-Feld in Amparex wie "Ort_1", "Ort_2") werden bei der Suche nach freien Slots berücksichtigt. Dadurch werden buchbare Termine zuverlässiger angezeigt.
  • Debug-Fenster (wenn in den Einstellungen aktiviert): Erweiterte Übersicht zu Filialen, Ressourcen und ein Freebusy-Tester für Mitarbeiter und Räume.

Cache und Aktualität

  • Neuer Button "WP2Amparex Cache leeren" auf der Einstellungsseite. Nach Änderungen in Amparex (z. B. neue Termine, geänderte Öffnungszeiten) oder nach Anpassung der API- oder Mandanteneinstellungen kann der Plugin-Cache gezielt geleert werden, damit sofort die neuesten Daten geladen werden.

Stabilität und WordPress-Website-Zustand

  • Das Plugin startet keine PHP-Sitzung mehr bei jedem Seitenaufruf. Die bisherige Meldung im WordPress-"Website-Zustand" zu offenen PHP-Sitzungen und deren Auswirkung auf REST-API und Loopback-Anfragen entfällt damit.

Technische Anpassungen

  • Höhere Mindestanforderungen: WordPress 6.0, PHP 7.4.
  • Intern: Neu strukturierter Code (z. B. zentrale Ajax-Steuerung, eigene Dienste für Cache, Amparex-Anbindung und Slot-Suche), bessere Wartbarkeit und Vorbereitung für künftige Erweiterungen.

1.6.0

Veröffentlichungsdatum: 29. Oktober 2024

  • Third Party Security Update: ACF Pro 6.3.9
  • Third Party Security & Feature Update: Freemius SDK 2.9.0

1.5.6

Veröffentlichungsdatum: 9. Juli 2024

  • Improvement: verbesserte Navigierbarkeit auf Touch-Endgeräten
  • Third Party Update: ACF Pro 6.3.3
  • Third Party Update: Freemius SDK 2.7.3

1.5.2

Veröffentlichungsdatum: 24. Juni 2024

  • kleines Feature: Nach Filialauswahl werden nur diejenigen Terminkategorien angezeigt, die in der ausgewählten Filiale verfügbar sind.
  • Fix: Die in der Filialaddresse hinterlegte Admin-E-Mail-Adresse wurde nicht korrekt verwendet. Dies ist jetzt behoben.
  • Fix: Wenn das Anrede-Feld nicht ausgewählt wird erhält der Benutzer erwartungsgemäß eine Fehlermeldung. Nachdem das Anrede-Feld anschließend korrekt ausgewählt wurde, wurde der Benutzer auf eine 404-Fehlerseite geleitet, anstatt den Termin einzubuchen. Dieses Verhalten ist jetzt korrigiert.
  • Third Party Update: ACF Pro 6.3.1.2

1.4.4

Veröffentlichungsdatum: 17. Mai 2024

  • Improvement: Fehlerbehandlung bei fehlenden Amparex-Einstellungen.

1.4.3

Veröffentlichungsdatum: 17. Mai 2024

  • Fix: PHP Ausgabebuffer höher priorisiert, da in spezifischen Setups in der Kombination mit bestimmten Frontend-Pagebuildern der Fehler "Headers already sent" im PHP ausgelöst wurde.

1.4.2

Veröffentlichungsdatum: 17. Mai 2024

  • Third Party Update: ACF Pro 6.2.10

1.4.1

Veröffentlichungsdatum: 17. Mai 2024

  • Third Party Update: Freemius SDK 2.7.2

1.4.0

Veröffentlichungsdatum: 17. Mai 2024

  • Improvement: Touch Events auf mobilen Endgeräten mit Touchscreens deutlich verbessert.
  • Fix: kleinere Codefixes
  • kleines Feature: Es ist jetzt möglich die Schritte bzgl. der Beraterauswahl bzw. Wunschberaterauswahl zu überspringen. Es gibt hierfür jetzt eine entsprechende Auswahlcheckbox in den Plugineinstellungen im Reiter "Amparex API".

1.3.0

Veröffentlichungsdatum: 20. April 2024

  • Fix: Der Lade-Indikator war teilweise nicht im sichtbaren Fensterbereich.
  • Fix: kleinere Codefixes
  • kleines Feature: Die Anzeige des Raums in der Admin-E-Mail kann jetzt über die Pluginoptionen individuell gesteuert werden.
  • Third Party Update: ACF Pro 6.2.9
  • Third Party Update: Freemius SDK 2.7.0
  • Kompatibilät und Tests mit WordPress 6.5.x

1.2.0

Veröffentlichungsdatum: 21. März 2024

  • Verbesserung: Das Buchungsformular hat jetzt auch ein Auswahlfeld für die Anrede.
  • Bei der Terminbuchung wird neben der Anrede jetzt auch die Information in das Terminkommentarfeld übergeben, ob die aktuelle Terminbuchung mit Wunschberaterwahl getätigt wurde oder nicht. Bisher wurde diese Information lediglich per E-Mail kommuniziert.
  • Die Übermittlung von Anrede, Vorname, Nachname, E-Mail und Telefonnummer an Amparex erfolgt jetzt ohne Leerzeichen zwischen Bezeichner und Detail (Bspw. Anrede:Frau, Vorname:Jutta, etc.). So ist es noch einfacher diese Angaben direkt in Amparex aus dem Termin in einen neuen Kunden zu ziehen.

1.1.9

Veröffentlichungsdatum: 19. März 2024

  • Fix: "Headers already sent" bei Vorhandensein von nur 1 Filiale

1.1.8

Veröffentlichungsdatum: 28. Februar 2024

  • Third Party Security Update: ACF Pro 6.2.7

1.1.7

Veröffentlichungsdatum: 24. Januar 2024

  • Verbesserung: wenn kein bestimmter Berater ausgewählt wurde, werden jetzt die freien Terminslots des Berater angezeigt, bei dem der zeitlich nächste freie Slot im Kalender vorhanden ist. Bisher wurde hierzu keine Prüfung durchgeführt, sondern sofort die freien Terminslots des Beraters angezeigt, für den die Amparex API während der Abfrage als erstes valide Slotergebnisse zurückgab.

1.1.6

Veröffentlichungsdatum: 24. Januar 2024

  • Hotfix: mehrere Ortsressourcen-IDs in Terminvorlagen-HTML ermöglicht.

1.1.5

Veröffentlichungsdatum: 23. Januar 2024

  • Verbesserung: Mitarbeiter und Filialverfügbarkeitsprüfung, wenn eine Mitarbeiterressource einerseits explizit für die Sichtbarkeit bestimmten Filialen markiert ist, aber andererseits zusätzlich für die Sichtbarkeit in allen Filialen markiert wurde. Dann kam es zu unerwünschtem Verhalten bei der Anzeige von Slots im Terminkalender.

1.1.4

Veröffentlichungsdatum: 19. Januar 2024

  • Verbesserung: Ortsressourcen und Filialverfügbarkeitsprüfung

1.1.3

Veröffentlichungsdatum: 17. Januar 2024

  • Feature Update: Ortsressourcen werden jetzt bei der Terminbuchung mit eingebucht, falls erforderlich und in Amparex korrekt bepflegt. Hierfür muss im Feld description (Beschreibung) in der (Orts-)Ressource das Wort "Ort_" vorkommen. der Textteil nach dem Unterstrich ist frei wählbar, darf aber keine Sonderzeichen, Leerzeichen oder Umlaute enthalten. Beispiel: Ort_1 oder Ort_2 oder Ort_BueroMueller oder Ort_Kabine1 etc. Zudem muss im Feld comment (Kommentar) ebenfalls eingetragen werden, welche Ortressource bei der Buchung benötigt wird. Hier können gezielt eine oder mehrere Ortsressourcen-Beschreibungstags (Ort_1 Ort_2 Ort_Kabine3 etc.) eingefügt werden. Die Eintragungen sind mit Leerzeichen zu trennen. Wenn alle Ortsressourcen zur Einbuchung erlaubt sind, reicht die Eintragung des Worts Ort_alle
  • Code Cleanup
  • Third Party Update: ACF Pro 6.2.5
  • Third Party Update: Freemius SDK v.2.6.2

1.0.7.3

Veröffentlichungsdatum: 12. Dezember 2023

  • Hotfix: Wenn kein Wunschberater ausgewählt wurde und zeitgleich eine Ressource vorhanden ist, die kein Mitarbeiter aber für Online-Terminbuchung dennoch aktiviert ist, wurde der gewählte Termin immer in diese Ressource eingebucht, obwohl der gewählte Terminslot nicht zum Terminkalender dieser Ressource gehörte. Dieses Update sollte dieses Problem beheben. Dieser Version ist ein Beta-Update und wartet auf Freigabe für die allgemeine Veröffentlichung.

1.0.7

Veröffentlichungsdatum: 7. Dezember 2023

  • Improved and Fixed: Session Handling

1.0.6

Veröffentlichungsdatum: 4. Dezember 2023

  • Freemius Code Framework Update v.2.6.1

1.0.5

Veröffentlichungsdatum: 28. November 2023

  • Verbesserung: Designfarbe bzw. Pluginstile werden auf Grundelemente wie Anchor-Tags oder Button-Tags (Links und Buttons) nur dann angewendet, wenn in den Plugineinstellungen die neue Checkbox "Sollen Theme-Stile überschrieben werden?" im Designtab angehakt ist.

1.0.4

Veröffentlichungsdatum: 28. November 2023

  • Font Awesome Pro v. 5.15.4 ist in diesem Plugin eingebunden und sollte jetzt korrekt verwendet werden.
  • Es gab eine Logikänderung in Bezug auf die E-Mails, die nach dem Ausfüllen des Buchungsformulars versendet werden: Der WordPress-Admin erhält jetzt nur noch dann eine Adminmail, wenn weder eine Filial-E-Mail-Adresse in Amparex vorhanden ist, noch eine zusätzliche E-Mail-Adresse in den WP2Amparex Einstellungen eingefügt wurde.
  • Linkfarben: die Textfarbe für Verlinkungen wird vom jeweilig installierten Theme bzw. Elementor vorgegeben. Bitte prüfen Sie diese Einstellung in Ihrem Theme bzw. Ihrem Elementor und stellen Sie die Textfarbe für Verlinkungen dort ein. Dieses Plugin definiert keine Linkfarben, da dies Teil der Themelogik sein sollte.

1.0.3

Veröffentlichungsdatum: 27. November 2023

  • Kleine Verbesserungen bzgl. PHP Kompatibilitäten (mind. 7.1 erforderlich. aber auch kompatibel mit 8.0 und 8.1)

1.0.1

Veröffentlichungsdatum: 26. November 2023

  • Native Updatefähigkeit integriert / Freemius

1.0.0

Veröffentlichungsdatum: 22. November 2023

  • Erstversion nach RC v.0.2.8

Ressourcen