Charitable Pro ab 1.8.13 beinhaltet ein zentrales Protokollsystem , das Plugin-Protokolleinträge in Ihrer Datenbank speichert und einen Admin-Bildschirm zur Anzeige, Filterung, Suche und zum Export bereitstellt. Der Support bittet Sie möglicherweise, Protokolle von diesem Bildschirm aus zu überprüfen oder zu exportieren, wenn Sie Probleme wie Spendenfehler, Zahlungs-Gateway-Fehler oder Formularvalidierungsprobleme beheben.

Wo Protokolle zu finden sind

1. Gehen Sie im WordPress-Admin zu Charitable → Tools.
2. Klicken Sie auf die Registerkarte Logs.

Sie sehen die Protokolleinstellungen und, wenn die Protokollierung aktiviert ist und Einträge vorhanden sind, eine Tabelle mit Protokollsätzen.

Protokollierung aktivieren

Die Protokollierung ist standardmäßig deaktiviert.

1. Schalten Sie unter Tools → Logs die Option Enable Logging ein.
2. Ab diesem Zeitpunkt werden Protokolleinträge aufgezeichnet. Bestehende Einträge (falls vorhanden) bleiben sichtbar, bis sie gelöscht oder durch die Aufbewahrungseinstellung entfernt werden.

Wenn die Protokollierung deaktiviert ist, werden keine neuen Einträge geschrieben. Sie können alle Protokolle, die erfasst wurden, bevor Sie sie deaktiviert haben, weiterhin anzeigen und exportieren.

Automatische Löschung (Aufbewahrung)

Verwenden Sie Automatisch löschen nach , um zu steuern, wie lange Protokolleinträge aufbewahrt werden:

• Optionen: 7, 14, 30, 60 oder 90 Tage.
• Einträge, die älter als der ausgewählte Zeitraum sind, werden bei einer täglichen Bereinigung automatisch gelöscht.

Dies hilft, die Datenbankgröße zu begrenzen und gleichzeitig aktuelle Protokolle für die Fehlerbehebung aufzubewahren.

Protokolle anzeigen

Die Protokolltabelle zeigt:

• Titel – Kurze Zusammenfassung des Protokolleintrags (klicken Sie zum Öffnen der Details).
• Nachricht – Gekürzter Nachrichtentext.
• Typen – Kategorie des Protokolls (z. B. Spende, Zahlung, Gateway, Fehler, Formular).
• Level – Schweregrad: Fehler, Warnung, Info oder Debug.
• Quelle – Woher das Protokoll stammt (z. B. Core, Stripe, PayPal, Formular).
• Datum – Wann der Eintrag erstellt wurde.

Klicken Sie auf einen Titel , um eine Detailansicht in einem Modal zu öffnen. Die Detailansicht zeigt die vollständige Nachricht, Datum, Level, Typen, Quelle und alle verknüpften Datensätze (z. B. Kampagnen-ID, Spenden-ID, Spender-ID) mit Links zu diesen Elementen im Admin.

Filtern und Suchen

Über der Tabelle können Sie Einträge eingrenzen:

• Typ – Filtern nach Protokolltyp (Spende, Zahlung, Gateway, Fehler, Formular usw.).
• Level – Filtern nach Level (Fehler, Warnung, Info, Debug).
• Quelle – Filtern nach Quelle (Core, Stripe, PayPal, Formular usw.).
• Suchen – Verwenden Sie das Feld „Protokolle durchsuchen“, um den Protokollinhalt zu durchsuchen.

Klicken Sie auf Filtern, um die Dropdowns anzuwenden. Verwenden Sie das Suchfeld und senden Sie, um zu suchen. Filtern und Suchen arbeiten zusammen. Sie können die Sortierung nach Datum (und anderen verfügbaren Spalten) mithilfe der Spaltenüberschriften vornehmen.

Protokolle exportieren

Der Export ist nützlich, wenn der Support Sie bittet, Protokolle für ein bestimmtes Problem zu senden.

• Gefiltert exportieren (CSV) – Exportiert nur die Zeilen, die den aktuellen Filtern und der Suche entsprechen. Wenden Sie zuerst Ihre Filter an und klicken Sie dann auf diese Schaltfläche.
• Alle exportieren (CSV) – Exportiert alle Protokolleinträge in der Datenbank (unter Berücksichtigung der Aufbewahrungsfrist; ältere Einträge wurden möglicherweise bereits gelöscht).

Die CSV-Datei kann in einer Tabellenkalkulation oder einem Texteditor geöffnet und an ein Support-Ticket angehängt oder wie gewünscht geteilt werden.

Protokolle löschen

• Alle Protokolle löschen – Entfernt dauerhaft alle Protokolleinträge aus der Datenbank. Verwenden Sie dies, wenn Sie alte Protokolle löschen oder neu beginnen möchten. Diese Aktion kann nicht rückgängig gemacht werden.

Wenn der Support nach Protokollen fragt

Wenn Sie ein Problem beheben:

1. Gehen Sie zu Charitable → Tools → Protokolle.
2. Stellen Sie sicher, dass Protokollierung aktivieren eingeschaltet ist, damit zukünftige Ereignisse aufgezeichnet werden (falls der Support das Problem reproduzieren muss).
3. Verwenden Sie Typ, Level und Quelle, um den relevanten Bereich einzugrenzen (z. B. Fehler + Gateway für Zahlungsprobleme).
4. Verwenden Sie Suchen, um Meldungen zu finden, die einen Fehlercode, einen Gateway-Namen oder einen Zeitrahmen erwähnen.
5. Klicken Sie auf einen Titel, um die vollständige Meldung und Zugehörige Datensätze (Kampagne, Spende, Spender) zu öffnen, falls dies zur Beschreibung des Problems beiträgt.
6. Klicken Sie auf Gefiltert exportieren (CSV) oder Alle exportieren (CSV) und senden Sie die Datei wie angewiesen an den Support.

Wenn die Protokollierung beim Debuggen aktiviert bleibt, können neue Fehler erfasst und dann von diesem Bildschirm aus angezeigt oder exportiert werden.

Voraussetzungen

• Charitable Pro: Version 1.8.13 oder höher
• WordPress: Version 6.2 oder höher
• PHP: Version 7.4 oder höher

Der Protokoll-Tab erscheint unter Charitable → Tools im WordPress-Adminbereich. Wenn Sie ihn nicht sehen, bestätigen Sie, dass Sie Charitable Pro 1.8.13 oder neuer verwenden und dass Ihre Benutzerrolle Zugriff auf Charitable-Tools hat.