Die Suche in der WordPress Mediathek funktioniert nicht? Dies kannst du tun.

Als langjähriger WordPress-Entwickler und -publisher habe ich zahlreiche Fälle erlebt, in denen die Suchfunktion der Mediathek nicht wie erwartet funktioniert.

In diesem Artikel diskutiere ich verschiedene Ursachen und Lösungen für eine kaputte WordPress-Mediathek-Suche.

Ich unterteile diesen Artikel in zwei Bereiche. Zuerst testen wir verschiedene Möglichkeiten, um den Umfang des Problems einzugrenzen. Dann versuchen wir herauszufinden, was dazu führt, dass die Suche in der Mediathek nicht funktioniert.

Checks für die Mediathek-Suche

Fangen wir mit einigen Tests an, um den Umfang eines möglichen Problems einzugrenzen.

Hier sind die schnellsten Checks:

• Suche das Bild im Frontend: Wenn du dich erinnerst, wo du das Bild im Frontend eingebettet hast, überprüfe, ob es noch da ist. Wenn nicht, hast du es vielleicht doch entfernt.
• Suche nach anderen Bildern: Wenn du andere Bilder findest, könnte das Problem nur bei bestimmten Bildern oder Bildeigenschaften liegen. Mir fallen da Umlaute und Sonderzeichen im Dateinamen ein.
• Überprüfe die allgemeine WordPress-Suche im Frontend und Backend. Wenn diese auch nicht funktioniert, ist die Suche auf einer höheren Ebene defekt, nicht nur für Bilder. Wahrscheinlich verursacht ein anderer Code oder eine Sicherheitsfunktion das Problem.

Was die Mediathek-Suche berücksichtigt

Standardmäßig berücksichtigt WordPress bei der Bildersuche mehrere Informationen:

• Dateiname
• Titel
• Bildunterschrift
• Beschreibung
• ALT-Text

Die Bildsuche berücksichtigt nicht den „Inhalt“ von Dateien, z.B. Text in PDFs oder Bildern. IPTC-Copyright– oder -Caption werden ebenfalls ignoriert.

Mediathek zu groß

Ich habe viele Websites mit Zehntausenden von Bildern gesehen. In solchen Fällen kann die Suche länger dauern oder bei begrenzten Hosting-Kapazitäten sogar fehlschlagen.

Versuche in diesem Fall, deine Mediathek aufzuräumen.

Fehler im Code

Ich installiere normalerweise das Plugin Query Monitor, um festzustellen, ob einer meiner eigenen Codeschnipsel, ein Plugin oder ein Theme ein technisches Problem verursacht. Das Tool zeigt mir u.A. PHP-Fehler und langsame Abfragen an.

Ich schaue mir auch die debug.log-Datei an, um PHP-Probleme zu identifizieren, die Query Monitor nicht erfasst hat.

Schließlich öffne ich die Konsole in meinem Browser, um nach JavaScript-Problemen zu suchen.

Test der REST API

Manchmal liegt das Problem tiefer in der WordPress REST API. So untersuche ich es:

1. Versuche, auf https://DEINESEITE.DE/wp-json/wp/v2/media?search=SUCHBEGRIFF zuzugreifen.
2. Ersetze DEINESEITE.DE durch deine tatsächliche Domain und SUCHBEGRIFF durch einen Suchbegriff, der Ergebnisse finden sollte.
3. Wenn die Anfrage ein leeres Ergebnis zurückgibt, liegt wahrscheinlich ein Problem mit deiner REST API vor.

Die REST API kann durch Folgendes gestört werden:

1. Ein (Sicherheits-)Plugin oder benutzerdefinierter Code bricht oder beschränkt den Zugriff auf die REST API.
2. Überprüfe deine .htaccess-Datei auf Regeln, die API-Anfragen blockieren könnten.
3. Frage deinen Hosting-Provider nach möglichen serverseitigen Einschränkungen.
4. Überprüfe die Regeln in deiner Firewall, z.B. CloudFlare oder Sucuri.net.

Weitere Informationen findest du in den entsprechenden Abschnitten unten.

Mediathek-Suche reparieren

Datei in der Mediathek finden

Manchmal findet die Mediathek-Suche ein Bild nicht, weil du es noch nicht hochgeladen hast.

So überprüfst du das:

1. Gehe zur Mediathek im WordPress-Adminbereich.
2. Teste, ob du andere Bilder finden kannst.
3. Probiere verschiedene Schlüsselwörter aus, die mit dem nicht gefundenen Bild verbunden sind.

Du kannst auch versuchen, das Bild manuell zu suchen:

1. Wechsle zur „Listenansicht“, wenn du in der „Rasteransicht“ bist.
2. Scrolle durch oder nutze die Suchfunktion des Browsers (meistens Strg+F oder Cmd+F), um nach der Datei zu suchen.

Lösung:
Wenn die Datei nicht vorhanden ist, lade sie in deine Mediathek hoch.

Externe Mediendienste und CDN

Wenn du Dienste nutzt, um deine Medien auf externen Speicher (wie Amazon S3), ein Content Delivery Network (CDN) oder über eine Option in deinem Hosting-Paket auszulagern, könnte dies Suchprobleme verursachen.

So überprüfst und behebst du das:

1. Deaktiviere das Offloading-Plugin oder den Service vorübergehend.
2. Versuche erneut, nach Medien zu suchen.
3. Wenn es funktioniert, überprüfe die Einstellungen deines Offloading-Plugins oder kontaktiere deren Support.

Plugin-Konflikte

Plugins stören häufig die Kernfunktionen von WordPress. Das habe ich auch schon einige Male bei der Suche erlebt.

So überprüfst und behebst du das:

1. Deaktiviere alle Plugins (du kannst das Health Check & Troubleshooting-Plugin verwenden).
2. Teste die Mediensuche.
3. Wenn es funktioniert, reaktiviere die Plugins nacheinander und teste nach jeder Aktivierung.
4. Wenn du ein konfliktverursachendes Plugin findest, melde das Problem dem Entwickler oder suche nach einer Alternative.

Um den Support für Plugins zu beschleunigen, könntest du versuchen, das Problem auf einer Testseite zu reproduzieren, die das Support-Team dann idealerweise sehen und beheben kann. Als Plugin-Entwickler selbst würde ich das sehr schätzen.

Theme-Probleme

Manchmal können Themes mit der Suche von WordPress in Konflikt geraten, insbesondere wenn sie benutzerdefinierte Suchfunktionen bieten.

So überprüfst und behebst du das:

1. Wechsle zu einem Standard-WordPress-Theme wie Twenty Twenty-Four. Du kannst auch das Health Check & Troubleshooting-Plugin dafür verwenden.
2. Teste die Mediensuche.
3. Wenn es funktioniert, könnte dein Theme der Übeltäter sein. Kontaktiere die Theme-Entwickler für Support.

Eigener Code

Mehr als einmal habe ich die WordPress-Suche durch eigenen Code kaputt gemacht. Du oder dein Entwickler sollten am besten wissen, wo dieser platziert wurde. Wenn du es nicht weißt, überprüfe in folgender Reihenfolge:

• Die functions.php-Datei des Themes.
• Ein benutzerdefiniertes Plugin auf der „Plugins“-Seite im WordPress-Dashboard.
• Benutzerdefinierter Code, der über ein Plugin wie Code Snippets verwaltet wird, das normalerweise über ein eigenes Menü im WordPress-Dashboard zugänglich ist.

Benutzerdefinierter Code kann auf ebenso viele Arten fehlerhaft sein wie Code in einem Drittanbieter-Theme oder fremdes Plugin. Vorausgesetzt, dass du, ein Kollege oder ein beauftragter Dienstleister dafür verantwortlich war, suche nach Folgendem:

• Alles, was die WordPress-Suche manipuliert, insbesondere unter Verwendung des pre_get_posts-Filters.
• Alles, was die WordPress REST API einschränkt oder manipuliert.

Hosting-Anbieter

Ich bin sehr zuversichtlich, dass die großen Hosting-Anbieter nur ausnahmsweise verantwortlich sind, dass die WordPress-Mediathek-Suche nicht funktioniert, es sei denn, du hast einige benutzerdefinierte Einstellungen vorgenommen.

Wenn sie sich auf WordPress spezialisieren und du nicht über die nötigen technischen Kenntnisse verfügst, kannst du dennoch deren Support um Rat fragen.

Langsame Bildersuche

Wenn deine Bildersuche funktioniert, aber sehr langsam ist, sind hier einige Schritte, die ich unternehme:

1. Datenbank optimieren: Verwende ein Plugin wie WP-Optimize, um deine Datenbank zu bereinigen und zu optimieren.
2. Größe der Mediathek reduzieren: Entferne ungenutzte Bilder, um Platz zu schaffen.
3. Hosting upgraden: Wenn du eine große Website hast, benötigst du möglicherweise ein leistungsfähigeres Hosting.

Fazit

Ich habe schon einige Male gesehen, dass die Mediathek-Suche in WordPress nicht funktioniert. In den meisten Fällen wurde dies durch meinen eigenen Code oder ein anderes Plugin verursacht. Oft ist davon auch die allgemeine WordPress-Suche betroffen.

Durch systematisches Durcharbeiten der obigen Listen konnte ich diese Probleme mit der Mediathek-Suche meist lösen. Denke daran, wenn du diese Änderungen nicht selbst vornehmen möchtest, ist es immer am besten, einen WordPress-Experten oder den Support deines Hosting-Anbieters zu konsultieren.