Vaciar la caché y diagnóstico

Faustregel: Wenn nach einem Update, einer Konfigurationsänderung in
Amparex oder einem Pluginwechsel etwas nicht stimmt, erst den Cache
leeren – in vielen Fällen ist das schon die Lösung.

Wofür der Cache da ist

WP2Amparex fragt Amparex nicht bei jedem Klick neu nach Filialen,
Kategorien, Mitarbeitenden oder Vorlagen. Stattdessen werden diese Listen
kurzzeitig zwischengespeichert (über die WordPress-Transients-API),
damit Ihre Buchungsseite schnell bleibt und die Amparex-API nicht unnötig
belastet wird.

Das funktioniert in 99 % der Fälle reibungslos. Nach Änderungen in Amparex
oder nach Pluginupdates kann es aber sein, dass der zwischengespeicherte
Stand veraltet ist.

Cache leeren – so geht's

  1. WordPress-Admin → WP2Amparex → Support / Debug
  2. Auf den Button WP2Amparex Cache leeren klicken
  3. Eine grüne Meldung „WP2Amparex Cache wurde geleert" erscheint
  4. Frontend in einem Inkognito-Fenster neu laden, damit auch der
    Browser-Cache umgangen wird

Der Cache-Button ist seit Version 2.0.0 Bestandteil des Plugins.
Im Support-Tab sehen Sie zusätzlich den Cache-Status:

  • wann der WP2Amparex-Cache zuletzt geleert wurde,
  • wie viele WP2Amparex-Transient-Einträge aktuell gespeichert sind,
  • ob WordPress einen externen Object-Cache verwendet. Bei externem
    Object-Cache ist der Transient-Zähler nicht aussagekräftig; in diesem
    Fall zusätzlich den Object-Cache der Website leeren.

Wann den Cache leeren?

Immer dann, wenn Sie in Amparex etwas geändert haben, das sich auf die
Buchungsmaske auswirkt:

  • Neue oder geänderte Filialen, Adressdaten, Filial-Mail-Adressen
  • Neue oder geänderte Terminkategorien
  • Neue oder geänderte Mitarbeitende oder deren Online-Sichtbarkeit
  • Neue oder geänderte Terminvorlagen o Ortsressourcen
  • Geänderte Öffnungszeiten oder Abwesenheits-/Urlaubsblöcke
  • Geänderte API-Zugangsdaten in den WP2Amparex-Einstellungen

Außerdem nach jedem WP2Amparex-Plugin-Update, wenn das Update interne
Änderungen an Slot-Logik oder Cache-Schema enthält (siehe Changelog).

Plugin-Updates neu prüfen

Der normale WP2Amparex Cache leeren-Button betrifft Amparex-Daten wie
Filialen, Kategorien, Mitarbeitende, Vorlagen und Slots. Er fragt no
gezielt den Plugin-Updatekanal neu ab.

Seit Version 2.5.1 gibt es dafür einen eigenen Button:

  1. WordPress-Admin → WP2Amparex → Lizenz & Updates
  2. Auf Jetzt nach Plugin-Updates suchen klicken
  3. WP2Amparex leert nur den eigenen Updatecache und den WordPress-Plugin-
    Update-Transient
  4. WordPress fragt EDD / isla-stud.io sofort neu nach verfügbaren Versionen

Das ist besonders hilfreich direkt nach einem frischen Release oder wenn
eine Kundenseite ein Update nicht sofort sieht.

Dieser Button verändert nicht:

  • Lizenzschlüssel oder Lizenzstatus;
  • Amparex-Verbindungsdaten;
  • Termin-, Filial-, Kategorie- oder Slot-Caches.

Diagnose-Werkzeuge

Eingebautes Debug-Fenster

En WP2Amparex → Einstellungen lässt sich an einer Stelle der
Debug-Modus aktivieren. Anschließend sehen Sie auf der Buchungsseite
(und/oder im Admin) zusätzliche Hinweise:

  • Übersicht aller in Amparex sichtbaren Filialen und Mitarbeitenden
  • Online-/Offline-Status pro Ressource
  • Freebusy-Tester, mit dem Sie für eine konkrete Mitarbeitenden- oder
    Raumkennung direkt prüfen können, ob für ein gewähltes Zeitfenster
    Slots als „frei" geliefert werden

Den Debug-Modus für den produktiven Live-Betrieb bitte wieder ausschalten –
er ist als Diagnose-Modus gedacht, nicht für Endkund:innen.

Browser-Konsole (für IT-Affine)

Wenn der Wizard nicht weitergeht:

  1. F12-Taste / Rechtsklick → Untersuchen → Tab Konsole
  2. Roten Fehler kopieren (typische Hinweise: wp2a_get_* AJAX-Aufruf
    schlägt fehl, JSON-Parse-Fehler, fehlende Berechtigung)
  3. Außerdem Tab Netzwerk: die Aufrufe an admin-ajax.php zeigen den
    exakten Statuscode (200, 403, 500) und die Antwort

Diese Informationen sind die schnellste Brücke zum Support oder zum
Support.

Wenn der Cache-Flush nicht reicht

Versuchen Sie der Reihe nach:

  1. WordPress-Object-Cache leeren (falls ein Caching-Plugin installiert ist,
    z. B. WP Rocket, W3 Total Cache, LiteSpeed Cache, FastCGI-Cache).
  2. Browser-Cache leeren oder direkt im Inkognito-Fenster Probar.
  3. Lizenzstatus prüfen unter WP2Amparex → Lizenz & Updates – ein
    abgelaufener Schlüssel verhindert Updates, kein Verhalten in der
    Buchung.
  4. Bei Updateproblemen im selben Tab Jetzt nach Plugin-Updates suchen
    klicken.
  5. API-Zugangsdaten in den Einstellungen erneut speichern – ein
    versehentliches Leerzeichen am Anfang oder Ende ist ein häufiger Grund
    für „Verbindung fehlgeschlagen".
  6. Mandantenkonfiguration prüfen: sind die Mitarbeitenden-Ressourcen
    in Amparex für Online-Terminbuchung freigegeben? Sind die
    Ortsressourcen mit Ort_…-Tags korrekt verknüpft?

Wenn nach diesen Schritten der Fehler weiter auftritt, schreiben Sie bitte an
den Support – mit WordPress-Version,
PHP-Version, WP2Amparex-Version und (wenn möglich) einem Screenshot.