# Häufige Fragen und Fehlerbehebung

Antworten auf häufige Fragen und die schnellsten Wege zur Fehlerbehebung.

## Im Builder erscheint keine Notion-Quelle

- Ist ein **YOOtheme-Pro-Template** aktiv? Ohne YOOtheme gibt es keine Builder-Quelle.
- Ist das Plugin *System - Notion Source* unter *System → Plugins* aktiviert?
- Ist ein **Token** eingetragen? Ohne Token wird die Quelle nicht geladen.

## Das Datenbank-Auswahlfeld ist leer

- Ist der Token gültig (beginnt mit `ntn_` oder `secret_`)? Ein ungültiges Format meldet das Plugin beim Speichern.
- Haben Sie die Datenbanken der Integration **freigegeben**? Das ist der häufigste Grund — siehe [Die Notion-Integration einrichten](https://docs.graup-it.de/books/notion-source/page/die-notion-integration-einrichten).
- Speichern Sie das Plugin erneut, um das Schema neu aufzubauen.

## Eine neue Notion-Eigenschaft fehlt im Builder

Das Schema wird beim Speichern des Plugins eingelesen. Nach Änderungen in Notion (neue Spalte, Umbenennung, neue freigegebene Datenbank) **speichern Sie das Plugin einmal erneut** — danach stehen die neuen Felder zur Verfügung.

## Ein Feld bleibt leer

- Gehört das Feld zur **gewählten Datenbank**? Der Builder zeigt die Felder aller Datenbanken gemeinsam; ein fremdes Feld liefert leer.
- Stimmt bei Filtern der **Property-Name** exakt (Groß-/Kleinschreibung, Leerzeichen) und passt der gewählte **Property-Typ** zum Feld in Notion?

## Änderungen in Notion erscheinen verzögert

Die API-Antworten werden für die eingestellte *Cache-Dauer* (Standard 5 Minuten) zwischengespeichert. Für schnellere Aktualisierung senken Sie den Wert; zum sofortigen Test können Sie ihn kurzzeitig auf 0 setzen (auf Produktivseiten nicht dauerhaft empfehlenswert).

## Das Update wird nicht gefunden oder schlägt fehl

- Klicken Sie zuerst auf *Auf Updates prüfen*, um den Zwischenspeicher zu aktualisieren.
- Ist der **Download-Schlüssel** bei der Update-Quelle eingetragen — und **ohne Leerzeichen** am Anfang oder Ende? Ein mitkopiertes Leerzeichen führt zu „Paketdownload fehlgeschlagen".
- Notfalls die neue Version manuell herunterladen und über *System → Installieren* einspielen.

## Ein Bild aus Notion wird nach einiger Zeit nicht mehr angezeigt

Von Notion gehostete URLs hochgeladener Dateien sind zeitlich befristet. Verwenden Sie für dauerhafte Bilder eine externe URL in Notion oder den Joomla-Medienmanager.

<small>Gilt für Version 1.2.2.</small>