Si WordPress respondió El paquete no pudo instalarse. No se encontró ningún archivo de plugin válido, la causa es casi siempre la misma, y no es una descarga corrupta: estás subiendo el paquete completo del autor, y no el ZIP de instalación que está dentro de él.
Vale la pena decir esto primero porque el camino natural desde aquí es el equivocado: descargar de nuevo, probar otro navegador, abrir un ticket. El archivo está íntegro; simplemente no es el archivo que WordPress espera.
Por qué existe el paquete completo
Quien vende un plugin en CodeCanyon o fuera de ahí suele entregar un ZIP con todo: el instalable, la documentación en HTML, el changelog, la licencia, a veces la versión para otro CMS y un PDF de instrucciones. Es el full package. Sirve para que el comprador tenga todo en una sola descarga, no para ser enviado a WordPress.
WordPress abre el ZIP, busca en la raíz un archivo PHP con el encabezado de plugin, encuentra una carpeta documentation/ y un readme.txt, y desiste. De ahí el mensaje.
Cómo encontrar el archivo correcto
Extrae el ZIP que descargaste y mira lo que contiene. Vas a encontrar algo parecido a esto:
documentation/: la documentación, no sirve para instalarlicensing/olicense/: texto de la licenciachangelog.txt: historial de versionesnome-do-plugin.zip: este es el que debes subir
La regla práctica: el instalable es el ZIP interno cuyo nombre es el nombre del plugin, normalmente el más pesado de la carpeta. Si en lugar de un ZIP encuentras una carpeta con el nombre del plugin, es ella la que necesita convertirse en ZIP: comprime la carpeta entera y sube el ZIP resultante.
Cómo confirmar antes de subir
Abre la carpeta del plugin y busca un archivo .php en su raíz. Tiene un encabezado que comienza con Plugin Name:. Si ese archivo está en la raíz de lo que vas a subir, WordPress lo va a aceptar.
Si el error habla de hoja de estilos en lugar de plugin, el caso es de tema y la lógica es parecida, y está descrito en «Stylesheet is missing».
Cuando el archivo está correcto y aun así falla
Si tienes la certeza de que estás subiendo el ZIP interno y el envío sigue fallando, el problema cambió de lugar: normalmente es el límite de subida del servidor. El síntoma es distinto: la pantalla se congela, vuelve en blanco o menciona el tamaño, en lugar de decir que el paquete es inválido.
Si ni siquiera eso lo resuelve, abre un ticket con el nombre del ítem, la versión y una captura de la pantalla de error. El mensaje literal identifica el caso casi siempre.
