Vous avez téléchargé un nouveau thème magnifique pour votre site WordPress et vous avez essayé de le téléverser sur le tableau de bord de WordPress. Malheureusement, le thème n’a pas réussi à s’installer et a affiché l’erreur suivante : « Le paquet n’a pas pu être installé. La feuille de style style.css du thème est manquante ».

Dans cet article, nous allons explorer la raison de cette erreur et comment la résoudre. Nous vous montrerons également comment éviter cette erreur à l’avenir grâce à une solide compréhension des bases de la structure des fichiers WordPress, et en vous aidant à vous assurer que vous téléversez les bons fichiers.

C’est parti !

Où apparaît l’erreur « Le paquet n’a pas pu être installé » ?

Cette erreur particulière de téléversement de thème apparaît dans le tableau de bord WordPress sous Apparence > Thèmes > Ajouter un nouveau thème > Téléverser un thème.

Elle se produit principalement juste après avoir cliqué sur le bouton Choisir un fichier, sélectionné un fichier à téléverser, puis cliqué sur le bouton Installer. En bref, l’erreur est exclusive au module Ajouter un thème, vous ne devriez donc pas la voir ailleurs dans WordPress.

Cliquer sur le bouton « Installer maintenant ».
Cliquer sur le bouton « Installer maintenant ».

Le texte d’erreur lui-même, qui indique « Le paquet n’a pas pu être installé. La feuille de style style.css du thème est manquante », est placé dans le message d’état d’installation du thème, juste avant un autre message qui vous dit « L’installation du thème a échoué ».

L'erreur de feuille de style manquante.
L’erreur de feuille de style manquante.

Que se passe-t-il lorsque vous voyez l’erreur « Le paquet n’a pas pu être installé » ?

C’est l’une des rares fois où une erreur sur votre écran d’ordinateur vous dit presque exactement ce qui se passe. Dans la deuxième ligne, il est dit : « La feuille de style style.css est manquante ».

En bref, vous avez essayé d’installer un thème WordPress en le téléversant sur votre tableau de bord WordPress. Cela implique un fichier .zip rempli d’un répertoire de fichiers de thème complexe qui contient du code, des feuilles de style et des responsabilités pour gérer et présenter votre tableau de bord, votre interface publique et de nombreux autres éléments WordPress.

Cette erreur, en particulier, montre que soit la feuille de style style.css ne se trouve pas dans cette collection de fichiers WordPress, soit WordPress a des difficultés à trouver la feuille de style parce que vous avez téléversé le fichier de manière incorrecte.

En bref, l’erreur se produit parce qu’il ne peut pas détecter le fichier style.css. Cela se produit pour l’une des raisons suivantes :

  • Le fichier style.css est absent du répertoire racine de votre thème parce que le développeur du thème a fait une erreur.
  • Le fichier style.css est absent du répertoire parce que vous l’avez accidentellement supprimé à un moment donné.
  • Le fichier style.css se trouve en fait dans le répertoire racine, mais vous n’avez pas téléversé correctement le répertoire. Cela se produit parfois lorsque vous ne décompressez pas le fichier avant de le téléverser.
  • Vous tentez de téléverser un fichier qui n’a pas sa place dans WordPress – il ne s’agit peut-être pas d’un fichier de thème.

Qu’est-ce que la feuille de style style.css ?

Votre répertoire de fichiers WordPress contient de nombreux documents et dossiers, notamment le code PHP, CSS et HTML.

CSS, ou feuilles de style en cascade, désigne un langage de conception web utilisé conjointement avec PHP et HTML. La principale raison d’être de CSS est de styliser les éléments statiques de conception web à l’aide de couleurs, de formats et de polices. En d’autres termes, le CSS rend le contenu de votre site plus attrayant.

Un exemple de base est une simple image sur votre site web. Le HTML ne va pas plus loin en termes de style. Toutefois, le CSS renforce vos possibilités de conception grâce à des options permettant de déplacer cette image à n’importe quel endroit de la page, d’ajouter des marges, des marges intérieures, des arrière-plans et de nombreux autres éléments pour une approche plus visuelle de votre contenu.

Cependant, le fichier style.css ne travaille pas seul. Il interagit avec tous les répertoires de WordPress et travaille souvent main dans la main avec d’autres langages de programmation pour produire les résultats souhaités.

Pour un guide détaillé, consultez notre article sur les CSS de WordPress.

Où est censée se trouver la feuille de style style.css ?

Le fichier style.css fait partie de tous les thèmes WordPress. Comme c’est le principal moyen pour WordPress de contrôler la conception visuelle et la mise en page de votre site, c’est un fichier obligatoire.

Cela signifie que lorsque vous achetez ou téléchargez un thème, vous devriez trouver une feuille de style style.css dans les fichiers du thème.

Note : vous devez généralement décompresser le paquet de fichiers de thème pour afficher les fichiers de thème.

Par exemple, nous avons téléchargé le thème Hello Elementor et ouvert les fichiers du thème pour faire apparaître une liste de fichiers et de dossiers, dont le fichier style.css.

Trouver la feuille de style style.css.
Trouver la feuille de style style.css.

L’ouverture du fichier style.css révèle son contenu, en commençant par des informations essentielles comme le nom de l’auteur du thème. Vous remarquerez qu’il vous est demandé de ne modifier aucune partie de ce fichier, car de nombreux thèmes préfèrent que vous effectuiez les modifications CSS dans le tableau de bord ou dans un autre répertoire personnalisé.

Un exemple de la feuille de style style.css ouverte.
Un exemple de la feuille de style style.css ouverte.

En descendant, la feuille de style style.css présente une longue liste d’extraits CSS, tous réunis pour donner à votre thème son aspect actuel.

Code CSS dans la feuille de style style.css.
Code CSS dans la feuille de style style.css.

Ainsi, la feuille de style style.css est censée se trouver dans le répertoire de chaque fichier de thème, souvent situé près d’autres fichiers CSS et près des dossiers pour les ressources et les modèles.

Que se passe-t-il après l’apparition de l’erreur « Le paquet n’a pas pu être installé » ?

Un dossier de thème sans la feuille de style style.css est inutile, du moins lorsqu’il s’agit de le téléverser sur WordPress et d’en faire un thème pleinement fonctionnel.

Il est impossible de téléverser le répertoire racine, car WordPress bloque toute tentative de téléversement du fichier sans la feuille de style style.css. La raison en est qu’une feuille de style manquante pourrait casser ou endommager toute l’infrastructure de WordPress.

En outre, vous recevez le message d’erreur : « Le paquet n’a pas pu être installé. La feuille de style style.css du thème est manquante ».

La bonne nouvelle est que tout thème précédemment activé sur votre site WordPress reste en place. Votre site n’est pas endommagé et vous n’avez pas à téléverser le nouveau thème.

Cependant, il se peut que vous souhaitiez remplacer le thème actuel. Il est donc essentiel de suivre les solutions suivantes pour remplacer l’ancien thème et installer le nouveau.

Comment corriger l’erreur « La feuille de style style.css du thème est manquante » ?

Dans cette section, nous décrirons les deux principales raisons pour lesquelles l’erreur de feuille de style manquante se produit, ainsi que des informations sur la façon de résoudre ces problèmes.

Comment résoudre une situation où le fichier style.css est manquant dans votre thème ?

Un fichier style.css manquant signifie deux choses : le développeur du thème (potentiellement vous) a omis de l’inclure dans le répertoire racine, ou vous avez supprimé involontairement le fichier style.css.

Dans la première situation, nous recommandons la ligne de conduite suivante :

  1. Contactez le développeur du thème et informez-le du problème : bien que cela soit peu probable, il se peut que le téléchargement soit incorrect ou que quelqu’un ou quelque chose du côté du développeur ait commis une erreur. Les développeurs de thèmes réputés devraient vous donner une réponse rapide avec un nouveau fichier de thème. Si vous êtes le développeur du thème, lisez ce guide sur la création de thèmes enfants, en particulier la section sur la création d’une feuille de style.
  2. Cherchez un nouveau thème : C’est très probablement la meilleure solution, car il est rare qu’un développeur de thèmes de qualité omette l’une des parties les plus critiques. Vous avez peut-être téléchargé un thème auprès d’une source peu fiable ou d’un débutant qui apprend à coder.

Vous pourriez ajouter une feuille style.css, mais cela irait à l’encontre du but recherché par l’utilisation d’un thème préfabriqué. Sans compter qu’un thème qui était censé avoir une feuille de style, mais qui en est dépourvu, ne fonctionnerait pas correctement.

Comment résoudre une situation où WordPress ne reconnaît pas le fichier style.css

Parfois, WordPress ne peut pas reconnaître un fichier style.css dans un répertoire de thème lorsque vous tentez de le téléverser dans le tableau de bord.

Les raisons en sont les suivantes :

  • Vous n’avez pas téléversé correctement le thème.
  • Vous devez décompresser le fichier original du développeur pour révéler le fichier du thème.
  • Le fichier du thème n’est pas pour WordPress.
  • Le fichier n’est pas un fichier de thème mais quelque chose d’autre.
  • Le fichier style.css ne se trouve pas au bon endroit dans le répertoire racine.

Certaines de ces raisons peuvent sembler simples, mais souvent les raisons les plus superficielles sont à l’origine de problèmes frustrants.

Jetez un coup d’œil aux sections ci-dessous pour comprendre comment résoudre ces situations en fonction des causes profondes.

Téléverser correctement le thème

L’erreur « Le paquet n’a pas pu être installé . La feuille de style style.css du thème est manquante » est dû à votre processus de téléversement du fichier du thème.

Un utilisateur débutant, ou même un utilisateur expérimenté, peut accidentellement s’écarter des meilleures étapes pour téléverser un fichier de thème.

Veuillez lire notre guide d’installation d’un thème WordPress pour vous assurer que vous suivez les étapes appropriées. L’article couvre la recherche des meilleurs thèmes WordPress et les méthodes d’installation, comme via le tableau de bord ou le FTP. Il vous guide également à travers les méthodes légèrement différentes d’installation des thèmes gratuits et premium.

Vérifiez si le fichier du thème doit être décompressé.

De nombreuses erreurs de téléversement de thèmes se produisent à cause d’un fichier de téléchargement compressé. C’est un peu déroutant pour les gens qui pensent que WordPress n’accepte que les fichiers compressés.

Cependant, certains développeurs de thèmes vous donnent un fichier compressé dans un fichier compressé, et vous devez décompresser le paquet original pour trouver le fichier de téléversement valide qui ne comprend que le contenu du thème.

Par exemple, vous pouvez constater que le développeur d’un thème inclut d’autres documents dans le téléchargement original, de sorte que WordPress regarde tout ce contenu et se demande où se trouve le véritable fichier du thème.

Bien que la plupart des développeurs de thèmes réputés sachent que cela prête à confusion, nous sommes tombés sur une situation rare où vous devez décompresser le premier téléchargement de thème pour voir des choses comme les manuels d’utilisation et d’autres contenus.

En dehors du téléversement d’un fichier de thème de la mauvaise façon dans le point précédent, c’est le premier problème que vous devriez résoudre avant d’envisager d’autres méthodes, étant donné qu’il s’agit d’une solution facile et encore assez familière pour les développeurs de thèmes de faire cela. Cela ne se produit également que lorsque vous achetez un thème auprès d’un développeur tiers, étant donné que la bibliothèque de thèmes de WordPress.org restreint les fichiers de thème bizarrement emballés.

Donc, disons que vous téléversez un fichier compressé d’un développeur tiers, pour constater que vous recevez l’erreur suivante : « Le paquet n’a pas pu être installé. La feuille de style style.css du thème est manquante ».

Il y a de fortes chances que tout ce que vous ayez à faire soit de décompresser le fichier original fourni par le développeur du thème pour en extraire un autre fichier ZIP.

Erreur « Le paquet n'a pas pu être installé ».
Erreur « Le paquet n’a pas pu être installé ».

Pour résoudre le problème, allez dans le fichier que vous avez initialement téléchargé depuis le développeur du thème.

Il s’agit très probablement d’un fichier ZIP, ce qui est logique pour le téléverser dans WordPress en tant que thème, mais il peut contenir des fichiers de contenu supplémentaires qui encombrent le dossier et rendent difficile l’identification des fichiers du thème par WordPress.

Trouvez le fichier de téléchargement compressé du thème.
Trouvez le fichier de téléchargement compressé du thème.

Par conséquent, ouvrez ou décompressez le fichier pour extraire ce qu’il contient. Pour ce faire, cliquez avec le bouton droit de la souris et sélectionnez votre utilitaire de décompression ou d’archivage préféré.

Décompressez le paquet du thème téléchargé.
Décompressez le paquet du thème téléchargé.

Maintenant, ouvrez le fichier décompressé pour afficher son contenu. Comme vous pouvez le voir dans cet exemple, les développeurs du thème ont inclus un fichier readme.txt et un autre dossier de contenu à la racine du thème. Ils ont également placé le véritable fichier de thème compressé dans cette zone. Il s’agit du fichier de thème réel que vous devez téléverser dans WordPress.

Retournez dans Apparence > Thèmes > Ajouter un thème > Téléverser le thème pour choisir un fichier sur votre ordinateur. Ensuite, assurez-vous de sélectionner ce fichier de thème compressé sans aucun élément supplémentaire (comme le document ReadMe dans cet exemple).

Le fichier du thème.
Le fichier du thème.

N’oubliez pas qu’à l’issue de ce processus de dépannage, il se peut que vous découvriez qu’il ne s’agit pas d’un problème de conditionnement étrange du thème. Si vous ne voyez pas de fichier de thème compressé dans le paquet de thème original de votre développeur, envisagez de consulter les autres conseils de dépannage ci-dessous.

Déterminez si le fichier du thème est pour WordPress

De nombreux thèmes de sites web existent en ligne. Il n’est pas rare de voir un modèle de thème qui vous plaît, de l’acheter et de découvrir qu’il n’est pas vraiment pour WordPress. Par exemple, la place de marché ThemeForest vend des modèles de sites web pour divers systèmes de gestion de contenu et créateurs de sites web, notamment Drupal, Joomla, Webflow et Shopify.

Chaque plateforme possède sa propre structure de fichiers racine pour les thèmes, de sorte que WordPress rejettera toute tentative de téléversement d’un thème destiné à un autre système comme Bigcommerce ou Magento.

Gardez à l’esprit que vous pouvez voir l’erreur « La feuille de style style.css du thème est manquante » pour une situation comme celle-ci. Après tout, le répertoire d’un thème de Shopify ou de Drupal peut avoir sa feuille style.css située à un endroit différent. Cependant, vous pouvez également voir une autre erreur.

Pour résoudre ce problème, il vous suffit de vous débarrasser du fichier du thème non compatible et d’en choisir un nouveau.

À l’avenir, examinez attentivement toutes les pages de produits des thèmes pour vous assurer qu’ils sont destinés à WordPress et pas à autre chose. Par exemple, la plupart des pages de produits de ThemeForest et d’autres thèmes premium indiquent plusieurs fois sur la page la plateforme pour laquelle le thème est destiné. Regardez la catégorie, le titre et les images de la page.

Rechercher les mentions de « WordPress » sur les pages de produits.
Rechercher les mentions de « WordPress » sur les pages de produits.

La plupart des vendeurs de thèmes incluent également une zone avec le type ou la version du logiciel pour ce thème. Là encore, vérifiez que WordPress est le principal logiciel indiqué.

Vérifier la version du logiciel WordPress.
Vérifier la version du logiciel WordPress.

Vous pouvez aussi vous en tenir à des bibliothèques entièrement consacrées à WordPress, comme le répertoire de thèmes de WordPress.org.

Si vous avez du mal à trouver des informations sur le thème en ligne, regardez dans le répertoire du thème pour voir comment il est. Même si chaque répertoire de thème WordPress a des configurations et des fichiers différents, vous pouvez vous faire une bonne idée s’il s’agit, en fait, d’un thème WordPress en recherchant certains fichiers spécifiques.

Tous les thèmes WordPress ont la feuille style.css dans le répertoire racine. Vous devriez également voir des dossiers comme assets et des dossiers potentiels pour les modèles. Recherchez des fichiers tels que index.php, footer.php et sidebar.php. Vous les trouverez parfois dans les thèmes d’autres plateformes, mais ils portent souvent des noms différents ou sont situés à d’autres endroits.

Assurez-vous que la feuille de style est au bon endroit.
Assurez-vous que la feuille de style est au bon endroit.

Déterminer si c’est un fichier de thème

Vous pouvez téléverser de nombreux types de dossiers compressés sur WordPress, ce qui rend parfois difficile de voir s’il s’agit d’un fichier de thème ou non. En apparence, un fichier d’extension n’est pas différent d’un fichier de thème.

Vous pouvez dire la même chose pour un fichier d’importation de site provenant d’un autre site WordPress ou de plateformes comme Tumblr ou Blogger. Vous pouvez également constater que vous essayez de téléverser un produit WooCommerce ou un fichier WXR pour importer des éléments comme des articles et des pages. La liste est longue, mais l’idée est qu’aucun de ces fichiers n’est la même chose qu’un fichier de thème WordPress.

Il est donc important de vérifier en premier lieu ce que vous téléversez. Il est possible que vous cliquiez sur un type de fichier sur votre ordinateur dont le nom est similaire, ou que vous ayez du mal à faire la distinction entre un fichier récent d’extension que vous avez téléchargé et un fichier de thème que vous avez également téléchargé à peu près au même moment.

Le principal moyen d’éviter cela est de rester organisé et concentré lorsque vous enregistrez et téléchargez des fichiers WordPress. Assurez-vous de conserver les fichiers de thème dans des emplacements mémorisables et de connaître les noms des fichiers lorsqu’ils sont téléchargés sur votre ordinateur.

Une autre façon de distinguer les fichiers de thème des autres fichiers liés à WordPress est de savoir à quoi ressemble la structure de ces fichiers.

Nous vous recommandons de lire notre guide sur les fichiers WordPress et leur utilisation, en particulier la section des répertoires des thèmes WordPress. De cette façon, vous renforcez vos connaissances sur la structure des dossiers WordPress et identifiez ce que fait un fichier lorsque vous voyez son contenu.

Dans ce cas, ouvrez le fichier que vous essayez de téléverser et assurez-vous qu’il ressemble à un fichier de thème.

Disons que nous avons deux fichiers, et que nous ne nous souvenons pas du nom spécifique du thème. Vous pouvez avoir du mal à décider lequel des deux vous devez téléverser sur WordPress. Nous savons que l’un d’eux est un fichier d’extension, et l’autre un fichier de thème. Commencez par les décompresser tous les deux pour voir ce qu’ils contiennent.

Décider quel fichier correspond à un thème.
Décider quel fichier correspond à un thème.

Ouvrez chaque fichier séparément pour en analyser le contenu.

Ouvrir chaque répertoire de fichiers.
Ouvrir chaque répertoire de fichiers.

Ce fichier contient des dossiers tels que addons, assets, blocks et classes. Il n’inclut pas les dossiers et fichiers standard du thème. Bien que tous les fichiers d’extensions aient un aspect un peu différent, on peut dire que ce fichier ressemble davantage à une extension qu’à un thème.

Ce répertoire ressemble à une extension.
Ce répertoire ressemble à une extension.

L’autre fichier révèle une collection étendue de dossiers et de fichiers PHP. Le fichier style.css s’y trouve, ainsi que les éléments essentiels du thème comme footer.php, header.php et sidebar.php. Il est également relativement courant de voir des dossiers pour les CSS, les polices et les parties de modèle dans un fichier de thème.

Par conséquent, c’est le fichier de thème que nous recherchons, et l’autre est pour une extension. À l’avenir, gardez à l’œil les attributs classiques d’un fichier de thème pour vous assurer que vous téléversez les fichiers appropriés.

Un exemple de fichier de thème.
Un exemple de fichier de thème.

Assurez-vous que le fichier style.css est au bon endroit

Que ce soit par vous-même ou par le développeur, le fichier style.css peut ne pas être au bon endroit.

La raison de ce phénomène n’a pas d’importance, il suffit que WordPress cherche le fichier style.css dans le répertoire racine et qu’il ne le trouve pas.

Pour résoudre ce problème, examinez le dossier racine du thème et recherchez le fichier style.css.

Nous avons ouvert le dossier racine du thème TwentyTwenty, et il semble qu’il n’y ait aucun signe de la feuille de style style.css. Il est possible que vous l’ayez involontairement glissée dans l’un des autres dossiers lors de l’organisation, vous devriez donc au moins prendre quelques secondes pour cliquer dans les dossiers pour voir si elle s’y trouve.

Il manque la feuille de style dans le répertoire racine.
Il manque la feuille de style dans le répertoire racine.

Il s’avère que nous l’avions déplacée dans le dossier Templates. WordPress peut avoir des difficultés à reconnaître le fichier style.css si il n’est pas dans le dossier racine, donc remettez-le dans le dossier racine où elle doit être.

Feuille de style située au mauvais endroit.
Feuille de style située au mauvais endroit.

Résumé

L’erreur de feuille de style style.css manquante provient d’un fichier de thème défectueux, et elle n’apparaît que lorsque vous essayez de téléverser un fichier dans la section Ajouter des thèmes de WordPress.

Les principales raisons de voir le message sont les suivantes :

  • Le fichier style.css est manquant car le développeur ne l’a pas inclus dans le répertoire.
  • Le fichier style.css est manquant parce que vous l’avez accidentellement supprimé ou déplacé ailleurs.
  • Vous ne téléversez pas le fichier du thème de la bonne façon.
  • Vous devez décompresser le fichier pour révéler le fichier du thème réel dans un paquet original qui vous a été remis par le développeur.
  • Le fichier du thème n’est pas destiné à WordPress mais à d’autres plateformes comme Shopify, ou Joomla, ou Drupal.
  • Le fichier n’est pas un fichier de thème. C’est autre chose, comme un fichier d’extension ou même un document aléatoire ou un fichier compressé de votre ordinateur.

Utilisez ce guide pour résoudre vos problèmes de fichiers de thème, et veuillez contacter le support client de Kinsta si vous continuez à avoir des problèmes.

Salman Ravoof

Salman Ravoof is a self-taught web developer, writer, creator, and a huge admirer of Free and Open Source Software (FOSS). Besides tech, he's excited by science, philosophy, photography, arts, cats, and food. Learn more about him on his website, and connect with Salman on Twitter.