WordPress refuse un thème car style.css est manquant

Situer le refus au moment de l’installation

Vous sélectionnez un fichier ZIP dans l’installation des thèmes et WordPress annonce que la feuille style.css manque. Ce message concerne la reconnaissance du paquet que vous venez de transmettre. Il ne signifie pas nécessairement que les styles du site public ont disparu. Le thème déjà actif peut continuer à fonctionner pendant que l’installation de ce nouveau paquet échoue.

Trois situations méritent d’être séparées. Le fichier peut être une extension envoyée à l’installateur des thèmes. Il peut aussi contenir une livraison complète, avec documentation et archives internes, plutôt que le thème directement installable. Enfin, il peut être un thème dont la structure ou certains fichiers ont réellement été perdus pendant sa préparation. La correction dépend de cette distinction.

Ne créez pas immédiatement un fichier vide appelé style.css. Ce fichier porte également des informations d’identification du thème, et sa présence ne suffit pas à rendre un paquet fonctionnel. Ajouter un faux en-tête à une extension ou à une livraison incomplète déplacerait le problème. Le premier objectif est de retrouver le bon produit et son paquet officiel, puis de vérifier ce que l’installation doit ajouter au site.

Conserver le paquet initial et relever l’écran utilisé

Gardez le téléchargement original dans un dossier local clairement identifié. Travaillez sur une copie si vous devez ouvrir ou réorganiser une archive. Notez son nom exact, sa taille, la version annoncée et sa provenance. Ces informations permettront de demander le bon fichier au fournisseur sans modifier plusieurs fois un paquet devenu impossible à comparer.

Vous n’avez pas besoin d’activer immédiatement le produit pour établir que le bon installateur le reconnaît. Séparez les décisions : obtenir une archive correcte, installer le paquet prévu, puis éventuellement tester son activation et sa configuration. Chacune possède son propre résultat observable.

1. Relevez le texte complet de l’erreur et l’écran qui l’affiche. Apparence puis Thèmes et Extensions puis Ajouter correspondent à deux parcours différents, même si leurs boutons de téléversement se ressemblent.
2. Vérifiez le nom du produit sur sa page officielle ou dans la documentation livrée. Cherchez son type : thème, thème enfant, extension, kit de modèles ou fichier de démonstration.
3. Notez le thème actuellement actif et la présence éventuelle d’un dossier portant le même nom que le nouveau paquet. Une installation de dépannage ne doit pas écraser une version personnalisée sans sauvegarde adaptée.
4. Préparez une copie autorisée du site pour le premier essai d’installation. Gardez une sauvegarde des fichiers et des réglages utiles si un changement de thème doit ensuite être évalué.

Confirmer s’il s’agit vraiment d’un thème

Un produit qui ajoute un carrousel, un formulaire ou un outil d’édition peut être une extension, même si ses captures montrent une page complète. Fiez-vous à la désignation de l’éditeur et à ses instructions d’installation. Le nom du fichier ou son apparence commerciale ne suffisent pas. Un ZIP provenant de la rubrique Extensions de WordPress.org doit suivre le parcours des extensions.

Un kit pour un constructeur peut, de son côté, contenir des modèles à importer depuis ce constructeur. Il ne constitue pas automatiquement un thème WordPress. Dans ce cas, recherchez dans sa documentation l’outil d’import attendu et les prérequis. Ne tentez pas successivement tous les écrans d’import du site jusqu’à ce que l’un accepte le fichier.

Un thème enfant dépend d’un thème parent précis. Il possède sa propre identité et une déclaration de parent ; il ne faut pas le confondre avec une version allégée du paquet principal. Vérifiez les noms exacts des deux produits et les instructions fournies. Le thème parent peut devoir être présent avant que l’enfant puisse être activé correctement.

Si la provenance du ZIP est inconnue ou si la livraison contredit la page officielle, arrêtez l’installation. Demandez une archive identifiée à son propriétaire. Aucun plugin de réparation n’est utile pour deviner la nature d’un fichier dont vous ne connaissez pas l’origine ou le produit attendu.

Parcours 1 : utiliser le bon installateur pour une extension

Ce parcours s’applique seulement après avoir confirmé qu’il s’agit d’une extension. Le refus dans l’écran Thèmes devient alors cohérent : l’installateur attend la structure d’un thème et reçoit un autre type de produit. La solution consiste à utiliser l’archive officielle dans le parcours prévu pour elle, sans ajouter de fichier CSS ni changer son contenu.

Pour revenir en arrière, désactivez uniquement l’extension nouvellement testée et vérifiez le retour à l’état initial. Sa suppression peut déclencher un traitement de nettoyage propre au produit ; consultez ses règles avant de la supprimer. Ne retirez pas une extension déjà utilisée sur le site simplement parce qu’un premier téléversement a échoué dans l’écran des thèmes.

1. Sur la copie autorisée, retournez au tableau de bord. Ouvrez Extensions puis Ajouter, et choisissez le téléversement d’une extension si vous disposez d’un ZIP officiel.
2. Sélectionnez le ZIP original identifié et lancez une seule installation. Si WordPress propose de remplacer une extension déjà présente, comparez son nom et sa version au relevé initial. Laissez cette version en place tant que ses personnalisations et la restauration prévue n’ont pas été vérifiées.
3. Contrôlez le résultat dans la liste des extensions. Le produit doit être reconnu sous le nom attendu. Cette reconnaissance ne démontre pas encore sa compatibilité avec toutes les fonctions du site.
4. Si l’activation est nécessaire à votre objectif, faites-la dans la copie avec les sorties externes maîtrisées, puis testez la fonction prévue. Relevez les réglages ajoutés et les éventuels avertissements avant d’envisager le site réel.

Parcours 2 : retrouver le ZIP installable dans une livraison complète

Ouvrez le téléchargement dans un outil d’archives local, sans lancer de fichier inclus. Une livraison peut contenir un dossier de documentation, des fichiers de licence, des ressources de démonstration et un ZIP distinct pour le thème. La présence de ces éléments explique pourquoi envoyer toute la livraison à WordPress ne correspond pas toujours au paquet attendu.

Si aucune archive interne n’est documentée, ne choisissez pas un ZIP au hasard. Un fichier nommé demo peut contenir des articles de démonstration et un autre nommé assets uniquement des images. Demandez au fournisseur quelle livraison correspond au thème installable. Cette demande doit mentionner la version et la liste de dossiers observée, sans transmettre de clé de licence dans un espace public.

1. Consultez d’abord le fichier d’instructions de l’éditeur. Repérez le nom exact de l’archive à installer, ainsi que la distinction éventuelle entre thème principal et thème enfant.
2. Si un ZIP interne est désigné comme thème installable, copiez ce fichier dans un dossier de travail séparé. Conservez le téléchargement extérieur intact pour pouvoir revenir à son contenu d’origine.
3. Ouvrez le ZIP interne et vérifiez son premier dossier de thème. style.css doit appartenir à ce dossier, et non seulement à un dossier de documentation ou à une archive encore imbriquée.
4. Téléversez ce ZIP interne dans l’installateur des thèmes de la copie. Vérifiez le nom et la version reconnus, puis laissez le thème inactif le temps de contrôler les dépendances et l’aperçu disponible.

Lire l’arborescence au bon niveau

Le fichier style.css doit être placé au niveau attendu pour le thème. Une recherche globale qui trouve un fichier de ce nom quelque part dans le téléchargement ne suffit pas. Un paquet peut contenir plusieurs feuilles nommées style.css, par exemple dans une documentation, un exemple ou une dépendance. C’est leur position par rapport au dossier du thème qui donne un indice utile.

Pour une livraison qui contient « theme-a-installer.zip », ouvrez ce ZIP interne et vérifiez que vous trouvez directement « mon-theme/style.css », avec les autres fichiers du thème sous « mon-theme ». Le mécanisme de sélection descend d’un niveau quand le contenu extrait se réduit à un seul dossier. Une archive qui contient « livraison/mon-theme/style.css » ajoute un niveau de trop pour ce parcours. Récupérez le ZIP installable identifié par l’éditeur au lieu de recompresser la livraison extérieure.

Vérifiez également l’extension réelle du fichier. Certains outils masquent les extensions connues et peuvent afficher style.css alors que le nom complet est style.css.txt. Contrôlez le nom dans les propriétés ou dans la liste détaillée de l’archive. Ne renommez cependant pas un document arbitraire en feuille de style : son contenu doit provenir du thème attendu.

Un navigateur peut extraire automatiquement un téléchargement. Si vous ne disposez plus du ZIP original, reprenez le fichier installable depuis la source officielle autorisée ou les archives de livraison disponibles. N’utilisez pas la compression d’un dossier déjà modifié comme équivalent silencieux du paquet d’origine. Si vous devez reconstruire une archive, documentez précisément ce qui a été inclus.

Parcours 3 : vérifier un thème préparé par votre équipe

Pour un thème développé sur mesure, le responsable du projet peut examiner la livraison avant de la générer à nouveau. Le fichier style.css contient un en-tête qui identifie le thème. Pour un thème autonome, WordPress attend aussi un modèle d’entrée adapté à son architecture, par exemple index.php pour un thème classique ou templates/index.html pour un thème à blocs. Un thème enfant suit un autre contrôle grâce à sa déclaration de parent.

La présence de style.css n’est pas une vérification de sécurité, de qualité graphique ou de compatibilité. Elle permet à WordPress de reconnaître une partie de la structure. Le thème doit encore être testé sur ses pages utiles avant une activation réelle. Évitez d’ajouter des fichiers vides uniquement pour franchir chaque message d’erreur successif.

1. Comparez le dossier livré avec le projet de référence et sa procédure de fabrication. Identifiez si style.css a été oublié par une règle d’exclusion, placé dans un sous-dossier ou absent de l’artefact final.
2. Vérifiez avec le développeur que l’en-tête de style.css contient le vrai « Theme Name ». Pour un thème enfant, « Template » doit correspondre au nom exact du dossier du parent, plutôt qu’à son nom affiché. Récupérez ces valeurs depuis le projet de référence avant de reconstruire le paquet.
3. Générez un nouveau paquet depuis la procédure du projet, avec une version ou un identifiant de livraison permettant de le distinguer du paquet refusé. Conservez le fichier initial et le relevé des différences.
4. Reprenez l’installation dans la copie et notez le nouveau résultat. Si le message change vers un modèle absent ou une incompatibilité de version, traitez ce contrôle distinct au lieu de conclure que tout est réparé.

Agir avec un accès aux fichiers sans écraser le thème actif

Un accès SFTP ou au gestionnaire de fichiers peut aider à vérifier une installation partielle, mais il ne remplace pas l’identification du bon paquet. Commencez par confirmer l’installation WordPress et le dossier de contenu réellement utilisés. Un hébergement peut contenir une copie, un ancien site et le site actif avec des arborescences très proches.

Relevez ensuite les dossiers présents dans wp-content/themes et le thème actif indiqué dans l’administration. Si un dossier de destination existe déjà, sauvegardez ses octets et ses personnalisations avant toute décision de remplacement. Un transfert qui fusionne deux versions peut laisser des fichiers anciens et rendre le résultat plus difficile à diagnostiquer qu’une installation propre.

Pour un thème réellement nouveau, le responsable peut déposer le dossier de thème complet au bon niveau, conformément à la documentation WordPress. Il doit retrouver style.css directement dans ce dossier et vérifier ensuite que l’administration reconnaît le thème. Le dépôt ne justifie pas une activation immédiate. Il faut encore contrôler le parent éventuel et les exigences WordPress et PHP annoncées.

Si vous n’avez pas accès à l’administration, transmettez le nom du dossier, la structure et la version du paquet au responsable du site. Ne modifiez pas en base le thème actif pour forcer un essai. La confirmation finale doit venir de l’installation qui sert réellement le site, avec un accès de récupération disponible si une activation est ensuite décidée.

Vérifier le résultat avec des témoins distincts

Organisez votre contrôle autour du type de paquet. Pour une extension envoyée par erreur comme thème, le témoin réussi est sa reconnaissance dans la liste des extensions. Pour un thème, c’est sa reconnaissance dans l’écran des thèmes avec les bonnes informations. Dans les deux cas, le thème initial doit rester actif tant que vous n’avez pas décidé de tester un changement d’apparence.

N’importez pas un contenu de démonstration pour vérifier seulement la reconnaissance du paquet. Cet import peut créer des pages, des médias et des réglages sans rapport avec style.css. Chaque opération supplémentaire doit répondre à un besoin identifié et disposer de son propre plan de retrait.

1. Comparez le produit reconnu avec la source officielle : nom, auteur, version et dépendance éventuelle. Un nom différent de celui attendu impose une vérification avant activation.
2. Pour un thème enfant, vérifiez la présence du parent attendu. Ne modifiez pas la déclaration du parent simplement parce qu’un autre thème est installé.
3. Si une activation est prévue dans la copie, testez au minimum l’accueil, une page, un article et la navigation. Vérifiez les zones personnalisées qui dépendent de l’ancien thème, ainsi que les formulaires utilisés.
4. Revenez au thème initial pour contrôler le retour. Comparez les menus et les réglages avec votre relevé ; revenir au thème ne garantit pas que chaque extension ou import de démonstration a annulé ses propres changements.

Rétablir l’état initial et fermer le diagnostic

Si l’installation a échoué sans remplacer un dossier existant, commencez par vérifier que le thème actif et ses fichiers n’ont pas changé. N’effacez pas des dossiers au hasard pour nettoyer un message d’erreur. Un nom ressemblant à celui du paquet ne prouve pas qu’il vient de votre tentative ; comparez avec l’inventaire réalisé avant l’essai.

Si vous avez ajouté un thème de test inactif, retirez-le seulement après avoir vérifié qu’aucun thème enfant ne dépend de lui. Si vous avez remplacé des fichiers, le retour doit utiliser la sauvegarde exacte de la version précédente et préserver les changements réalisés depuis par d’autres personnes. Évitez la restauration complète d’un site marchand pour corriger une seule livraison de thème.

Un compte rendu utile indique le fichier refusé, sa véritable nature, le paquet finalement reconnu et le résultat avant activation. Si le fournisseur doit intervenir, joignez la liste des premiers niveaux de l’archive et le texte de l’erreur, avec les données de licence masquées. La correction est établie lorsque le bon produit est reconnu par le bon installateur et que l’état initial reste récupérable ; l’activation et la recette fonctionnelle demeurent des étapes séparées.