WordPress non riconosce un plugin nello ZIP caricato. Controlla di aver scaricato il pacchetto installabile, non l’intero progetto o un tema.
Indice dei contenuti
WordPress No valid plugins were found: significato
Le prime ipotesi da verificare per “WordPress No valid plugins were found” sono ZIP del progetto invece del pacchetto distribuibile; cartella del plugin annidata due volte.
Sintomi e cause probabili
Sintomi da verificare
- Il messaggio “WordPress No valid plugins were found” compare durante un’operazione ripetibile.
- La funzione coinvolta in WordPress file, media e aggiornamenti non raggiunge il risultato previsto.
- Per “WordPress: nessun plugin valido trovato nel pacchetto”, correla il messaggio PCLZIP o di installazione con il file realmente scaricato e con la directory usata per decompressione e copia, senza cancellare dati alla cieca.
- Per “WordPress: nessun plugin valido trovato nel pacchetto”, verifica prima integrita e struttura del pacchetto, poi directory temporanea, destinazione ed estrazione: ogni fase produce errori differenti.
Cause probabili
- ZIP del progetto invece del pacchetto distribuibile
- Cartella del plugin annidata due volte
- File principale privo dell’header Plugin Name
- Archivio corrotto o incompleto
Diagnosi passo per passo
- Elencare il contenuto dello ZIP senza eseguirlo
- Cercare il file PHP principale
- Verificare l’header del plugin
- Confrontare hash e dimensione del download
- Scaricare il pacchetto dalla fonte ufficiale
Log e dati da controllare
- Messaggio completo della schermata di installazione o aggiornamento.
- Percorso indicato nel log PHP e versione del componente.
- Permessi e risorse del percorso coinvolto, da controllare con il gestore.
Correzioni sicure
- Ispeziona l’archivio localmente senza eseguirne il codice e confrontalo con il rilascio ufficiale.
- Per software tuo, verifica struttura e intestazione Plugin Name del file principale.
- Per un plugin di terzi usa il pacchetto corretto: non aggiungere un header a file sconosciuti per forzarne l’installazione.
- Prova installazione e attivazione in staging, poi controlla la funzione del plugin e il log PHP.
Verifica finale
- Il plugin corretto viene installato e la sua funzione di prova riesce.
- Confronta il risultato con la prova iniziale e conserva gli eventuali errori rimasti.
Errori da evitare
- Non disattivare globalmente WAF, ModSecurity, antispam o verifica TLS per aggirare il sintomo
- Non impostare permessi 777 e non cambiare proprietari in modo ricorsivo senza conoscere la struttura dell’account
- Non cancellare database, chiavi Redis, cache o file di sistema senza backup e senza aver identificato l’oggetto coinvolto
- Non ripetere pagamenti, import o webhook reali finché non hai verificato l’idempotenza
Guide Xlogic correlate
- WordPress PCLZIP_ERR_INVALID_PARAMETER: parametro archivio non valido
- WordPress PCLZIP_ERR_BAD_FORMAT: archivio non valido
- WordPress: favicon non si aggiorna
Fonti tecniche
Domande frequenti
Che cosa significa “WordPress No valid plugins were found”?
WordPress non riconosce un plugin nello ZIP caricato. Controlla di aver scaricato il pacchetto installabile, non l’intero progetto o un tema.
Da cosa può dipendere “WordPress No valid plugins were found”?
Le cause da verificare per “WordPress No valid plugins were found” sono: ZIP del progetto invece del pacchetto distribuibile; cartella del plugin annidata due volte; file principale privo dell’header Plugin Name.
Quali controlli eseguire per “WordPress No valid plugins were found”?
Ispeziona l’archivio localmente senza eseguirne il codice e confrontalo con il rilascio ufficiale. Per software tuo, verifica struttura e intestazione Plugin Name del file principale. Per un plugin di terzi usa il pacchetto corretto: non aggiungere un header a file sconosciuti per forzarne l’installazione. Prova installazione e attivazione in staging, poi controlla la funzione del plugin e il log PHP.