O pacote não pôde ser instalado: você está subindo o arquivo errado – Ultrapack
23.484 items in the catalog12.037 updates delivered this month
982 sites receiving auto-updates through UAU
Installation

O pacote não pôde ser instalado: você está subindo o arquivo errado

Esse erro quase nunca é arquivo corrompido. É o pacote completo do autor sendo enviado no lugar do ZIP de instalação.

Se o WordPress respondeu O pacote não pôde ser instalado. Não foi encontrado nenhum arquivo de plugin válido, a causa é quase sempre a mesma, e não é download corrompido: você está enviando o pacote completo do autor, e não o ZIP de instalação que está dentro dele.

Vale dizer isso primeiro porque o caminho natural daqui é o errado — baixar de novo, tentar outro navegador, abrir chamado. O arquivo está íntegro; ele só não é o arquivo que o WordPress espera.

Por que o pacote completo existe

Quem vende um plugin no CodeCanyon ou fora dele costuma entregar um ZIP com tudo: o instalável, a documentação em HTML, o changelog, a licença, às vezes a versão para outro CMS e um PDF de instruções. É o full package. Ele serve para o comprador ter tudo em um download só — não para ser enviado ao WordPress.

O WordPress abre o ZIP, procura na raiz um arquivo PHP com o cabeçalho de plugin, encontra uma pasta documentation/ e um readme.txt, e desiste. Daí a mensagem.

Como achar o arquivo certo

Extraia o ZIP que você baixou e olhe o que tem dentro. Você vai encontrar algo parecido com isto:

  • documentation/ — a documentação, não serve para instalar
  • licensing/ ou license/ — texto da licença
  • changelog.txt — histórico de versões
  • nome-do-plugin.zipeste é o que você envia

A regra prática: o instalável é o ZIP interno cujo nome é o nome do plugin, normalmente o mais pesado da pasta. Se em vez de um ZIP você achar uma pasta com o nome do plugin, é ela que precisa virar ZIP — compacte a pasta inteira e envie o ZIP resultante.

Como confirmar antes de enviar

Abra a pasta do plugin e procure um arquivo .php na raiz dela. Ele tem um cabeçalho começando com Plugin Name:. Se esse arquivo está na raiz do que você vai enviar, o WordPress vai aceitar.

Se o erro fala em folha de estilos em vez de plugin, o caso é de tema e a lógica é parecida — está descrito em “Stylesheet is missing”.

Quando o arquivo está certo e mesmo assim falha

Se você tem certeza de que está enviando o ZIP interno e o envio continua falhando, o problema mudou de lugar: normalmente é limite de upload do servidor. O sintoma é diferente — a tela trava, volta em branco ou fala em tamanho, em vez de dizer que o pacote é inválido.

Se nem isso for, abra um chamado com o nome do item, a versão e uma captura da tela de erro. A mensagem literal identifica o caso quase sempre.