Auf dieser Seite: [ausblenden]
Laden Sie eine hoch 12 MB-Theme zu einer Standard-PHP-Installation hinzufügen und WordPress teilt Ihnen mit, dass der Link, dem Sie gefolgt sind, abgelaufen ist. Nichts ist abgelaufen. Die Zip-Datei war größer als die von PHP 8 MB-Standard für eine Formularübermittlung. PHP hat die gesamte Anfrage verworfen, bevor WordPress sie gesehen hat, and WordPress printed the only error it had left. Diese Diskrepanz zwischen der Botschaft und der Ursache ist der Grund, warum das Hochladen von Themen ganze Nachmittage in Anspruch nimmt.
Schnelle Antwort: Read the second sentence of the error, nicht der erste. “Der Link, dem Sie gefolgt sind, ist abgelaufen” ist eine getarnte Größenbeschränkung. “Das Paket konnte nicht installiert werden” is a headline with five different causes behind it, and the most common one is uploading the ThemeForest “Alle Dateien & Dokumentation” download instead of the smaller theme zip inside it. Wenn Sie Ihre Serverlimits nicht erhöhen können, Kopieren Sie den Theme-Ordner hinein wp-content / themen über SFTP. Der Uploader ist optional. Der Ordner ist nicht.

Zuletzt überprüft: September 2026. Error strings were read from the WordPress core source on 8 September 2026, und gegen WordPress geprüft 7.1.
Woher diese Antworten kamen
Every error message quoted here was read out of the WordPress source rather than copied from another guide. Die Dateien sind wp-admin/update.php, wp-admin/includes/class-theme-upgrader.php, class-wp-upgrader.php und class-file-upload-upgrader.php, Plus wp-includes/capabilities.php for the permission rules and wp-includes/default-constants.php für die Speichervorgaben. Reading the source matters here. Several of these messages are printed by code that runs before WordPress knows anything about your file. The wording describes the check that failed, not the problem you have.
PHP’s own defaults and the scope of each setting came from the PHP manual. That’s also where the rule about .user.ini files running only under CGI and FastCGI is documented. The nginx request-size default came from the nginx directive reference, and the per-plan upload ceilings from Cloudflare’s cache documentation. Host limits came from each host’s own support pages, not from roundups. Plugin version and install data came from the WordPress.org plugin API. The WordPress.com plan history came from archived copies of Automattic’s own support page.
Two limits on all this are worth stating plainly. We did not reproduce each failure on each host, so the host ceilings below are the published numbers rather than numbers we measured. And a WAF block depends on which rule set your host runs. That section shows you how to identify the block rather than promising a specific rule ID.
Lesen Sie zuerst den zweiten Satz
WordPress runs your zip through a chain of checks. Each link in the chain prints its own message, and the messages are more precise than they look once you know which check produced them. Hier ist die Karte.
- “The link you followed has expired.” Ihr Reißverschluss ist größer als post_max_size. Nothing to do with sessions or cookies.
- “The uploaded file exceeds the upload_max_filesize directive in php.ini.” Genau das, was es sagt, and the one honest message in the set.
- “Es dürfen nur .zip-Archive hochgeladen werden.” Der Dateiname endet nicht auf .zip. WordPress prüft den Namen, nicht der Inhalt.
- “Inkompatibles Archiv.” Der Name endet auf .zip, aber die Datei ist keine funktionierende ZIP-Datei. Normalerweise ein verkürzter Download.
- “Das Paket konnte nicht installiert werden. Dem Theme fehlt das Stylesheet style.css.” Der Inhalt der ZIP-Datei ist nicht so angeordnet, wie WordPress es erwartet.
- “Das Paket konnte nicht installiert werden. Das Stylesheet style.css enthält keinen gültigen Theme-Header.” Es gibt eine style.css, aber keine Theme-Namenszeile darin.
- “Vorlage fehlt. Eigenständige Themes benötigen eine Vorlagendatei „templates/index.html“ oder „index.php“.” Ein untergeordnetes Thema ohne Template-Header, oder ein Teilthema.
- “Die PHP-Version auf Ihrem Server ist 8.1, Das hochgeladene Theme erfordert jedoch 8.2.” Ihre eigenen Zahlen werden abweichen. Ihr PHP ist zu alt für dieses Theme.
- “Der Zielordner existiert bereits.” Dieser Themenordner ist bereits vorhanden.
- “Auf das Dateisystem konnte nicht zugegriffen werden.” oder ein Formular, in dem nach FTP-Daten gefragt wird. Eine Nichtübereinstimmung der Dateieigentümer, Kein Berechtigungsproblem.
- “Verzeichnis konnte nicht erstellt werden.” WordPress reached the themes folder but couldn’t make a new one. Überprüfen Sie zunächst Ihr Festplattenkontingent.
- 413 Anforderungselement zu groß im Browser. Etwas vor PHP hat den Upload abgelehnt.
- 403 verboten ohne WordPress-Stil. Eine Firewall-Regel hat die Anfrage abgebrochen.
- Überhaupt keine Schaltfläche zum Hochladen eines Themas. Eine Fähigkeitsregel, kein Fehler.
Work down that list and you skip most of the guesswork. Der Rest dieses Leitfadens behandelt die einzelnen Schritte der Reihe nach.
“Der Link, dem Sie gefolgt sind, ist abgelaufen” Ist eine Größenbeschränkung beim Tragen eines Kostüms
Dies liest sich wie ein Sitzungsproblem, Da suchen die Leute also. Sie löschen Cookies, Abmelden und wieder anmelden, Deaktivieren Sie Caching-Plugins, und nichts davon hilft. The chain that produces it is short and worth knowing.
PHPs post_max_size directive caps the size of an entire form submission, und die ausgelieferte Standardeinstellung ist 8 MB. When a submission goes over that cap, PHP does not truncate it or raise an upload error. Das PHP-Handbuch sagt unverblümt, was stattdessen passiert: das $_POST und $_DATEIEN Superglobals sind leer. Your file is gone before any PHP code runs.
WordPress then does what it always does on the theme upload route. Es prüft Ihre Erlaubnis, ruft dann an check_admin_referer to validate the security token that the upload form put in the POST body. That token was in the body PHP just discarded. Die Prüfung schlägt fehl, und WordPress druckt, was es für jedes fehlgeschlagene Token druckt: the link you followed has expired. Der Upload-Code ein paar Zeilen weiter unten läuft überhaupt nicht.
Welcher der beiden Größenfehler Sie erhalten, hängt davon ab, wo Ihre Datei zwischen den beiden Grenzwerten liegt. Auf Lager PHP-Einstellungen, ein Thema zwischen 2 MB und 8 MB-Reisen upload_max_filesize und vermittelt Ihnen die ehrliche Botschaft, die es benennt. Gehen Sie nach oben 8 MB und du fliegst vorbei post_max_size, Dadurch wird stattdessen die Nachricht „Abgelaufener Link“ erzeugt. Der deutlichere Fehler wird bei den kleineren Dateien angezeigt, Das ist genau das Gegenteil von dem, was Sie wollen.
Die Diagnose ist also einfach. Überprüfen Sie die Größe Ihrer Theme-ZIP-Datei auf der Festplatte. Wenn es oben ist 8 MB und Sie haben Ihre PHP-Einstellungen nicht geändert, das ist deine Antwort, und keine noch so große Cookie-Löschung wird es verschieben. Erhöhen Sie die beiden Größenbeschränkungen oder Überspringen Sie den Uploader vollständig.
Eine Falte fängt Menschen ein, die bereits aufgewachsen sind upload_max_filesize und bekam erneut den gleichen Fehler. WordPress berechnet die Zahl, die es Ihnen anzeigt untere von upload_max_filesize und post_max_size, but the failure above is triggered by post_max_size allein. Raise only one and you can end up with a dashboard that advertises a 64 MB limit while PHP still bins anything over 8 MB. Raise both, and keep post_max_size the larger of the two.
“The Package Could Not Be Installed” Is Five Failures Sharing One Headline
Here’s the part most guides get wrong. They treat this as a single error with a single fix. Das ist es nicht. WordPress uses that sentence as a generic label, then appends the real reason. The second sentence is the one that tells you what to do. Five separate checks can produce it, and they run in this order.
1. Kein style.css an der richtigen Stelle
After unpacking, WordPress looks at the top level of your zip. If there’s exactly one item there and it’s a folder, WordPress treats that folder’s contents as the theme. It then requires a style.css directly inside it. Wenn die oberste Ebene stattdessen mehrere Gegenstände enthält, WordPress uses the zip root as the theme folder, findet dort keine style.css, und stoppt.
Das ist der Mechanismus hinter der ThemeForest-Version dieses Fehlers, was Envato auf einer eigenen Hilfeseite dokumentiert. Envato erklärt den Auslöser. ThemeForest bietet zwei Downloads an: “Alle Dateien & Dokumentation” und “Installable WordPress file only”. Die Anweisung von Envato lautet: Hochladen nur die installierbare Theme-ZIP-Datei, der nach dem Thema benannte. The full download carries documentation, Lizenzzertifikate, Demo-Inhalte und oft ein untergeordnetes Thema neben dem Thema. Its root holds many items, and none of them is style.css. Entpacken Sie den großen Download, find the theme zip inside it, lade das hoch.
Der gleiche Fehler trifft Leute, die ihre eigene ZIP-Datei erstellen, indem sie die Dateien in einem Themenordner auswählen und diese komprimieren. Damit befindet sich style.css im Zip-Root mit einem Dutzend Geschwistern. Komprimieren Sie den Ordner selbst, nicht, was drin ist.
2. style.css existiert, hat aber keinen Theme-Header
Hier ändert sich die Meldung und besagt, dass das Stylesheet keinen gültigen Theme-Header enthält. WordPress liest style.css und sucht nach einem Themenname: Zeile im Kommentarblock oben, und lehnt das Paket ab, wenn es nicht vorhanden ist. Dies zeigt sich auf zwei Arten. Ein Tool hat den Header-Kommentar entfernt, als jemand die Datei gespeichert hat, oder die Zip-Datei enthält ein Stylesheet von etwas, das nie ein Thema war.
3. Keine Vorlagendatei
Die Meldung besagt, dass die Vorlage fehlt. Ein eigenständiges Theme muss beides enthalten index.php (Klassiker) oder templates/index.html (Block). Ein untergeordnetes Thema ist ausgenommen, aber nur, wenn seine style.css ein enthält Vorlage: Zeile, die ihr übergeordnetes Element benennt. Untergeordnete Themen, die ohne diese Zeile verteilt werden, schlagen hier fehl, Dies gilt auch für unvollständige Uploads, bei denen das Archiv Dateien verloren hat.
4. PHP zu alt
Sie erhalten die aktuelle und die erforderliche Version im selben Satz, Dies macht es zu dem am einfachsten umzusetzenden der fünf. WordPress liest die Themes Erfordert PHP Header und vergleicht ihn mit dem, was Ihr Server ausführt. Die Lösung liegt auf der Seite Ihres Hosts, nicht in WordPress, Bei den meisten Bedienfeldern dauert es etwa eine Minute. Unser Leitfaden zu Fixierung der “WordPress erfordert eine neue PHP-Version” Warnung zeigt an, wo sich dieses Dropdown in den einzelnen Panels befindet, und was man zuerst prüfen sollte.
5. WordPress zu alt
Gleiche Form, anderer Header. Das Thema erklärt Erfordert mindestens und Ihre Installation befindet sich darunter. WordPress aktualisieren, dann erneut hochladen.
Es gibt eine sechste Variante, die lautet “Das Paket enthält keine Dateien.” Das bedeutet, dass das Archiv nichts entpackt hat, was in der Praxis einen beschädigten Download bedeutet.
“Nur .zip-Archive” und “Inkompatibles Archiv.” Sind verschiedene Probleme
Diese beiden sehen austauschbar aus, sind es aber nicht. Die erste ist eine Dateinamenprüfung, and it’s stricter than people expect. WordPress lowercases your filename and tests whether it ends in .zip. That’s the whole test. A .rar or .tar.gz gets rejected here, and so does a file your operating system helpfully renamed to theme.zip.download. Nothing has been examined at this point except the name.
The second message means the name passed and the contents didn’t. Schon seit WordPress 6.4.4, freigegeben 9 April 2024, core validates the archive before unpacking it. A file that isn’t a working zip gets caught early and cleanly. The usual cause is an interrupted download. Redownload the theme, compare the file size against what the vendor lists, und versuchen Sie es erneut.
One word on renaming, because that advice circulates and it doesn’t work. Changing a .rar extension to .zip gets you past the first check and straight into the second. RAR und ZIP sind unterschiedliche Formate. Sie benötigen die tatsächliche Postleitzahl, oder ein Archivierungstool, um den Inhalt neu zu packen.
“Zielordner existiert bereits” Bedeutet normalerweise, dass Sie ein Update durchführen
WordPress überschreibt einen Theme-Ordner nicht ohne Aufforderung. Wenn wp-content/themes/yourtheme ist schon da, Die Installation wird mit dieser Meldung abgebrochen. In aktuellen Versionen erhalten Sie nicht nur den Fehler, obwohl. WordPress zeigt eine Bildschirmüberschrift an “Dieses Theme ist bereits installiert”, Vergleich der installierten und hochgeladenen Kopien nebeneinander. Es listet den Themennamen auf, Ausführung, Autor, erforderliche WordPress-Version, erforderliche PHP-Version und übergeordnetes Theme, bietet dann an, die aktuelle Kopie zu ersetzen.
Nehmen Sie diesen Vergleich ernst, bevor Sie durchklicken. Wenn die hochgeladene Version ist untere als das installierte, WordPress warnt Sie und fordert Sie auf, zuerst ein Backup zu erstellen. Das ist der Bildschirm, der Leute auffängt, die statt der aktuellen Version eine alte Zip-Datei aus ihrem Download-Ordner geholt haben.
Wenn Sie den bloßen Fehler ohne Vergleichsbildschirm sehen, Der Ordner existiert, aber WordPress konnte nicht genug von Ihrem Upload lesen, um ihn vergleichen zu können. Löschen Sie zuerst den alten Theme-Ordner über SFTP, dann erneut hochladen. Löschen Sie das Theme, das Sie gerade ausführen, nicht, solange es aktiv ist, obwohl. Wechseln Sie zunächst zu einem Standardthema. Unser Leitfaden zum Thema Ein WordPress-Theme sicher ändern deckt ab, was kaputt geht, wenn Sie das tun.
Es gibt überhaupt keine Schaltfläche zum Hochladen eines Themes
Das ist kein Fehler, Es gibt also nichts zu suchen, Deshalb verschwendet es so viel Zeit. Drei Regeln können die Schaltfläche ausblenden, nur einer davon ist verhandelbar, und eine vierte Sache verbirgt es, die überhaupt keine Regel ist.
Multisite. Bei einer Netzwerkinstallation, core denies the theme upload capability to anyone who isn’t a Super Admin. Nicht “hides it by default”, nicht “your host turned it off”. A regular site administrator on a multisite network cannot upload a theme, and no plugin or role editor changes that cleanly. Themes get installed once at the network level and then enabled per site. If you’re a site admin, your network admin has to do it.
DISALLOW_FILE_MODS. One line in wp-config.php switches off all plugin and theme installing and updating from the admin. It removes the button rather than showing a message. Managed hosts set it routinely, and so do agencies locking down client sites. Search wp-config.php for it. If you own the server, removing the line restores the button. If you’re on managed hosting, Diese Konstante ist normalerweise absichtlich vorhanden und Ihr Gastgeber möchte wissen, warum Sie sie ändern.
Ihre Benutzerrolle. Nur Administratoren erhalten diese Funktion. Wenn Sie Redakteur sind, das ist die Antwort.
Es gibt einen vierten Fall, der identisch aussieht, es aber nicht ist. Core markiert die Schaltfläche „Thema hochladen“ als „Nur JavaScript“., und das dahinter liegende Upload-Formular wird in CSS ausgeblendet, bis JavaScript es anzeigt. Wenn also Ihr Administrator-JavaScript kaputt geht, beide verschwinden gleichzeitig und nichts auf dem Bildschirm erwähnt Berechtigungen. Der Tell ist eine Mitteilungslesung “Für den Theme-Installer-Bildschirm ist JavaScript erforderlich”, was WordPress nur anzeigt, wenn JavaScript nicht ausgeführt wird. Wenn Sie das sehen, sind Ihre Berechtigungen in Ordnung. Verfolgen Sie den Plugin-Konflikt oder das blockierte Skript, oder nur Installieren Sie das Theme manuell und mich später mit dem JavaScript befassen.
WordPress.com ist ein eigener Fall, Und die Regel wurde kürzlich so geändert, dass die meisten Reiseführer immer noch falsch liegen. WordPress.com hat das Hochladen benutzerdefinierter Themes in seine Personal- und Premium-Pläne zwischenzeitlich eröffnet 15 November und 12 Dezember 2025. Archivierte Kopien der Support-Seite bestätigen die Änderung. Auf 15 November hieß es auf der Seite noch “Geschäfts- und Handelspläne, und der alte Pro-Plan”. Durch 12 Im Dezember wurden alle vier kostenpflichtigen Pläne aufgelistet. Wenn Ihnen jemand gesagt hat, dass der Businessplan das Minimum für ein Theme-Zip ist, Dieser Rat ist ungefähr ein Jahr alt. Darauf zu reagieren ist teuer. Persönliche Kosten betragen 4 USD/Monat, geschäftliche Kosten 25 USD/Monat, Die falsche Beratung belastet Sie also US Dollar 252 zusätzlich pro Jahr. Kostenlose Websites können immer noch keine Themen hochladen. Es gibt auch eine schwierige 50 MB Kap zum Thema Zip dort, getrennt von allem, was PHP tut.
WordPress Asks for FTP Credentials Instead of Installing
Sie klicken auf „Installieren“ und WordPress fragt nach einem Hostnamen, Benutzername und Passwort. Dies ist das Symptom, das am ehesten zu wirklich gefährlichen Ratschlägen führt, Hier ist also, was tatsächlich passiert.
Bevor Sie etwas anfassen, WordPress schreibt eine temporäre Datei hinein wp-Inhalt. Anschließend werden zwei Eigentümer verglichen: der Besitzer dieser neuen Datei, und der Besitzer der WordPress-PHP-Dateien, die sich bereits auf der Festplatte befinden. Wenn sie übereinstimmen, WordPress kommt zu dem Schluss, dass es sicher selbst Dateien schreiben kann und macht damit weiter. Wenn sie nicht übereinstimmen, oder der Schreibvorgang schlägt völlig fehl, WordPress fragt Sie stattdessen nach FTP- oder SSH-Details. Es möchte als Benutzer agieren, dem es vertraut.
Lesen Sie das noch einmal, weil die Konsequenz zählt. Der Standardauslöser ist ein Eigentumskonflikt, Kein Berechtigungsproblem. Wenn Sie den Ordner für alle Benutzer schreibbar machen, werden die Besitzer nicht übereinstimmend angezeigt. Dadurch ist Ihr Theme-Verzeichnis nur für jedes andere Konto auf dem Server beschreibbar. Beim Shared Hosting ist das ein echtes Highlight, and on any server it’s a bad trade. Never chmod 777 a WordPress directory to get past this prompt.
Three fixes work, in this order of preference.
- Ask your host to fix ownership so the web server user owns the files. It’s a two-minute job for them and the right answer on a properly configured server.
- Hinzufügen definieren(‘FS_METHOD’, ‘direct’); to wp-config.php. That tells WordPress to write directly and skip the ownership test. It only helps if the directory is actually writable.
- Enter the FTP credentials. Inelegant, but the prompt does work.
If none of those appeal, Installieren Sie das Theme manuell and the question disappears.
Die Grenzen selbst erhöhen, und was Sie nicht aufbringen können
PHP ships with upload_max_filesize at 2M, post_max_size at 8M und memory_limit at 128M. Most hosts raise these, but plenty of budget shared plans don’t raise them much. Four settings matter for theme uploads, and where you can change them depends on how PHP runs on your server.
The method that works on most modern hosting is a .user.ini file in your WordPress root, next to wp-config.php. PHP reads it when it runs under CGI or FastCGI, and that includes PHP-FPM (FastCGI-Prozessmanager, the way most control panels run PHP now). If your host uses PHP-FPM, this is your file. Four lines:
- upload_max_filesize = 64M
- post_max_size = 64M
- memory_limit = 256M
- max_execution_time = 300
That last line matters on slow connections. A large upload that takes longer than PHP allows gets killed mid-transfer, and you get a blank page rather than a message. Now the part that makes people give up on the file and go edit something else. PHP caches these files, und the default cache is 300 Sekunden. Speicher die Datei, wait five minutes, then reload the theme upload screen. WordPress zeigt das aktuelle Maximum auf der Upload-Seite der Medienbibliothek an, wenn Sie bestätigen möchten, dass die neue Anzahl wirksam wurde.
Die Alternative ist .htaccess mit php_value upload_max_filesize 64M und Freunde. Dies funktioniert, wenn PHP als Apache-Modul ausgeführt wird, und es funktioniert auf LiteSpeed, Das ist es, was viele cPanel-Hosts ausführen. Es funktioniert nicht auf Apache mit PHP-FPM, und der Misserfolg dort ist schlimm. Apache erkennt es nicht php_value ohne mod_php, das ältere Modul, das PHP in Apache selbst ausführte. Eine nicht erkannte Direktive in .htaccess führt dazu, dass Apache eine zurückgibt 500, Sie haben also jede Seite der Website entfernt, nicht nur der Upload. Wenn Sie diese Route ausprobieren, Lassen Sie die ursprüngliche .htaccess-Datei in einem anderen Tab geöffnet, damit Sie sie wieder einfügen können.
Einige Einstellungen können Sie in Ihrem Konto überhaupt nicht ändern, was auch immer irgendein Tutorial sagt. PHP klassifiziert file_uploads und upload_tmp_dir as system-level, so they’re settable only in the main php.ini. If uploads are switched off server-wide, or the temp directory is broken and you’re seeing “Missing a temporary folder”, that is a support ticket. upload_max_filesize und post_max_size are per-directory settings, which is exactly why the .user.ini and .htaccess methods reach them.
Memory has a similar catch. Hinzufügen definieren(‘WP_MEMORY_LIMIT’, '256M'); to wp-config.php is standard advice, and it does nothing if your host locked the memory limit at server level. WordPress raises memory by calling PHP’s own function, and PHP refuses. WordPress checks whether the value is changeable before it tries. Wenn nicht, your define is ignored silently.
Published ceilings differ more than people expect, and knowing your host’s number tells you whether to bother. WP Engine sets 50 MB standardmäßig und 1 MB on multisite. It will raise that to 256 MB auf Anfrage, und möchte darüber hinaus SFTP oder SSH. Kinsta startet Websites unter 128 MB. SiteGround-Sets 256 MB und verschiebt es nicht auf gemeinsame Pläne. Hostinger stellt den Wert direkt in hPanel unter PHP-Konfiguration bereit. Wenn die Obergrenze Ihres Plans für die Themen, mit denen Sie arbeiten, zu niedrig ist und der Support nicht nachgibt, Das ist ein Hosting-Problem, kein WordPress. Unser Shared-Hosting-Vergleich listet auf, was die günstigeren Tarife tatsächlich erlauben.
When the Upload Never Reaches PHP
Bei jedem oben genannten Fix wird davon ausgegangen, dass Ihre Datei an PHP gelangt. Manchmal ist das nicht der Fall, und dann sind PHP-Einstellungen irrelevant, egal wie hoch Sie sie einstellen. Vorne sitzen zwei Lagen, und jedes hat einen unverwechselbaren Fingerabdruck.
413 Anforderungselement zu groß. Auf Nginx kommt das her client_max_body_size, und der dokumentierte Standard von Nginx ist 1 MB. Das ist kleiner als PHPs eigene Standardeinstellung, und kleiner als die meisten Premium-Reißverschlüsse. Die Einstellung befindet sich in der Serverkonfiguration, Beim verwalteten Nginx-Hosting handelt es sich also um eine Supportanfrage. Auf Ihrem eigenen Server, Erhöhen Sie es im Serverblock und laden Sie es neu. Cloudflare gibt denselben Statuscode von seiner eigenen Obergrenze zurück. Diese Obergrenze ist 100 MB auf Free und Pro, 200 MB im Geschäft, und bis zu 5 GB auf Enterprise. Das Limit von Cloudflare gilt nur für sehr große Dateien. Sehen a 413 auf einen 20 MB-Thema hinter Cloudflare? Nginx ist der wahrscheinlichere Schuldige. Sie können dies testen, indem Sie Cloudflare kurz anhalten und es erneut versuchen.
403 Ohne WordPress-Stil verboten. Das ist eine Webanwendungs-Firewall. ModSecurity und Imunify360 prüfen den Anfragetext, und eine ZIP-Datei voller PHP-Dateien verstößt gegen Regeln, die zum Abfangen hochgeladener Malware geschrieben wurden. Es handelt sich um ein bekanntes Fehlalarm bei WordPress-Administratoraktionen, und CloudLinux veröffentlicht einen Support-Artikel über WAF-Regeln, die Site-Updates und Administratorzugriff blockieren. Sie können dies nicht in WordPress beheben. Bitten Sie Ihren Host, das WAF-Protokoll auf den Zeitstempel Ihres Uploads zu überprüfen und die ausgelöste Regel auf die Whitelist zu setzen. Wenn Ihr Gastgeber Ihnen ein Imunify-Dashboard zur Verfügung stellt, Die blockierte Anfrage erscheint unter Vorfälle mit einem Steuerelement zum Deaktivieren dieser Regel.
Hier finden Sie eine schnelle Möglichkeit, diese von einem PHP-Problem zu unterscheiden. Ein WAF- oder Proxy-Block gibt Ihnen eine reine Serverfehlerseite, ohne Admin-Leiste und ohne Styling. Durch ein PHP-Limit erhalten Sie eine Fehlerseite im WordPress-Stil. Wenn die Seite immer noch wie WordPress aussieht, Die Anfrage kam durch.
Installing Without the Uploader
Der Dashboard-Uploader ist praktisch, keine Voraussetzung. WordPress findet Themes, indem es ein Verzeichnis durchsucht, Das Ablegen des Ordners dort funktioniert also auf jeden Fall identisch. Wenn Sie zwanzig Minuten mit Grenzen verbracht haben, Wechseln Sie zu einem davon und fahren Sie fort. (Es gibt keinen Preis dafür, dass der Uploader funktioniert.)
Über SFTP oder einen Dateimanager. Entpacken Sie das Theme auf Ihrem Computer. Sie sollten am Ende einen einzelnen Ordner haben, der auf der obersten Ebene „style.css“ enthält. Laden Sie diesen Ordner hoch wp-content / themen. Aussehen neu laden > Themen und es ist da, bereit zur Aktivierung. Dadurch wird jedes PHP-Limit umgangen, alle WAF-Regeln und die Eingabeaufforderung für FTP-Anmeldeinformationen in einem Schritt, weil nichts über den Webserver gepostet wird. Bei den meisten Systemsteuerungs-Dateimanagern können Sie die ZIP-Datei auch hochladen und an Ort und Stelle extrahieren, was bei einer langsamen Verbindung schneller ist.
Mit WP-CLI. Wenn Sie SSH haben, wp theme install ../my-theme.zip wird aus einer lokalen Datei installiert, und hinzufügen –aktivieren Sie schaltet sofort darauf um. Es gibt auch –Gewalt um eine vorhandene Kopie zu überschreiben, Dies ist das Befehlszeilenäquivalent von “already installed” Bildschirm. If a theme is blocked by a version header you’re confident about, –ignore-requirements installs it anyway. Be careful with that last one. The author set that header because they expect the theme to break on older PHP.
One caution for both routes. Uploading by hand puts a theme on the site without any of core’s validation. A theme missing style.css simply won’t appear in the theme list, with no error to explain why. If the folder is there and WordPress doesn’t show it, open style.css and check the Theme Name header.
Welchen Fix Sie zuerst ausprobieren sollten
Ordering matters more than the individual fixes, because two minutes of checking saves an hour of editing config files. Arbeiten Sie diese der Reihe nach durch.
- Check the zip’s file size. Unter 8 MB and failing? Skip ahead, it’s not a limit. Über 8 MB with an “expired link” Error? That’s your answer.
- Überprüfen Sie den Inhalt der Zip-Datei. Öffne es. Ein Ordner oben, style.css darin, bedeutet, dass das Paket in Ordnung ist. Irgendetwas anderes, insbesondere eine Dokumentationsmappe, bedeutet, dass Sie den falschen Download haben.
- Lesen Sie den zweiten Satz. Das Karte oben bringt Sie direkt zur Sache.
- Versuchen Sie es mit einem kleinen Thema. Installieren Sie Twenty Twenty-Five, die aktuelle Standardeinstellung, direkt aus dem Theme-Verzeichnis. Wenn das funktioniert, Ihr Uploader und Ihre Berechtigungen sind in Ordnung, und das Problem ist Ihre Datei oder deren Größe. Wenn es auch scheitert, Das Problem ist serverweit.
- Schauen Sie sich die Fehlerseite an. WordPress-Styling bedeutet, dass PHP ausgeführt wurde. Eine nackte 403 oder 413 bedeutet, dass dies nicht der Fall war.
- Nur dann, Konfigurationsdateien bearbeiten. Beginnen Sie mit .user.ini, warte die vollen fünf Minuten, und bestätigen Sie das neue Limit, bevor Sie etwas anderes ändern.
Wenn Sie unter Zeitdruck auf einer Live-Site eine Fehlerbehebung durchführen, Kehren Sie diese Reihenfolge um und einfach SFTP den Ordner an Ort und Stelle. Bringen Sie die Website zum Laufen, Finden Sie dann heraus, warum der Uploader fehlgeschlagen ist, wenn niemand wartet.
An dieser Stelle noch ein Wort zu dem Tool, zu dem Sie in den meisten Ratgebern weitergeleitet werden. Gesundheitscheck & Zur Eingrenzung von Plugin-Konflikten wird weiterhin überall eine Fehlerbehebung empfohlen, und das hat es immer noch 200,000 aktive Installationen. Aber die letzte Veröffentlichung von WordPress.org war Version 1.7.1 auf 25 Juli 2024, nur bis WordPress getestet 6.6.7. Ausführen eines zwei Jahre alten Diagnose-Plugins für WordPress 7.1 Das Debuggen eines Uploads ist eine seltsame Möglichkeit, Ihre Variablen zu reduzieren. Benennen Sie den Plugins-Ordner stattdessen über SFTP um: es ist schneller, es ist reversibel, und es fügt der Installation, die Sie diagnostizieren möchten, keinen Code hinzu.
Häufig gestellte Fragen
Warum sagt WordPress “the link you followed has expired” wenn ich ein Theme hochlade?
Weil die Zip-Datei Ihres Themes größer ist als die von PHP post_max_size Rahmen, was standardmäßig ist 8 MB. PHP verwirft die gesamte Übermittlung, wenn diese Obergrenze überschritten wird, including the security token WordPress checks first. WordPress sees a missing token and prints its standard expired-link message. Erheben post_max_size und upload_max_filesize together, or install the theme over SFTP.
How big can a WordPress theme zip file be?
WordPress itself imposes no limit. Your ceiling is the lower of your host’s upload_max_filesize und post_max_size, and anything nginx or Cloudflare enforces in front of them. Published defaults range widely: WP Engine sets 50 MB, Kinsta 128 MB, SiteGround 256 MB, and stock PHP just 2 MB. WordPress.com caps theme zips at 50 MB regardless of plan.
Warum gibt es in meinem WordPress-Dashboard keine Schaltfläche zum Hochladen eines Themes??
Three likely reasons. You’re on a multisite network and aren’t a Super Admin, in which case core blocks it and only your network admin can install themes. Or wp-config.php contains DISALLOW_FILE_MODS, which most managed hosts set deliberately. Or your account isn’t an administrator. None of these produce an error message, which is why the button just isn’t there.
Benötige ich den Businessplan, um ein benutzerdefiniertes Theme auf WordPress.com hochzuladen??
Nicht mehr. WordPress.com hat das Hochladen benutzerdefinierter Themes auf Business eingeschränkt, Commerce und der alte Pro-Plan bis spät in die Nacht 2025. Auf der Support-Seite sind auch Personal und Premium aufgeführt 12 Dezember 2025. Kostenlose Websites können immer noch keine Themen hochladen. Wenn Sie in einem Leitfaden aufgefordert werden, den Business-Plan zu kaufen, dient lediglich die Installation eines Zip-Themes, Schauen Sie sich die Seite mit dem aktuellen Tarif an, bevor Sie bezahlen.
Kann ich ein WordPress-Theme ohne den Dashboard-Uploader installieren??
Ja, und es geht oft schneller. Entpacken Sie das Theme, Kopieren Sie dann den Ordner hinein wp-content / themen über SFTP oder mit dem Dateimanager Ihres Hosts. WordPress erkennt es beim nächsten Laden der Seite. Mit SSH-Zugriff, wp theme install ../my-theme.zip –aktivieren Sie macht dasselbe in einem Befehl. Beide Routen umgehen PHP-Upload-Limits, Firewallregeln und die Eingabeaufforderung für FTP-Anmeldeinformationen.
Is it safe to set the themes folder to 777 um einen Upload-Fehler zu beheben?
Nein, und es behebt es normalerweise nicht einmal. Wenn WordPress nach FTP-Anmeldeinformationen fragt, Der Auslöser ist ein Eigentumskonflikt. Der Eigentümer neu erstellter Dateien unterscheidet sich vom Eigentümer Ihrer WordPress-Dateien. Berechtigungen sind nicht das Problem. Einstellung 777 Macht das Verzeichnis für jedes Konto auf dem Server beschreibbar, ohne dass sich der Besitzer ändert. Bitten Sie Ihren Host, den Dateieigentum zu korrigieren, oder hinzufügen definieren(‘FS_METHOD’, ‘direct’); to wp-config.php.
Which hosts let me raise the upload limit myself, and which make me ask support?
Bei Hosts mit einem PHP-Einstellungsfeld können Sie es direkt ändern. Hostinger macht es in hPanel unter PHP-Konfiguration verfügbar, und die meisten cPanel-Hosts stellen es in den MultiPHP INI-Editor. Bei verwalteten Hosts ist dies im Allgemeinen nicht der Fall. WP Engine benötigt eine Supportanfrage, um darüber hinauszugehen 50 MB-Standard, zu einem 256 Maximal MB. SiteGround wird seine nicht erhöhen 256 MB-Obergrenze für gemeinsame Pläne überhaupt. Auf jedem Host, auf dem PHP-FPM läuft, können Sie auch selbst eine .user.ini-Datei ausprobieren, bevor Sie jemanden kontaktieren.
Fazit
Fehler beim Hochladen von Themes wirken zufällig, da die Fehlermeldungen die fehlgeschlagene Prüfung beschreiben und nicht den Fehler, den Sie gemacht haben. Sie sind nicht zufällig. Ein Reißverschluss vorbei 8 MB sendet Ihnen eine Nachricht über abgelaufene Links. Beim vollständigen Download von ThemeForest erhalten Sie eine Meldung über ein fehlendes Stylesheet. Ein Multisite-Site-Administrator erhält keine Schaltfläche und überhaupt keine Erklärung. Ordnen Sie mithilfe der Liste oben auf dieser Seite das Symptom der Ursache zu, und die meisten davon lösen sich innerhalb weniger Minuten auf.
Wenn sie es nicht tun, Hören Sie auf, gegen den Uploader zu kämpfen. Kopieren eines Theme-Ordners in wp-content / themen über SFTP funktioniert auf jedem Host, Benötigt keine Konfigurationsänderungen, und dauert weniger Zeit als ein Support-Ticket. Behalten Sie den Uploader für die Tage, an denen er kooperiert.
Die Installation des Themes ist selten der letzte Schritt, Hier sind also die Anleitungen für das, was normalerweise als nächstes kommt. Behebung von Abstürzen bei der WordPress-Anmeldung ist derjenige, den Sie lesen sollten, wenn ein neues Theme Sie von wp-admin ausgeschlossen hat. Und “wegen geplanter Wartungsarbeiten kurzzeitig nicht verfügbar” erklärt die Datei, die eine fehlgeschlagene Installation manchmal hinterlässt. Und wenn Sie ein vorhandenes Thema ersetzen, anstatt eines hinzuzufügen, Lesen Sie unseren Leitfaden zum sicheren Ändern eines WordPress-Themes, oben verlinkt. Es behandelt, was bei der Aktivierung kaputt geht und wie man ein Rollback durchführt.
