Você baixou um belo tema novo para seu site WordPress e tentou carregá-lo para o painel do WordPress. Infelizmente, o tema não foi instalado e apresentou o seguinte erro: “O pacote não pôde ser instalado. O tema não possui uma folha de estilos style.css”.

Neste artigo, vamos explorar a razão deste erro e como resolvê-lo. Também lhe mostraremos como evitar este erro no futuro através de uma sólida compreensão dos conceitos básicos das estruturas de arquivos do WordPress, bem como ajudando-o a garantir que você esteja carregando os arquivos corretos em primeiro lugar.

Vamos começar!

Onde o erro “O pacote não pôde ser instalado” aparece?

Este erro de carregamento de tema específico aparece no painel de controle do WordPress em Aparência > Temas > Adicionar Novo > Carregar Tema.

Isso ocorre principalmente logo após você clicar no botão Escolher arquivo, selecionar um arquivo para carregar e, em seguida, clicar no botão Instalar agora. Em resumo, o erro é exclusivo do módulo Adicionar Temas, portanto você não deve vê-lo em nenhum outro lugar no WordPress.

Clique no botão "Install Now" (Instalar Agora).
Clique no botão “Install Now” (Instalar Agora).

O texto de erro em si, que diz: “O pacote não pôde ser instalado. O tema não possui uma folha de estilos style.css“, é colocado na mensagem de status da instalação do tema, bem antes de outra mensagem que diz “A instalação do tema falhou”.

O erro de folha de estilo em falta.
O erro de folha de estilo em falta.

O que está acontecendo quando você vê o erro “O pacote não pôde ser instalado”?

É uma das raras vezes em que um erro na tela do seu computador lhe diz quase exatamente o que está acontecendo. Na segunda linha, ele diz: “O tema não possui uma folha de estilos style.css”.

Em resumo, você tentou instalar um tema WordPress através do upload do mesmo para o painel de controle do WordPress. Isto envolve um arquivo .zip preenchido com um complexo diretório de arquivos dos temas que contém código, folhas de estilo e responsabilidades para gerenciar e apresentar seu painel de controle, interface pública e muitos outros elementos do WordPress.

Este erro, em particular, mostra que ou a folha de style.css não está dentro daquela coleção de arquivos do WordPress, ou o WordPress tem dificuldade em encontrar a folha de estilo porque você carregou o arquivo incorretamente.

Em resumo, o erro ocorre porque não consegue detectar o arquivo style.css. Isto acontece devido a uma das seguintes razões:

  • O arquivo style.css está faltando no diretório raiz do seu tema porque o desenvolvedor do tema cometeu um erro.
  • O arquivo style.css está faltando no diretório porque você o apagou acidentalmente em algum momento.
  • O arquivo style.css está na verdade no diretório raiz, mas você não carregou o diretório corretamente no WordPress. Às vezes isso acontece quando você não descompacta o arquivo antes de fazer o upload.
  • Você está tentando carregar um arquivo que não pertence ao WordPress- pode não ser um arquivo do tema de forma alguma.

O que é folha de estilo style.css?

Seu diretório de arquivos WordPress contém muitos documentos e pastas, incluindo PHP, CSS, e codificação HTML.

CSS, ou folhas de estilo em cascata, refere-se a uma linguagem de web design usada em conjunto com PHP e HTML. A principal razão do CSS é estilizar elementos de web design estático com cores, formatos e fontes. Simplificando, o CSS faz com que o conteúdo do seu site fique bonito.

Um exemplo básico envolve uma imagem simples em seu site. O HTML só vai tão longe em termos de estilo. Ainda assim, o CSS reforça suas possibilidades de design com opções para mover essa imagem para qualquer local na página, adicionando margens, preenchimento, fundos e muitos outros elementos para uma abordagem mais visual do seu conteúdo.

No entanto, a planilha de style.css não funciona sozinha. Ela interage com todos os diretórios dentro do WordPress e muitas vezes trabalha em conjunto com outras linguagens de programação para produzir os resultados desejados.

Para um guia detalhado, vá para nosso artigo do WordPress CSS.

Onde a folha de estilo style.css deve estar?

A folha style.css é uma parte de todos os temas do WordPress. Como é a principal forma do WordPress controlar o design visual e o layout do seu site, é um arquivo obrigatório.

Isso significa que sempre que você comprar ou baixar um tema, você deve encontrar uma folha de style.css dentro dos arquivos de temas.

Nota: Normalmente é necessário descompactar o pacote de arquivos dos temas para visualizar os arquivos dos temas.

Por exemplo, fizemos o download do tema Hello Elementor e abrimos os arquivos dos temas para revelar uma lista de arquivos e pastas, incluindo a folha style.css.

Encontrando a folha de style.css.
Encontrando a folha de style.css.

A abertura da folha de style.css revela seu conteúdo, começando com informações essenciais como o nome do tema do autor. Você notará que ele lhe diz para não alterar nenhuma parte deste arquivo, pois muitos temas preferem que você faça modificações CSS dentro do painel de controle ou em outro diretório personalizado.

Um exemplo aberto da folha de style.css.
Um exemplo aberto da folha de style.css.

Rolando para baixo, a folha de style.css mostra uma longa lista de trechos de CSS, todos juntos para fazer seu tema parecer como ele é.

Código CSS na folha de estilos style.css.
Código CSS na folha de estilos style.css.

Portanto, a folha de style.css deve estar em todos os diretórios de arquivos dos temas, muitas vezes situados perto de outros arquivos CSS e perto de pastas para ativos e modelos.

O que acontece depois que você vê o erro “O pacote não pôde ser instalado”?

Uma pasta do tema sem a folha de estilos style.css é inútil, pelo menos quando se trata de carregá-la para o WordPress e fazer um tema totalmente funcional.

É impossível carregar o diretório raiz, pois o WordPress bloqueia todas as tentativas de carregar o arquivo sem a folha de estilo style.css. A razão para isto é porque uma folha de estilo em falta poderia quebrar ou prejudicar toda a infraestrutura do WordPress.

Além disso, você recebe a mensagem de erro: “O pacote não pôde ser instalado. O tema não possui uma folha de estilos style.css“.

A boa notícia é que qualquer tema previamente ativado em seu site WordPress permanece em vigor. Não há nenhum dano feito ao seu site, e você não pode carregar o novo tema.

No entanto, você pode querer substituir o tema atual, por isso é essencial percorrer as seguintes soluções para trocar o antigo e instalar o novo tema.

Como corrigir o erro “O tema não possui uma folha de estilos style.css”?

Nesta seção, delinearemos as duas principais razões para ver o erro de folha de estilo que falta, juntamente com informações sobre como resolver os problemas.

Como resolver uma situação em que seu tema está faltando o arquivo Style.css

Um arquivo style.css em falta significa uma de duas coisas: o desenvolvedor do tema (potencialmente você) não o incluiu no diretório raiz, ou você mesmo removeu involuntariamente o arquivo style.css.

Com a primeira situação, recomendamos o seguinte curso de ação:

  1. Entre em contato com o desenvolvedor do tema e notifique-o sobre o problema: Embora improvável, você pode ter um download ruim ou alguém/alguma coisa na ponta do desenvolvedor cometeu um erro. Os desenvolvedores de temas confiáveis devem dar uma resposta rápida com um novo arquivo de temas. Se você é o desenvolvedor do tema, leia este guia sobre a criação de temas infantis, especialmente a seção sobre como fazer uma folha de estilo.
  2. Procure por um novo tema: Este é provavelmente o melhor curso de ação, considerando que é raro para um desenvolvedor de um tema de qualidade perder uma das partes mais críticas. Talvez você tenha baixado um tema de uma fonte esboçada ou de um iniciante que esteja aprendendo a codificar.

Você poderia acrescentar uma folha de style.css, mas esse tipo de folha derrota o propósito de usar um tema pré-fabricado em primeiro lugar. Sem mencionar que um tema que deveria ter uma folha de estilo, mas que agora está faltando, não funcionaria direito.

Como resolver uma situação em que o WordPress não reconhece o arquivo style.css

Às vezes, o WordPress não consegue reconhecer uma folha style.css dentro de um diretório do tema quando você tenta carregá-la no painel de controle.

As razões para isto incluem o seguinte:

  • Você não está carregando o tema corretamente.
  • É preciso descompactar o arquivo original do desenvolvedor para revelar o arquivo do tema.
  • O arquivo do tema não é para WordPress.
  • O arquivo não é um arquivo do tema, mas algo mais.
  • O style.css não está no lugar certo dentro do diretório raiz.

Algumas dessas razões podem parecer simples, mas muitas vezes as razões mais superficiais causam problemas frustrantes.

Dê uma olhada nas seções abaixo para entender como resolver essas situações com base nas causas de raiz.

Carregue o tema de forma adequada

Uma razão pela qual você pode ver “O pacote não pôde ser instalado”. O erro “O tema não possui uma folha de estilos style.css stylesheet” é devido ao seu processo de carregamento do arquivo de temas.

Um novo usuário, ou mesmo um usuário experiente, pode se afastar acidentalmente dos melhores passos para carregar um arquivo do tema.

Por favor, leia nosso guia sobre a instalação de um tema WordPress para garantir que você siga os passos adequados. O artigo cobre a busca dos melhores temas do WordPress e métodos de instalação, como através do painel de controle ou FTP. Ele também guia você através das formas ligeiramente diferentes de instalação de temas gratuitos versus temas premium.

Veja se o arquivo do tema requer descompactação

Muitos erros de carregamento de temas ocorrem por causa de um arquivo de download zipado. É um pouco confuso para as pessoas que consideram o WordPress aceitar somente arquivos compactados.

Entretanto, alguns desenvolvedores de temas fornecem um arquivo zipado, e você deve descompactar o pacote original para encontrar o arquivo de upload válido que inclui apenas o conteúdo do tema.

Por exemplo, você pode descobrir que um desenvolvedor de um tema empacota outra documentação no download original, então o WordPress vai olhar todo esse conteúdo e se perguntar onde está o arquivo de tema real.

Embora a maioria dos desenvolvedores de temas conceituados saiba disso, tropeçamos na rara situação em que você tem que descompactar o primeiro download do tema para ver coisas como manuais de usuário e outros conteúdos.

Além de carregar um arquivo do tema da maneira errada no ponto anterior, este é o primeiro problema que você deve resolver antes de olhar para outros métodos, considerando que é uma solução fácil e ainda um pouco familiar para os desenvolvedores de temas fazerem isso. Isso também só acontece quando você compra um tema de um desenvolvedor terceirizado, vendo como a Biblioteca de Temas do WordPress.org restringe estranhamente os arquivos de temas zipados.

Então, digamos que você carregue um arquivo zipado de um desenvolvedor terceirizado, apenas para descobrir que você recebe a leitura de erro: “O pacote não pôde ser instalado. O tema não possui uma folha de estilos style.css“.

Há uma boa chance de tudo o que você tem que fazer é descompactar o arquivo original fornecido pelo desenvolvedor do tema para extrair mais um arquivo ZIP dentro dele.

Erro "O pacote não pôde ser instalado".
Erro “O pacote não pôde ser instalado”.

Para resolver o problema, vá para o arquivo que você baixou inicialmente do desenvolvedor do tema.

É muito provavelmente um arquivo ZIP, o que faz sentido para carregar no WordPress como um tema, mas pode conter arquivos de conteúdo adicionais que desorganizam a pasta e dificultam a identificação dos arquivos de tema pelo WordPress.

Encontre o arquivo de download zipado do tema.
Encontre o arquivo de download zipado do tema.

Portanto, abra ou descompacte o arquivo para extrair o que quer que esteja dentro dele. Geralmente é feito clicando com o botão direito do mouse e selecionando seu utilitário de descompactação ou arquivo preferido.

Descompacte o pacote temático baixado.
Descompacte o pacote do tema baixado.

Agora, abra o arquivo descompactado para mostrar seu conteúdo. Como você pode ver neste exemplo, os desenvolvedores do tema incluíram um arquivo readme.txt e outra pasta de conteúdo na raiz do download do tema. Eles também têm o verdadeiro arquivo de tema zipado nesta área. É o arquivo de tema real que você precisa carregar no WordPress.

Vá para Aparência > Temas > Adicionar novo > Upload Tema para escolher um arquivo do seu computador. Em seguida, certifique-se de selecionar este arquivo de tema zipado sem quaisquer extras (como o documento ReadMe neste exemplo).

O arquivo temático real.
O arquivo do tema real.

Lembre-se que você pode completar este processo de solução de problemas e descobrir que não é um problema onde o tema foi zipado de forma estranha. Se você não vir um arquivo de tema zipado dentro do pacote do tema original do seu desenvolvedor, considere as outras dicas de solução de problemas abaixo.

Determinar se o arquivo do tema é para WordPress

Muitos temas do site existem online. Não é raro ver um design de tema que você gosta, apenas para comprá-lo e descobrir que não é realmente para WordPress. Por exemplo, o mercado ThemeForest vende modelos de sites para vários sistemas de gerenciamento de conteúdo e construtores de sites, incluindo Drupal, Joomla, Webflow, e Shopify.

Cada plataforma tem sua estrutura de arquivos raiz para temas, portanto o WordPress rejeitará qualquer tentativa de carregar um tema destinado a outro sistema como o Bigcommerce ou o Magento.

Tenha em mente que você pode ver o erro “O tema não possui uma folha de estilos style.css” para uma situação como esta. Afinal, um diretório de temas da Shopify ou Drupal pode ter sua folha de style.css localizada em um lugar diferente. Entretanto, você também pode ver outro erro.

Quanto a resolver este problema, tudo o que você tem que fazer é se livrar do arquivo do tema não compatível e escolher um novo.

No futuro, dê uma olhada em todas as páginas de produtos do tema para garantir que eles sejam para WordPress e não para outra coisa. Por exemplo, a maioria das páginas de ThemeForest- e outras páginas de produtos do tema premium – mostram a plataforma na qual o tema está por várias vezes na página. Veja a categoria, o título e as imagens na página.

Procure menções de "WordPress" nas páginas de produtos.
Procure menções de “WordPress” nas páginas de produtos.

A maioria dos vendedores de temas também inclui uma área com o tipo de software ou versão para esse tema. Mais uma vez, veja que o WordPress é o principal software listado.

Confira a versão do software WordPress.
Confira a versão do software WordPress.

Ou você poderia se ater a bibliotecas All-WordPress como o WordPress.org Theme Directory.

Se você estiver tendo dificuldades para encontrar qualquer informação sobre o tema on-line, consulte o diretório de temas para ver como ele é. Mesmo que cada diretório de temas do WordPress tenha configurações e arquivos diferentes, você pode ter uma boa idéia se é, de fato, um tema do WordPress, procurando por alguns arquivos específicos.

Todos os temas do WordPress têm a folha style.css no diretório raiz. Você também deve ver pastas como ativos e pastas potenciais para os modelos. Procure arquivos como index.php, footer.php, e sidebar.php. Você às vezes os vê em temas para outras plataformas, mas muitas vezes eles recebem nomes diferentes ou estão localizados em outros lugares.

Certifique-se de que a folha de estilo esteja no lugar certo.
Certifique-se de que a folha de estilo esteja no lugar certo.

Descobrir se é um arquivo do tema

Você pode carregar muitos tipos de pastas zipadas para o WordPress, às vezes tornando difícil ver se é ou não um arquivo do tema. Na superfície, um arquivo de plugin não parece diferente de um arquivo de tema.

Você pode dizer o mesmo para um arquivo de importação de um site de outro site WordPress ou plataformas como Tumblr ou Blogger. Você também pode descobrir que você está tentando carregar um produto WooCommerce ou arquivo WXR para importar itens como artigos e páginas. A lista continua, mas a idéia é que nenhum desses arquivos é a mesma coisa que um arquivo do tema do WordPress.

Portanto, é importante checar novamente o que você está carregando em primeiro lugar. É possível clicar em um tipo de arquivo em seu computador que é nomeado algo semelhante, ou você tem dificuldade para distinguir entre um arquivo de plugin recente que você baixou e um arquivo de tema que você também baixou por volta da mesma hora.

A principal maneira de evitar isto é permanecer organizado e focado quando você salva e carrega arquivos WordPress. Certifique-se de manter os arquivos de temas em locais memoráveis e saiba os nomes dos arquivos quando eles forem baixados em seu computador.

Outra maneira de distinguir entre arquivos dos temas e outros arquivos orientados ao WordPress- é saber como é a estrutura do arquivo para cada um deles.

Recomendamos a leitura de nosso guia sobre arquivos WordPress e sua utilização, particularmente a seção Diretórios dos temas WordPress. Desta forma, você constrói seu conhecimento sobre a estrutura de pastas do WordPress e identifica o que um arquivo faz quando você vê seu conteúdo.

Para esta situação, favor abrir o arquivo que você está tentando carregar e garantir que ele se pareça com um arquivo do tema.

Digamos que temos dois arquivos, e não nos lembramos do nome específico do tema. Você pode ter problemas para decidir qual dos dois você deve carregar no WordPress. Sabemos que um deles é um arquivo plugin, e o outro é um arquivo do tema. Comece descompactando os dois para ver o que está dentro.

Decidir que arquivo é para um tema.
Decidir que arquivo é para um tema.

Abra cada arquivo separadamente para analisar o conteúdo.

Abra cada diretório de arquivos.
Abra cada diretório de arquivos.

Este arquivo tem pastas como addons, bens, blocos e classes. Ele não inclui pastas e arquivos dos temas padrão. Embora todos os arquivos de plugins pareçam um pouco diferentes, é seguro dizer que isto parece mais um plugin do que um tema.

Este diretório se parece com um plugin.
Este diretório se parece com um plugin.

O outro arquivo revela uma extensa coleção de pastas e arquivos PHP. O arquivo style.css está lá, juntamente com os temas essenciais como footer.php, header.php, e sidebar.php. Também é relativamente comum ver pastas para CSS, fontes e partes de templates em um arquivo do tema.

Portanto, este é o arquivo do tema que estamos procurando, e o outro é para um plugin. No futuro, fique de olho nos atributos clássicos de um arquivo do tema para garantir que você carregue os arquivos adequados.

Um exemplo de um arquivo temático.
Um exemplo de um arquivo do tema.

Certifique-se de que o arquivo style.css está no lugar certo

Seja por você ou pelo desenvolvedor, o arquivo style.css pode não estar no lugar certo.

Não importa porque isso ocorreu, apenas que o WordPress está procurando o arquivo style.css no diretório raiz, e ele não consegue encontrá-lo.

Para resolver este problema, examine a pasta raiz do tema e procure o arquivo style.css.

Temos a pasta raiz para o tema TwentyTwenty aberta, e parece que não há sinal da folha de estilos style.css. É possível que você a tenha arrastado involuntariamente para uma das outras pastas durante a organização, então você deve pelo menos levar alguns segundos para clicar nas pastas para ver se ela está lá dentro.

Falta a folha de estilo na pasta de raiz.
Falta a folha de estilo na pasta de raiz.

Acontece que a tínhamos mudado para a pasta Templates. O WordPress pode ter problemas para reconhecer a folha style.css se ela não estiver na pasta raiz, então mova-a de volta para a pasta raiz, onde ela pertence.

Folha de estilo localizada no lugar errado.
Folha de estilo localizada no lugar errado.

Resumo

O erro de folha de estilos style.css que falta vem de um arquivo de tema defeituoso, e só aparece quando você tenta carregar um arquivo na seção Adicionar Temas do WordPress.

As principais razões para ver a mensagem incluem:

  • O arquivo style.css está faltando devido ao desenvolvedor não o incluir no diretório.
  • O arquivo style.css está faltando porque você o apagou acidentalmente ou o moveu para outro lugar.
  • Você não está carregando o arquivo do tema da maneira correta.
  • Você precisa descompactar o arquivo para revelar o arquivo do tema real em um arquivo original que lhe foi dado pelo desenvolvedor.
  • O arquivo do tema não é para WordPress mas para outras plataformas como Shopify, ou Joomla, ou Drupal.
  • O arquivo não é um arquivo do tema. É algo mais, como um arquivo de plugin ou mesmo um documento aleatório ou um arquivo ZIP do seu computador.

Use este guia para resolver seus problemas de arquivo do tema, e entre em contato com o suporte ao cliente Kinsta se você continuar tendo problemas.

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.