WordPress-Fehler Incompatible Archive

Du willst ein Theme oder Plugin hochladen und WordPress zeigt dir stattdessen nur: Incompatible Archive.

Was bedeutet dieser Fehler?

WordPress konnte deine ZIP-Datei beim Hochladen nicht korrekt prüfen. Meistens liegt das daran, dass die ZIP-Datei mit der integrierten Komprimieren-Funktion von macOS erstellt wurde – die packt Archive in einem Format, mit dem WordPress (ab Version 6.4.3) manchmal nicht zurechtkommt.

So behebst du „Incompatible Archive“

Es gibt mehrere Wege, das Problem zu lösen. Für die meisten ist Option A der einfachste.

Option A (Windows): ZIP entpacken und neu komprimieren

Entpacke die ZIP-Datei auf deinem Rechner (Doppelklick genügt) und komprimiere den entpackten Ordner anschließend erneut (Rechtsklick → Senden an → ZIP-komprimierter Ordner). Lade diese neue ZIP-Datei hoch – jetzt sollte es klappen.

Option B: Code-Snippet einfügen

Installiere und aktiviere ein Code-Snippet-Plugin über Plugins → Installieren. Füge anschließend diesen Code-Schnipsel ein und lass ihn überall ausführen:

add_filter( 'unzip_file_use_ziparchive', '__return_false' );

Option C (Mac): ZIP entpacken und mit einem anderen Tool neu komprimieren

Verschiebe die ZIP-Datei in dein Benutzerverzeichnis, das macht das spätere Komprimieren per Terminal einfacher. Entpacke die Datei anschließend per Doppelklick.

Nutze danach ein Tool wie Keka oder das Terminal, um den Ordner neu zu komprimieren, und lade die neue Datei hoch.

So sieht der Terminal-Befehl aus:

  • Öffne das Terminal (Cmd + Leertaste, dann „Terminal“ eingeben)
  • Ersetze „custom_plugin“ durch den Namen deines Plugin- oder Theme-Ordners und führe diesen Befehl aus:
zip -vr custom-plugin.zip custom_plugin

Wichtig, falls du selbst ZIP-Dateien weitergibst

Da du eigene Kadence Child Themes verkaufst, betrifft dich das nicht nur beim eigenen Hochladen, sondern auch dann, wenn deine Kundinnen deine ZIP-Dateien installieren. Erstellst du deine Verkaufsdateien auf einem Mac, komprimiere sie mit einem Tool wie Keka oder per Terminal statt mit der Standard-Komprimieren-Funktion – so ersparst du deinen Kundinnen diesen Fehler von vornherein.

Terminal-Befehl auch hier:

zip -vr custom-plugin.zip custom_plugin/

Der Fehler geht auf einen Bug zurück, der mit WordPress 6.4.3 eingeführt wurde (Changeset 57388). Es gibt bereits ein Trac-Ticket, das den Fix dokumentiert: Ticket 60398.

Ähnliche Beiträge