WordPress a bien reçu votre fichier .zip, mais n’y trouve pas ce qu’il attend : pour une extension, un fichier PHP doté d’un en-tête d’extension ; pour un thème, un fichier style.css doté d’un en-tête de thème. Le plus souvent, ce n’est pas le bon fichier qui a été envoyé, ou pas au bon endroit.
Pourquoi cette erreur apparaît
- L’archive téléchargée chez l’éditeur contient tout le pack (documentation, licences, sources) et le paquet installable est un autre .zip rangé à l’intérieur.
- Un thème a été envoyé depuis la page Extensions, ou une extension depuis la page Thèmes.
- L’archive contient un dossier de trop : le fichier principal se trouve deux niveaux plus bas au lieu d’un.
- Le téléchargement s’est mal passé et l’archive est incomplète ou abîmée.
- Le fichier style.css d’un thème enfant fait à la main n’a pas d’en-tête correct.
Comment corriger le problème
Ouvrir le .zip sur votre ordinateur
Décompressez l’archive sur votre ordinateur et regardez son contenu. Si vous y voyez de la documentation, des fichiers de licence et un autre .zip portant le nom de l’extension ou du thème, c’est ce second fichier qu’il faut envoyer à WordPress.
Passer par le bon écran
Un thème s’installe depuis Apparence > Thèmes, bouton Ajouter un thème ; une extension depuis Extensions > Ajouter une extension. Un thème envoyé côté extensions donne « No valid plugins were found », une extension envoyée côté thèmes donne le message sur style.css.
Vérifier la structure de l’archive
Une archive correcte contient un seul dossier, avec directement dedans le fichier PHP principal de l’extension ou le style.css du thème. Si vous trouvez un chemin du type mon-extension/mon-extension/mon-extension.php, recompressez le dossier intérieur. Si l’archive refuse de s’ouvrir, ce que WordPress signale par « Incompatible Archive », téléchargez-la de nouveau depuis votre compte client.
Contrôler l’en-tête d’un thème enfant
Le fichier style.css d’un thème enfant doit commencer par un commentaire qui contient au moins Theme Name et Template. Template reprend le nom exact du dossier du thème parent, ici celui de Hello Elementor.
/*
Theme Name: Mon thème enfant
Template: hello-elementor
*/Installer sans passer par le formulaire
Si l’archive est saine mais que l’envoi échoue encore, décompressez-la et transférez le dossier par FTP dans wp-content/plugins ou wp-content/themes, puis activez-le depuis l’administration. Avec WP-CLI, l’archive s’installe directement.
wp plugin install ./mon-extension.zip
wp theme install ./mon-theme.zipNe récupérez vos extensions et thèmes payants que sur le site de l’éditeur ou dans votre compte client : une archive trouvée ailleurs peut contenir du code malveillant.
Un autre message d'erreur ? Collez-le dans le décodeur : il le reconnaît et vous oriente vers la bonne fiche.
Ouvrir le décodeur