Ein gerade gekauftes WordPress Theme lässt sich nicht installieren? Das kommt manchmal vor und die Gründe dafür sind gut abzugrenzen. Mögliche Probleme bei der Installation eines WordPress Themes sind:
- Man versucht, eine bereits entpackte Version der Installationsdatei hochzuladen
- Die .zip Datei, die man hochlädt, ist keine Installationsdatei für ein WordPress Theme, sondern etwas anderes (z.B. das ganze Download-Paket des Herstellers)
- Das Theme braucht ein Eltern-Theme oder ein Plugin, das noch fehlt
- Eine Grenze des Webservers, z.B. für die Upload-Größe oder die PHP-Version
- Das Theme ist bereits (teilweise) installiert
- Der eigene Benutzer darf keine Themes installieren
- Ein temporäres Problem auf dem Webserver oder eine abgelaufene Anmeldung
- Die .zip Datei ist defekt (z.B. nicht vollständig heruntergeladen)
Wie kann man aber herausfinden, was genau nicht stimmt und wie man das Problem beheben muss? Ich gehe jeden dieser Punkte im Folgenden genau durch und bespreche auch Lösungsmöglichkeiten für die einzelnen Punkte. Die Fehlermeldungen zitiere ich so, wie sie das aktuelle deutsche WordPress anzeigt; über das Inhaltsverzeichnis können Sie direkt zu dem für Sie am interessantesten klingenden Punkt springen.
WordPress Themes: Eine Einführung für WordPress-Einsteiger
Das Thema WordPress Themes ist insgesamt sehr komplex. Das hat zwar in erster Linie mit der Vielfalt an angebotenen Themes für WordPress zu tun, aber auch damit, wie man sie administriert. Über das etwas weiter gefasste Thema habe ich bereits einen Überblicksartikel geschrieben: WordPress-Theme auswählen: Kriterien, Block-Themes und meine Empfehlung.
Für die hier besprochenen Probleme sind dabei zwei Abschnitte jenes Artikels interessant, die die Installation von Themes betreffen. Der erste dieser Abschnitte behandelt die Installation eines kostenlosen WordPress Themes aus dem WordPress Theme-Verzeichnis. Dieser Fall macht nur selten Probleme.
Der zweite Abschnitt behandelt die Installation eines gekauften WordPress Themes durch Hochladen der Installationsdatei unter Design → Themes → Theme hinzufügen → Theme hochladen. Dieser Fall verursacht die meisten der hier behandelten Probleme. Bevor wir uns die Probleme und Lösungsvorschläge im Detail ansehen, ein kurzer Einblick in das, was bei der Installation eines WordPress Themes passiert.
Aus welchen Dateien besteht ein WordPress Theme?
Ein Theme ist ein Ordner mit Dateien. Jedes Theme braucht eine Datei style.css, an deren Anfang ein kurzer Kopfbereich steht: Name des Themes, Version, Autor und Voraussetzungen wie die mindestens nötige PHP-Version. Daran erkennt WordPress überhaupt erst, dass es sich um ein Theme handelt.
Dazu kommen die Vorlagen, nach denen die Seiten aufgebaut werden. Bei einem klassischen Theme sind das Dateien in der Skript-Sprache PHP, mindestens eine index.php. Bei einem Block-Theme, wie es alle Standard-Themes von WordPress seit Twenty Twenty-Two sind, sind es HTML-Vorlagen im Unterordner templates und eine Datei theme.json mit den Einstellungen für Farben, Schriften und Abstände. Dazu kommen bei beiden Arten meist noch Stylesheets, JavaScript-Dateien und Bilder.
Was passiert genau beim Hochladen und der Installation eines WordPress Themes?
Dieser Satz von Dateien muss also installiert werden, damit er benutzt werden kann, und zwar im richtigen Ordner der WordPress-Installation auf dem Webserver, nämlich in wp-content/themes. Dort bekommt jedes installierte Theme einen eigenen Ordner.
Der Ordner mit den Dateien eines Themes gelangt bei der Theme-Installation nicht als Ordner auf den Webserver, sondern als eine komprimierte Datei im .zip Format. Diese wird bei kostenlosen Themes direkt aus dem Theme-Verzeichnis von WordPress.org abgerufen und bei gekauften Themes vom Käufer im WordPress-Dashboard hochgeladen.
Nachdem diese eine .zip Datei auf dem Webserver angekommen ist, entpackt WordPress sie und prüft, ob darin genau ein Ordner mit einer gültigen style.css und den nötigen Vorlagen liegt. Erst dann wird der Ordner nach wp-content/themes verschoben. Die Probleme, die hier beschrieben sind, betreffen also genau diesen Weg jener .zip Datei vom Autor des Themes bis zum fertig installierten Ordner auf dem Webserver.
Genereller Lösungsweg bei gekauften Themes: Der Support des Theme-Autors kann helfen
Ein wichtiger Hinweis gleich zu Beginn, noch bevor wir uns um weitere Details kümmern: Wenn Sie ein WordPress Theme kaufen, gibt es immer die Möglichkeit, sich an den Support des Verkäufers zu wenden.
Sogar manche kostenlose Themes bieten Email-Support, der bei Problemen hilft, die über eine FAQ auf der Theme-Website hinausgehen. Wenn Sie also
- selbst das Problem nicht lösen können
- die hier beschriebenen Vorschläge Ihnen auch nicht weiter helfen
- Sie außerdem in der FAQ (oft gestellte Fragen)-Sektion der Theme-Website auch keine vernünftigen Hinweise auf eine problemlose Installation des Themes finden
dann scheuen Sie sich nicht, den Support zu kontaktieren. Schicken Sie dabei den genauen Wortlaut der Fehlermeldung mit, das spart allen Beteiligten Zeit.
Strategie und Reihenfolge bei der Suche nach einer Lösung für dieses Problem
Schwierigkeiten beim Installieren eines WordPress Themes können mit mehreren (verschiedenen) Problemen zu tun haben. Im Folgenden liste ich die Probleme der Reihe nach auf. Die Reihenfolge habe ich dabei so gewählt, dass wahrscheinlichere Probleme zuerst behandelt werden.
Am schnellsten finden Sie den passenden Abschnitt über die Fehlermeldung, die WordPress Ihnen zeigt. Ich nenne sie bei jedem Problem im Wortlaut.
Problem 1: Man versucht, eine bereits entpackte Version der .zip-Installationsdatei (also einen Ordner) hochzuladen
WordPress nimmt beim Hochladen nur .zip-Dateien an. Das Auswahlfenster unter Theme hochladen lässt deshalb nur .zip-Dateien und keine Ordner auswählen, und eine Datei mit einer anderen Endung lehnt WordPress mit der Meldung „Es dürfen nur .zip-Archive hochgeladen werden.“ ab.
Manchmal liegt im Download-Ordner aber gar keine .zip-Datei mehr, sondern ein Ordner mit dem Namen des Themes. Das passiert, wenn der Browser oder ein Programm heruntergeladene Dateien automatisch öffnet und dabei entpackt. In Safari am Mac heißt die zuständige Einstellung „‚Ungefährliche‘ Dateien nach dem Laden öffnen“ (Safari → Einstellungen → Allgemein).
Die beste Lösung ist, die Installationsdatei noch einmal herunterzuladen und dabei darauf zu achten, dass sie als .zip-Datei gespeichert wird. Den entpackten Ordner selbst wieder zu einer .zip-Datei zu komprimieren (Rechtsklick auf den Ordner, Komprimieren bzw. Senden an → ZIP-komprimierter Ordner) funktioniert zwar oft auch, aber dabei können unabsichtlich Veränderungen passieren, z.B. zusätzliche versteckte Dateien oder eine zusätzliche Ordner-Ebene.
Problem 2: Die hochgeladene .zip Datei ist keine Installationsdatei für ein WordPress Theme, sondern etwas anderes
In diesem Fall gibt es noch mehrere Möglichkeiten. Diese haben aber gemeinsam, dass es nach dem Hochladen bei der Installation eine Fehlermeldung gibt. Die häufigste lautet:
„Das Paket konnte nicht installiert werden. Dem Theme fehlt das Stylesheet style.css.“
WordPress hat die .zip-Datei also entpackt, darin aber keinen Theme-Ordner mit einer style.css gefunden. Seltener lauten die Meldungen „Das Stylesheet style.css enthält keinen gültigen Theme-Header.“ oder „Das Template fehlt. …“.
Die hochgeladene .zip Datei kommt vom Theme-Hersteller, enthält aber nicht nur das Theme, sondern noch weitere Dateien
Wenn Sie ein WordPress Theme kaufen, kann es sein, dass Sie als Download zwar eine .zip Datei erhalten, dass diese aber nicht direkt die Installationsdatei für das Theme ist. Das ist der häufigste Grund für die Meldung oben, vor allem bei Themes von Marktplätzen. In so einem Fall müssen Sie diese .zip-Datei erst entpacken, um unter den Inhalten die Dokumentation für das Theme, eventuelle Hilfsdateien, Lizenzdateien und die eigentliche Installationsdatei zu finden – meistens wieder eine .zip-Datei mit dem Namen des Themes. Nur diese innere .zip-Datei laden Sie hoch.
Wenn eine solche .zip-Datei völlig entpackt wird, d.h. auch alle darin enthaltenen .zip Dateien gleich mit-entpackt werden, dann müssen Sie erst herausfinden, welcher Ordner wieder zu einer .zip-Datei komprimiert werden muss: der Ordner, in dem die style.css des Themes direkt liegt. Im Zweifel steht es in der Installationsanleitung des Theme-Autors oder in einer Readme-Datei im entpackten Ordner.
Die hochgeladene .zip Datei ist ein Plugin und kein Theme (oder umgekehrt)
Manche Hersteller bieten zu einem Theme passende Plugins an, die ebenfalls als .zip-Datei kommen. Ein Plugin lässt sich nicht als Theme installieren und ergibt dieselbe Meldung wie oben. Umgekehrt meldet WordPress beim Hochladen eines Themes unter Plugins → Plugin hinzufügen → Plugin hochladen: „Es wurden keine gültigen Plugins gefunden.“ Laden Sie die Datei dann an der jeweils anderen Stelle hoch.
Die hochgeladene Datei ist zwar eine Installationsdatei im .zip Format, aber nicht für WordPress
Manche Designer bieten ihre Designs in verschiedenen Formaten zum Kauf und Download an: Als Theme für WordPress, als HTML-Vorlage, oder als Dateien, die mit Design-Software (z.B. Figma oder von Adobe) benutzt und noch weiter verändert werden können.
Wenn Sie eine .zip-Datei von Ihrem Designer oder Theme-Autor nicht als WordPress Theme installieren können, stellen Sie sicher, dass Sie eine Installationsdatei für ein WordPress Theme erworben haben. Kontrollieren Sie Ihre Bestätigungs-Email, Ihre Rechnung oder andere Zahlungsbestätigungen bezüglich der genauen Beschreibung des gekauften Produkts.
Sollten Sie feststellen, dass Sie irrtümlich etwas anderes als ein WordPress Theme gekauft haben, dann kontaktieren Sie den Support des Verkäufers. Sie werden mit hoher Wahrscheinlichkeit einen zufrieden stellenden Weg finden, wie Sie doch noch zu Ihrem WordPress Theme und der richtigen Installationsdatei kommen.
Und noch ein Hinweis: Laden Sie Themes nur von der Originalquelle des Herstellers oder aus dem Theme-Verzeichnis von WordPress.org herunter. Eine Datei aus einer anderen Quelle kann fehlerhaft oder sogar gefährlich sein.
Problem 3: Ein Eltern-Theme oder ein Plugin, das vom Theme benötigt wird, ist noch nicht installiert
Manche Themes sind sogenannte Child-Themes (untergeordnete Themes): Sie verändern nur ein anderes Theme, das Eltern-Theme, und funktionieren ohne dieses nicht. Beim Hochladen eines Child-Themes prüft WordPress deshalb, ob das Eltern-Theme installiert ist („Dieses Theme erfordert ein übergeordnetes Theme. Überprüfung, ob es installiert ist …“), und versucht, es aus dem Theme-Verzeichnis von WordPress.org nachzuinstallieren. Bei einem gekauften Eltern-Theme klappt das nicht, und es erscheint: „Das übergeordnete Theme konnte nicht gefunden werden. Du musst das übergeordnete Theme installieren, …, bevor du dieses untergeordnete Theme benutzen kannst.“
Die Lösung: zuerst das Eltern-Theme hochladen und installieren, dann das Child-Theme. Ein Child-Theme ohne Eltern-Theme zeigt WordPress unter Design → Themes ganz unten im Bereich Fehlerhafte Themes an.
Außerdem benötigen manche Themes zusätzlich noch Plugins, um vollständig zu funktionieren. Meistens weist das Theme nach der Aktivierung selbst darauf hin. Lesen Sie die Installationsanleitung des Themes durch, um herauszufinden, ob dieser Punkt zutrifft.
Problem 4: Eine Grenze oder Einstellung des Webservers
Manchmal scheitert die Installation an Grenzen, die der Hosting-Anbieter für Ihre Website festlegt. Die häufigsten bei Themes:
- Die Upload-Grenze: Umfangreiche Themes sind als .zip-Datei oft größer als die erlaubte Upload-Größe. Dann meldet WordPress entweder, dass die Datei die Direktive
upload_max_filesizeüberschreitet, oder – wenn die Datei sogar größer alspost_max_sizeist – nur scheinbar unpassend: „Der Link, dem du gefolgt bist, ist abgelaufen.“ Die erlaubte Größe steht unter Werkzeuge → Website-Zustand → Information → Server. - Die PHP-Version: „Die PHP-Version auf deinem Server ist …, das hochgeladene Theme erfordert jedoch …“ heißt, dass das Theme eine neuere PHP-Version braucht, als Ihr Server verwendet. Diese stellen Sie meist im Kundencenter des Hosting-Anbieters um – mit einer Sicherung der Website davor.
- Fehlende Schreibrechte: „Das Verzeichnis konnte nicht erstellt werden.“ oder eine Abfrage von FTP-Zugangsdaten unter Verbindungsinformationen bedeuten, dass WordPress nicht in den Themes-Ordner schreiben darf.
Diese Fälle und was Sie jeweils tun können, beschreibe ich ausführlich in meinem Artikel Warum kann ich bei WordPress keine Plugins installieren? – für Themes gilt dort alles genauso. Für die Upload-Grenze gibt es einen einfachen Umweg: den entpackten Theme-Ordner per FTP oder über den Dateimanager des Hosting-Anbieters nach wp-content/themes hochladen. Danach erscheint das Theme unter Design → Themes und kann aktiviert werden.
Wenn Sie Ihre Website bei einem kleinen Hosting-Anbieter, auf einem privaten Server oder auf einem Server einer Organisation haben, die kein Hosting-Anbieter ist, dann können auch Sicherheitseinstellungen des Servers eine Installation verhindern. Kontaktieren Sie in so einem Fall Ihren Systemadministrator oder Hosting-Betreiber und schildern Sie das Problem, um gemeinsam zu einer Lösung zu kommen.
Problem 5: Das Theme ist bereits installiert
Gibt es in wp-content/themes schon einen Ordner mit dem Namen des Themes, dann installiert WordPress nicht einfach darüber. Ist das Theme dort vollständig installiert, erscheint nach dem Hochladen die Überschrift „Dieses Theme ist bereits installiert.“, darunter die installierte und die hochgeladene Version nebeneinander und der Button Installiertes durch Hochgeladenes ersetzen. So lässt sich ein gekauftes Theme auch von Hand aktualisieren.
Meldet WordPress stattdessen nur „Der Zielordner existiert bereits.“, dann ist der vorhandene Ordner meist ein unvollständiger Rest einer abgebrochenen Installation. Löschen Sie ihn per FTP oder über den Dateimanager Ihres Hosting-Anbieters und installieren Sie das Theme danach noch einmal.
Problem 6: Ihr Benutzer darf keine Themes installieren
Fehlt unter Design → Themes der Button Theme hinzufügen, dann dürfen Sie auf dieser Website keine Themes installieren. Dafür gibt es vier mögliche Gründe:
- Ihr Benutzer ist kein Administrator. Nur diese Rolle darf Themes installieren.
- In der Datei
wp-config.phpsteht die Zeiledefine( 'DISALLOW_FILE_MODS', true );. Dann darf niemand Themes oder Plugins installieren – oft absichtlich gesetzt von einem Hosting-Anbieter oder einer Agentur, die Updates selbst einspielt. - Die Website ist Teil eines WordPress-Multisite-Netzwerks. Dort installiert nur ein Super-Administrator Themes, in der Netzwerkverwaltung, und schaltet sie mit Netzwerkweit freischalten für die einzelnen Websites frei.
- Die Website liegt im kostenlosen Tarif von WordPress.com. Eigene Themes hochladen kann man dort erst in einem bezahlten Tarif.
Mehr zu allen vier Fällen steht in meinem Artikel Warum kann ich bei WordPress keine Plugins installieren?.
Problem 7: Ein temporäres Problem auf dem Webserver
Dieses Problem ist ein temporäres und löst sich daher von selbst durch Warten. Auch ein Webserver muss gewartet werden, macht Updates, ist zwischendurch vielleicht einmal kurzzeitig nicht erreichbar, oder ähnliches. Versuchen Sie jedenfalls noch einmal, Ihr Theme hochzuladen und zu installieren, wenn es beim ersten Mal nicht funktioniert.
Warten Sie gegebenenfalls auch ein paar Minuten und schauen Sie auf der Website Ihres Hosting-Anbieters nach, ob dort Hinweise auf geplante Wartungsarbeiten zu finden sind, damit Sie abschätzen können, wie lange Sie noch warten müssen.
Problem 8: Die Login-Session im WordPress Dashboard ist abgelaufen
Damit Sie in WordPress ein Theme installieren können, müssen Sie als Administrator angemeldet sein. Diese Anmeldung läuft nach einiger Zeit automatisch ab. Wenn man ein Browser-Tab mit dem WordPress-Dashboard lange offen hat und dann darin weiterarbeitet, blendet WordPress ein Anmeldefenster mit der Überschrift Sitzung abgelaufen ein – manchmal aber erst, nachdem der nächste Klick schon mit einer Fehlermeldung gescheitert ist.
Melden Sie sich also wieder an und versuchen Sie die Theme-Installation erneut – sie sollte nun problemlos funktionieren.
Problem 9: Die hochgeladene .zip Datei ist defekt
Auch so etwas kann vorkommen, hauptsächlich durch unvollständige bzw. unterbrochene Downloads. Dann meldet WordPress nur „Das Paket konnte nicht installiert werden.“, ohne einen Hinweis auf die style.css. Überprüfen Sie, ob die .zip Datei, die Sie hochladen wollen, vollständig von der Website des Theme-Verkäufers heruntergeladen wurde, und laden Sie sie im Zweifel noch einmal herunter.
Weitere mögliche Probleme? Oder hat mein Lösungsvorschlag nicht funktioniert?
Haben Sie ein Problem beim Installieren eines WordPress Themes, das ich hier nicht behandelt habe? Oder haben Sie etwas von den hier beschriebenen Lösungsmethoden versucht und es hat nicht funktioniert? Lassen Sie es mich wissen, am besten in den Kommentaren unten – ich werde versuchen, Ihnen zu helfen, der Sache auf den Grund zu gehen.
Ihr Feedback zu diesem Artikel
Auch über generelles Feedback zu diesem Artikel freue ich mich, z.B. welches Problem bei Ihnen vorlag und wie Sie es konkret lösen konnten, ob mit Hilfe dieses Artikels oder ohne. Lassen Sie unten einen Kommentar für mich da, ob Lob, Kritik oder eine Frage, die ich hier nicht beantwortet habe, ich bin immer für Hinweise und Anregungen dankbar, die diesen Artikel verbessern. Bitte beachten Sie: Um Spam zu vermeiden, lese ich jeden Kommentar persönlich und gebe ihn dann erst frei. Seien Sie also nicht überrascht, wenn es ein Bisschen dauert, bis er zu sehen ist. Danke für Ihr Verständnis!
Weitere wichtige Informationen zu WordPress
Noch ein Hinweis: Ob Sie gerade mit Ihrer WordPress-Website begonnen haben oder auch schon länger mit einer WordPress-Website arbeiten: In beiden Fällen sollten Sie einen Blick auf meinen Leitfaden zur kompletten Erstellung einer WordPress-Website werfen: 19 Schritte zur fertigen WordPress-Website: Alle Details. Haben Sie schon alle Schritte erledigt?
