プラグイン ZIP アップロード時に「互換性のないアーカイブです」と表示される

プラグイン → 新規追加 → プラグインのアップロード からプラグインの .zip ファイルをアップロードすると、WordPress が次のエラーを返します。

互換性のないアーカイブです。プラグインインストーラーに戻る

WordPress の再インストール、ブラウザの変更、「プラグインインストーラーに戻る」からの再試行のいずれも効果がなく、同じ ZIP が毎回失敗します。

なぜ WordPress はこのメッセージを表示するのか

WordPress はアップロードされた .zip を PclZip / ZipArchive リーダーで開き、wp-content/plugins/ にプラグインファイルをコピーします。リーダーが有効な ZIP のセントラルディレクトリ終端レコードを見つけられない場合、処理を中断して「互換性のないアーカイブです」と表示します。

主な原因は ZIP ファイルのダウンロード破損または不完全なダウンロード です。ディスク上の ZIP が実際には完全な ZIP ファイルになっていない状態です。よくある原因:

  • ダウンロードが中断された(ネットワーク切断、タイムアウト、ブラウザクラッシュ)ため、保存されたファイルが途中で切れている。
  • ブラウザがダウンロード時に自動で ZIP を展開した — macOS Safari や一部のブラウザ拡張機能は .zip を自動展開するため、フォルダまたは構造の異なる再圧縮 ZIP が残る。
  • 展開後に再圧縮された(例:macOS Finder で展開後のフォルダを再度 ZIP 化)ため、WordPress が想定しないラッパーフォルダの中にプラグインが入っている。
  • ファイルを編集・リネームしてバイト内容が変わった(例:アーカイブ GUI で開いて保存)。

解決方法

  1. ローカルの .zip を削除 — ディスク上のファイルを信用しない。
  2. 当社がお送りした元のリンクから再ダウンロード する。ダウンロードが完全に終わるまで他の操作をしない。
  3. ZIP を解凍しない — WordPress は生の .zip ファイルを要求します。展開後のフォルダや再圧縮版は受け付けません。
  4. macOS Safari をお使いの場合は、ダウンロード前に 環境設定 → 一般 → ダウンロード後、"安全な" ファイルを開く をオフにしてください(自動展開を防止)。または自動展開しない Chrome / Firefox を使用してください。
  5. 新しい .zipプラグイン → 新規追加 → プラグインのアップロード から再度アップロードします。

ZIP が壊れていないかの確認方法

アップロード前にファイルサイズが送付時と一致しているか確認してください。コマンドラインからも確認できます。

unzip -t wpc-site-installer.zip

正常な ZIP なら No errors detected in compressed data と表示されます。End-of-central-directory signature not found などのエラーが出た場合は破損確定 — 再ダウンロードしてください。

それでも解決しない場合

再ダウンロード後の新しい ZIP でも「互換性のないアーカイブです」が出る場合は、ブラウザ名、OS、ディスク上の ZIP ファイルサイズを明記のうえ support@wpproconverter.com までご連絡ください。代替リンクをお送りします。