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 instalarlicensing/oulicense/— texto da licençachangelog.txt— histórico de versõesnome-do-plugin.zip— este é 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.