---
title: Cache leeren und Diagnose — isla Studio
url: https://isla-stud.io/no/docs/wp2amparex/cache-leeren-und-diagnose/
date: 2026-05-30
---

# Cache leeren und Diagnose

Cache leeren und Diagnose
=========================

> **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** oder **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 **nicht**  
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

Unter **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** testen.
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](https://isla-stud.io/kontakt/) – mit WordPress-Version,  
PHP-Version, WP2Amparex-Version und (wenn möglich) einem Screenshot.