Problembehandlung

Hier findest du uns bekannte Einschränkungen und Problemlösungen. Bitte schreibe uns, wenn du auf welche stößt, die hier nicht angesprochen werden.

Siehe auch Compatibility (engl).

Allgemeine Einschränkungen

Accelerated Mobile Pages (AMP)

Auf AMP-Seiten wird das Overlay unterhalb des Bild dargestellt. Wir mussten für AMP-Seiten denjenigen Teil des Skripts entfernen, der das Overlay an die korrekte Stelle setzen würde, da AMP kein eigenes JavaScript unterstützt.

Mehrfache Bildquellen-Listen

Falls du mehrere Bildquellen-Listen auf derselben Seite platzieren solltest, wird nur die letzte mit Bildquellen-Informationen befüllt. Dies kann zu unerwartetem Verhalten führen, falls mehrere Bildquellen-Listen auf derselben Seite platziert sind – zum Beispiel auf Archivseiten. Zusätzliche Quellenlisten könnten nur Quellen-Informationen für Bilder enthalten, die sich innerhalb des Hauptinhalts befinden. Dies ist relevant, falls du Bildquellen für Bilder außerhalb des Hauptinhalts anzeigst.

Umlaute in Bild-URLs

Deutsche Umlaute in Bild-URLs führen dazu, dass diese URLs nicht erkannt und ihnen in einigen Fällen, die Quellen nicht zugeordnet werden.

WordPress wandelt Umlaute in Dateinamen beim Upload automatisch um, so dass dieses Problem nur mit erheblichem manuellem Aufwand oder bei externen Bildern entstehen kann.

Als manuelle Lösung zur Anzeige des Overlays kann dem entsprechenden <img> Tag die Klasse wp-image-BILID zugewiesen werden. Hierbei muss BILDID durch die ID des Bildes ersetzt werden, z.B. <img src"…" class="wp-image-543">.

Andere Medientypen

Image Source Control funktioniert nicht (reibungslos) mit Bildtypen die nicht standardmäßig in die WordPress Mediathek hochgeladen werden können, darunter auch SVG. Wie auch bei anderen Medientypen wie Videos, könnte ISC die Quellen zwar im Frontend auflisten, aber nicht als Overlay darstellen. Je nach Medientyp, geht das Markup hierdurch kaputt.

Externe Bilder ohne Dateiendung in CSS-Hintergründen

Image Source Control erkennt keine Bilddateien, die jedes der folgenden Merkmale aufweisen:

• sie verfügen über keine geeignete Dateiendung, wie z. B. .jpg, .jpeg, .png or .gif
• sie lagern auf einem externen Server und wurden mit der Funktion „In der Mediathek verwalten“ von ISC importiert
• sie sind auf deiner Seite oder in deinem Beitrag per CSS-Eigenschaft background-image eingebunden

Setze bitte einen der folgenden Vorschläge um, um dieses Problem zu beheben:

• benenne die Bilddatei um und vergib eine geeignete Dateiendung
• lade die Bilddatei manuell in deine Mediathek hoch
• binde die URL der Bilddatei im Block-Editor in einem gewöhnlichen Block, wie einem Bild-Block, ein

Bitte melde dich bei uns, wenn dir in anderen Konstellationen Fälle nicht erkannter Bilddateien unterkommen.

Keine Quellenlinks bei verlinkten Hintergrundbildern

Wenn Image Source Control erkennt, dass ein Hintergrundbild für einen Link (<a> Tag) verwendet wird, werden Links in Overlays automatisch deaktiviert. Das ansonsten invalide HTML führt dazu, dass die Overlays an der falschen Stelle geladen werden.

Nachgeladene Inhalte (AJAX)

Image Source Control erkennt keine Bilder, die mit Hilfe von AJAX nachgeladen werden. Diese Bilder werden keine Bildquellen anzeigen oder in der Liste der vorhandenen Bilder der aktuellen Seite auftauchen. Individuelle Lösungen sind hier möglich. Dazu muss aber der von AJAX zurückgegebene Inhalt durch einen WordPress-Filter laufen. Hier kann dir der Entwickler der AJAX-Lösung helfen. Du kannst mich auch gerne für die Umsetzung engagieren.

Da dynamisch geladene Bilder häufig Teil anderer Beiträge sind, ergeben sich für die Liste der Ungenutzten Bilder keine Einschränkungen.

Installation und Lizenz

Herunterladen des Plugins

Dein Browser könnte so eingestellt sein, dass er nach Abschluss des Herunterladens ZIP-Dateien grundsätzlich entpackt. Allerdings erwartet WordPress die Plugin-Dateien als ZIP gepackt. Deshalb solltest du einfach die entpackten Daten manuell erneut zur ZIP-Datei packen.

Aktivierung der Lizenz

Vorab: Deine Lizenz sollte bei einer Verlängerung aktiv bleiben. Falls nicht – zum Beispiel, weil du deine Lizenz manuell verlängert hast –, stelle die Lizenz bitte wieder her, indem du unter Einstellungen > Bildquellen^(?) > Lizenz den Button „Lizenz aktualisieren“ klickst.

Während die Lizenz aktiviert wird, muss sich dein Server kurz mit unserem verbinden, um den Lizenzschlüssel auszutauschen. In manchen Fällen kann es dabei zu Problemen kommen. Bitte versuche eine oder mehrere der folgenden Lösungsvorschläge:

• Bitte prüfe in deinem Kundenkonto, ob die Lizenz nach wie vor gültig ist und ob du noch eine ausreichende Anzahl an Aktivierungen übrig hast
• Falls der Button gar nicht reagiert, könnte auch ein Problem mit JavaScript vorliegen; bitte schaue in der Browser-Konsole nach etwaigen Fehlern und teile uns mit, falls sie durch Image Source Control verursacht werden

Aktualisieren des Plugins

Falls du auf Schwierigkeiten beim Aktualisieren von Image Source Control stößt, prüfe bitte, ob einer der folgenden Punkte darauf zutrifft:

• Fehlermeldung ähnlich “The package could not be installed. PCLZIP_ERR_BAD_FORMAT (-10) : Unable to find End of Central Dir Record signature”:
  Bitte deinen Website-Administrator oder deinen Webhost darum, cURL zu installieren bzw. zu aktualisieren..
• Fehlermeldung ähnlich “Download failed: Unauthorized”:
  Bitte befolge die Schritte im vorherigen Unterabschnitt, um deine Lizenz zu prüfen und zu aktivieren.

Bildquellen

Bild-Quellenangaben werden nicht dargestellt

Ein Grund, warum Bildquellen in deinem Frontend nicht dargestellt werden, könnte sein, dass deine Website gecacht wird – entweder mithilfe eines der beliebten WordPress-Caching-Plugins oder durch deine Server-Software. ISC kann den Beitrag-Bild-Index für gecachte Seitenansichten nicht erstellen. Warte entweder, bis sich dein Cache automatisch aktualisiert, oder du leerst ihn manuell, um die Indexierung zu initiieren.

Wende dich bitte an deinen Website-Administrator oder an deinen Webhost, falls du deinen Cache nicht selbstständig leeren kannst.

Folgendes kannst du ebenfalls bei fehlenden Bild-Quellen testen. Lass uns dabei wissen, wann und wo sie auftauchen.

• Aktiviere die Beitrags-Quellenliste und das Overlay für die Bildquellen-Darstellung.
• Wechsle zu einem Standardtheme wie Twenty Twenty Three.
• Wenn du einen Page-Builder wie Divi oder Elementor verwendest dann erstelle eine neue Seite ohne diesen.
• Nutze die Plugineinstellungen, um Bildquellen auch für Bilder außerhalb des Inhalts anzuzeigen.

Bildquellen werden nicht aktualisiert

Versuche Folgendes, wenn die Bildquellen in der Beitrags-Quellenliste oder der Globalen Quellenliste nicht aktualisiert werden:

• Überprüfe die Plugin-Optionen, um sicherzustellen, dass die Anzeige der Quelle wie erwartet eingerichtet ist.
• Rufe die Seite mit dem Bild im Frontend auf, während du eingeloggt bist, um den Cache zu umgehen.
• Deaktiviere vorübergehend dein Caching-Plugin.
• Gehe zu Medien > Bildquellen und klicke auf die Schaltfläche „Beitrag-Bild Verknüpfungen auflisten“. Lösche den Eintrag für den betreffenden Beitrag und besuche ihn dann im Frontend, um eine erneute Indexierung zu erzwingen.
• Führe den Indexer auf dem gesamten Inhalt aus.
• Überprüfe die Liste der bekannten Einschränkungen auf dieser Seite.
• Überprüfe die Kompatibilitätsliste (engl.) mit anderen Plugins und Themes.

Wenn die Bilder auf deiner Seite dynamisch wechseln, dann nutze diesen Codeschnipsel für den dynamischen Reindex.

Bild-URLs im Frontend sind nicht identisch mit denen in der Mediathek

Ein Grund, warum Bildquellen nicht erscheinen, ist ein Unterschied zwischen Bild-URLs im Frontend und denen in der Mediathek, bzw. der Datenbank. Dies tritt in Zusammenhang mit eigenem Code in Plugins oder Themes auf.

Das Problem und die möglichen Lösungen sind ausführlich unter Adding overlays to images with dynamic URLs (englisch) beschrieben.

Die Eingabefelder für Bildquellen erscheinen nicht im Block-Editor

Block-Editor vs. Media-Popup

Image Source Control bietet Eingabefelder für Bildquellen an zwei Stellen: innerhalb der Optionen des Block-Editors für einzelne Bildblöcke und innerhalb des Modals der Mediathek. Aufgrund potenzieller Konflikte und versehentlichen Überschreibens von Daten kann jeweils nur eine dieser Optionen über die Plugin-Einstellungen unter Einstellungen > Bildquellen^(?) > Verschiedenes > Block-Optionen aktiviert werden.

Da Beitragsbilder keine eigenen Block-Optionen haben, musst du zur Mediathek navigieren, um die Quelleninformationen für diese zu bearbeiten.

Du kannst mit diesem Codeschnipsel die Eingabefelder auch auf eigenes Risiko gleichzeitig im Block-Editor als auch im Media-Popup aktivieren.

Nach der Konvertierung aus dem Classic Editor

Es kann weiterhin passieren, dass die Eingabefelder von Image Source Control in den Block-Eigenschaften in der Sidebar nicht dargestellt werden, zum Beispiel nach einer Umwandlung des Inhalts eines Beitrags von einem Classic-Editor zu Blöcken.

Wähle einfach jeden Bild-Block einzeln aus und betätige den Button „Externes Bild hochladen“ im Kontextmenü des Blocks. Die ISC-Eingabefelder stehen dir nun wieder zur Verfügung.

Korrektur der Overlay-Position

Dynamische Elemente auf der Website, wie nachladende Bilder (Lazy Loading), können die Overlay-Position verschieben.

Als Lösung kannst du das dynamische Nachladen deaktivieren oder die Position des Overlays mit Hilfe eines dieser Codeschnipsel korrigieren.

Das Overlay überlagert ein fixiertes Element

Wenn das Overlay beim Scrollen ein fixiertes Element, z.B. eine Menüleiste am oberen Bildschirmrand, überlagert, dann muss entweder der Wert des Overlays für z-index mit CSS verringert, oder dieser Wert für das überlagerte Element erhöht werden. Für das Overlay kannst du folgende Regel als Beispiel nutzen. Sie reduziert bereits den Standardwert von 9999.

.isc-source-text { z-index: 100 !important; }Code-Sprache: CSS (css)

Daten fehlen nach der Migration

Standard-WordPress-Migrationsmethoden, einschließlich Werkzeuge > Export für Medien, sollten die ISC-Metadaten zusammen mit Ihren Bildern übertragen. Stelle sicher, dass der Migrationsprozess die wp_postmeta-Tabelle einschließt.

Wichtig: Nach der Migration ist der ISC-Index veraltet oder falsch. Du musst die Indizes auf der neuen Website neu erstellen.

1. Gehen Sie zu Medien > Bildquellen
2. Klicken Sie auf den Button Bild-Post-Index löschen.

Der Index wird automatisch neu erstellt, wenn Seiten besucht werden. Du kannst auch den Indexer manuell unter Medien > Unbenutzte Bilder > Indexer starten ausführen.

Für spezielle Export-Tools wie WP All Import musst du möglicherweise die Post-Meta-Schlüssel von ISC während der Importkonfiguration manuell zuordnen.

Admin Bar Debugger

Das ISC Debugger Plugin hilft uns bei der Analyse fehlender Bildquellen im Frontend. Es listet die gefundenen und indizierten Bilder einer Seite und die Bildquellen in der Adminleiste auf.

Du kannst dieses Plugin selbst hier herunterladen. Aktiviere es und besuche das Frontend deiner Seite als angemeldeter Nutzer, um das Menü zu sehen.

Debugging-Optionen

Unter Medien > Bildquellen findest du vier Optionen zur Fehlerbehandlung:

• Beitragsindex > Beitrag-Bild-Verknüpfungen auflisten
  Hiermit wird eine List von Seiten und Beiträgen und ihrer beinhalteten Bilder dargestellt. Aus diesen Verknüpfungen wird die Globale Quellenliste generiert. Lösche einzelne Einträge damit ISC die jeweilige Seite beim nächsten Besuch erneut indiziert.
• Beitragsindex > Bild-Beitrag-Verknüpfungen auflisten
  Hiermit wird eine List von Bildern und die sie beinhaltenden Seiten und Beiträge dargestellt. Aus diesen Verknüpfungen wird die Beitrags-Quellenliste generiert.
• Beitragsindex > Bild-Beitrag-Index löschen
  Hiermit wird die Verknüpfung zwischen Bildern und Beiträgen, die weiter oben beschrieben wird, aufgehoben. Der Index wird automatisch neu aufgebaut, sobald im Frontend eine Seite oder ein Beitrag mit platzierten Bildern aufgerufen wird.
• Zwischenspeicher > Zwischenspeicher leeren
  Hiermit wird der interne Zwischenspeicher mit aus der WordPress-Mediathek bezogenen Bild-URLs und -IDs geleert, den ISC vorhält, um die Anzahl an Datenbank-Abfragen aus dem Frontend zu minimieren.

Fehlerprotokoll

Das Fehlerprotokoll hilft dir dabei, die Schritte nachzuvollziehen, die ISC jedes Mal unternimmt, wenn eine Seite oder ein Beitrag aufgerufen wird, die ISC-Elemente enthalten. Gehe bitte folgendermaßen vor, um das Fehlerprotokoll einzuschalten und abzurufen:

1. Gehe zu Einstellungen > Bildquellen^(?) > Verschiedene Einstellungen > Fehlerprotokoll, setze einen Haken in das Kästchen und speichere die Einstellung
2. Öffne in deinem Frontend die Seite, deren Aufruf du protokollieren möchtest
3. Hänge ?isc-log an die URL an und drücke Enter, um den Aufruf mit Protokollierung durchzuführen – wundere dich nicht, es ist kein Unterschied in der Darstellung der Seite zu erwarten
4. Finde den Link zum Log in der unter 1. genannten Einstellung. Die Datei heißt für jede Website anders. Klicke auf den Link um das Log zu öffnen.

Ersetze ?isc-log mit &isc-log, falls die URL bereits andere GET-Parameter enthält.

Wenn du den Haken im Kästchen unter Einstellungen > Bildquellen^(?) > Verschiedene Einstellungen > Fehlerprotokoll wieder entfernst, wird das Fehlerprotokoll gelöscht.