Fehlerbehebung

Diese Seite sammelt die Probleme, die im Live-Betrieb am häufigsten auftreten — jeweils mit einer kurzen Diagnose und einer konkreten Lösung. Richtet sich an alle, denen in einer Live-Galerie etwas Unerwartetes begegnet — fang hier an, bevor du ein Support-Ticket aufmachst.

Was du lernst

• Warum Thumbnails manchmal verschwinden und wie du OAuth-Tokens erneuerst
• Wie du eine Galerie beschleunigst, die sich zäh anfühlt
• Warum Druckshop-E-Mails nicht ankommen und wie du die Zustellung in den Griff bekommst
• Wie du dich von einem OAuth-Redirect-Mismatch erholst
• Wie du ein fehlerhaftes Plugin-Update zurücksetzt

Voraussetzungen

• Plugin installiert und aktiviert
• Admin-Zugang zur WordPress-Seite

Tutorial-Video

Video kommt bald.

Bilder werden nicht angezeigt

Diagnose. Drei typische Ursachen: (1) das OAuth-Refresh-Token ist abgelaufen (am häufigsten, wenn du im Drive-Consent-Screen „Publish App” übersprungen hast und die Verbindung 7 Tage nicht genutzt wurde); (2) der Quell-Ordner wurde umbenannt, verschoben oder seine Freigabe-Einstellungen wurden in der Cloud geändert; (3) die Datei liegt in einem Format vor, das der Browser nicht rendert (HEIC in älteren Browsern, RAW-Dateien).

Lösung.

1. Gehe zu Customer Cloud Gallery → Einstellungen, scrolle zu deinem Anbieter und prüfe den Verbindungsstatus. Steht dort Getrennt, klicke erneut auf Verbinden.
2. Speziell für Drive: Stelle sicher, dass du im OAuth-Consent-Screen Publish App geklickt hast — siehe Google Drive einrichten, Schritt 4.
3. Bestätige, dass der Ordner noch unter demselben Pfad/derselben ID existiert und Bilddateien enthält. Hast du den Ordner verschoben, füge die neue ID im Galerie-Editor ein.
4. Bei HEIC entweder vor dem Hochladen in JPEG umwandeln oder in Safari/iOS testen, wo HEIC nativ unterstützt wird. Das Plugin streamt, was die Cloud zurückgibt — es transkodiert nicht.

Langsame Galerie

Diagnose. Der erste Aufruf ist immer langsamer, weil Thumbnails von Drive/Dropbox geholt und lokal gecacht werden. Ab dem zweiten Besucher kommt der lokale Cache zum Einsatz und alles lädt schnell. Bleibt es auch bei wiederholten Besuchen langsam, ist meist ein Caching-Plugin-Konflikt oder ein nicht optimiertes Original schuld.

Lösung.

1. Rufe die Galerie selbst einmal auf (im Inkognito-Fenster), bevor du den Link an die Kundschaft schickst — das wärmt den Cache vor.
2. Stelle sicher, dass dein Caching-Plugin (WP Rocket, W3 Total Cache, LiteSpeed) /wp-content/plugins/customer-cloud-gallery/ nicht vom Caching ausschließt.
3. Wenn deine Originale 50–100 MB große RAWs oder 24-Megapixel-JPEGs sind, exportiere Kunden-Lieferungen lieber mit 12–16 MP — Besucher laden zwar Originale herunter, aber Thumbnails sind unabhängig von der Originalgröße, und auch deine Server-Bandbreite hängt nicht an der Originalgröße (Originale werden direkt aus der Cloud gestreamt).

Druckshop-E-Mails kommen nicht an

Diagnose. Fast immer ein Zustell-Problem von wp_mail() und kein Plugin-Bug. Shared-Hoster verweigern oft den Versand aus PHP, oder die Nachricht landet im Spam, weil sie von wordpress@deinedomain.de ohne SPF-/DKIM-Eintrag kommt.

Lösung.

1. Installiere ein SMTP-Plugin: WP Mail SMTP, FluentSMTP oder Post SMTP.
2. Konfiguriere es mit einem Transactional-Mail-Service (SendGrid, Mailgun, Brevo, Amazon SES, Postmark — alle haben kostenlose Tarife).
3. Sende eine Test-Mail, um die Zustellung zu prüfen.
4. Schau im Spam-Ordner deiner Kundschaft beim ersten echten Auftrag nach; bitte sie, deine Domain auf die Whitelist zu setzen.

OAuth-Redirect-Mismatch

Diagnose. Die Redirect-URI in deinem Google-Cloud-OAuth-Client (oder in deiner Dropbox-App) stimmt nicht exakt mit der URL überein, die das Plugin während des OAuth-Vorgangs an deinen Anbieter meldet. Schon ein abschließender Slash, http vs. https oder www. vs. ohne www. löst diesen Fehler aus.

Lösung.

1. Im Plugin: Öffne Customer Cloud Gallery → Einstellungen, klappe die Setup-Anleitung des betreffenden Anbieters aus und kopiere die Redirect-URI aus dem Code-Block.
2. In der Cloud-Konsole (Google Cloud Console → Credentials oder Dropbox App Console → Settings) den OAuth-Client / die App öffnen.
3. Ersetze die bestehende Redirect-URI durch den exakten Wert aus Schritt 1. Speichern.
4. Verbinde dich im Plugin neu.

Falls deine Seite unter mehreren URLs erreichbar ist (z. B. example.com und www.example.com), achte darauf, dass die kanonische Home-URL unter Einstellungen → Allgemein mit dem registrierten Wert übereinstimmt.

Galerie verschwindet hinter dem Header

Diagnose. Dein Theme nutzt einen transparenten oder absolut positionierten Header, der den Seiteninhalt überlagert. Die oberste Reihe der Galerie liegt darunter, sodass Besucher nur teilweise Thumbnails sehen.

Lösung. Setze einen Spacer-Block über dem Galerie-Shortcode im Seiten-Editor:

1. Öffne die Seite im Editor.
2. Klicke auf das + über dem Shortcode-Block und füge einen Spacer-Block ein.
3. Stelle die Höhe ungefähr auf deine Header-Höhe ein (80–120 px funktionieren bei den meisten Themes).
4. Aktualisiere die Seite.

Dieser Schritt ist auch in Passwortschutz und Druckshop einrichten dokumentiert, weil er so häufig nötig ist.

Plugin-Update hat etwas zerschossen

Diagnose. Eine neue Version bringt eine Regression mit, die spezifisch für dein Theme, deine Server-PHP-Version oder ein anderes installiertes Plugin ist.

Lösung.

1. Gehe zu Plugins → Installierte Plugins.
2. Suche Customer Cloud Gallery und klicke in der Spalte Updates auf Installierte Versionen anzeigen (das setzt das WP-Rollback-Plugin oder eine aktuelle WordPress-Version mit nativer Rollback-Unterstützung voraus).
3. Wähle die vorherige stabile Version (z. B. von 1.12.0 zurück auf 1.11.8).
4. Bestätige den Rollback. WordPress installiert die ältere Version neu.
5. Öffne ein Support-Ticket, damit die Regression im nächsten Release gefixt werden kann.

Wenn deine Hosting-Umgebung kein natives Rollback unterstützt:

1. Lade die ZIP der älteren Version von der WordPress.org-Plugin-Seite herunter (Advanced View → Previous Versions).
2. Deaktiviere das Plugin (deine Galerien und Einstellungen bleiben erhalten).
3. Lösche das Plugin (deine Galerien und Einstellungen bleiben weiterhin erhalten — Uninstall-Daten werden nur bei Löschen mit ausdrücklicher Bestätigung entfernt).
4. Lade die ältere ZIP über Plugins → Installieren → Plugin hochladen hoch.
5. Aktiviere.

Typische Fehler

„Trennen und neu verbinden” behebt den getrennten Zustand nicht. Du hast mehrere Drive-/Dropbox-Accounts in deiner Browser-Session. Nach dem Klick auf Verbinden noch mal prüfen, ob der Consent-Screen den richtigen Google-/Dropbox-Account zeigt (oben rechts auf Googles Bildschirm). Den falschen Account ggf. in einem anderen Tab abmelden.

Visitor-Cookie gelöscht — und plötzlich sind die Favoriten weg. Favoriten hängen am zufälligen Visitor-Cookie, nicht am WordPress-Login. Cookies löschen heißt: die Favoriten dieses Besuchers sind weg — das ist Absicht (Datenschutz), und es gibt keinen „Login zur Wiederherstellung”. Sag deiner Kundschaft am besten, sie sollen Favoriten möglichst in einer Sitzung erledigen.

Nächster Schritt

Wenn dein Problem hier nicht abgedeckt ist, wirf einen Blick in die FAQ für übergeordnete Fragen, oder kontaktiere den Support über den Link auf der Plugin-Website.