Guia para Iniciantes sobre a Estrutura de Arquivos e Diretórios do WordPress

Quando você olha pela primeira vez para seus arquivos e pastas do WordPress, pode parecer um labirinto confuso. É natural se preocupar que um clique errado possa derrubar todo o seu site.

Nossa equipe trabalhou com milhares de sites WordPress, então entendemos bem esse sentimento. Conhecer essa estrutura é a chave para corrigir problemas comuns e gerenciar seu site com confiança.

Este guia será seu mapa amigável para a estrutura de arquivos e diretórios do WordPress. Mostraremos exatamente o que cada arquivo e pasta faz, para que você possa trabalhar em seu site sem medo.

Estrutura de arquivos e diretórios do WordPress explicada para iniciantes

Aqui está uma lista de tópicos que abordaremos neste guia:

Por que você deve aprender sobre a estrutura de arquivos e diretórios do WordPress?

Aprender sobre a estrutura de arquivos e diretórios do WordPress ajuda você a solucionar facilmente problemas comuns do WordPress.

Embora muitos usuários executem seus sites WordPress sem nunca tocar nesses arquivos, aprender sobre eles pode ser imensamente útil.

Este guia ajudará você a entender:

  • Quais arquivos e pastas do WordPress fazem parte do software principal.
  • Como o WordPress organiza seus uploads de imagens e mídia.
  • Onde seus temas e plugins instalados são armazenados.
  • Onde encontrar os arquivos de configuração chave para o seu site.

Esse conhecimento também ajuda você a entender como o WordPress funciona nos bastidores e quais arquivos são mais importantes para fazer backup.

Como acessar seus arquivos e diretórios do WordPress

Seus arquivos do WordPress residem no seu servidor de hospedagem web. Você pode acessar esses arquivos usando um cliente FTP ou o aplicativo Gerenciador de Arquivos no painel de controle da sua hospedagem WordPress.

Um cliente FTP é um aplicativo especial para se conectar ao seu servidor. Você pode conferir nosso guia sobre como usar FTP para fazer upload de arquivos do WordPress para instruções detalhadas.

Uma alternativa mais fácil para muitos usuários é o aplicativo Gerenciador de Arquivos. Essa ferramenta vem integrada na maioria dos painéis de controle de hospedagem WordPress.

Aplicativo gerenciador de arquivos no painel de controle de hospedagem

Uma vez conectado, você encontrará seus arquivos do WordPress dentro da pasta /public_html/ ou /www/.

Aqui, você verá uma estrutura de arquivos e diretórios que se parece com isto:

Arquivos e pastas do WordPress

Dentro desta pasta principal estão os arquivos e pastas principais do WordPress que executam seu site. Você não deve editar esses arquivos diretamente, com a rara exceção de .htaccess e wp-config.php.

Aqui está uma lista dos arquivos e pastas principais do WordPress. Nesta lista, [dir] indica um diretório, que é outro nome para uma pasta.

  • wp-admin [dir]
  • wp-content [dir]
  • wp-includes [dir]
  • index.php
  • license.txt
  • readme.html
  • wp-activate.php
  • wp-blog-header.php
  • wp-comments-post.php
  • wp-config-sample.php
  • wp-cron.php
  • wp-links-opml.php
  • wp-load.php
  • wp-login.php
  • wp-mail.php
  • wp-settings.php
  • wp-signup.php
  • wp-trackback.php
  • xmlrpc.php

A lista acima está faltando os arquivos .htaccess e wp-config.php. Isso ocorre porque esses dois arquivos são criados após a conclusão da instalação principal do WordPress.

Arquivos de Configuração do WordPress

Seu diretório principal do WordPress contém arquivos de configuração especiais.

Esses arquivos contêm configurações importantes que são específicas do seu site.

Arquivos de configuração do WordPress
  • .htaccess – Este é um arquivo de configuração do servidor. O WordPress o utiliza para gerenciar permalinks e redirecionamentos. Observe que o arquivo .htaccess é usado por servidores web Apache. Se o seu host usa um tipo de servidor diferente, como Nginx, ele não usará este arquivo.
  • wp-config.php – Este arquivo informa ao WordPress como se conectar ao seu banco de dados. Ele também define algumas configurações globais para o seu site. Para segurança adicional, você pode mover este arquivo um nível acima do seu diretório raiz público, e o WordPress ainda saberá como encontrá-lo.
  • index.php – Este arquivo atua como o ponto de partida. Ele inicia o processo de carregamento do restante do framework do WordPress para exibir seu site quando um usuário o visita.

Você pode precisar editar wp-config.php ou .htaccess às vezes. Tenha sempre cuidado extra ao editar esses dois arquivos. Um pequeno erro pode tornar seu site inacessível, portanto, sempre crie cópias de backup em seu computador antes de fazer quaisquer alterações.

Se você não conseguir encontrar o arquivo .htaccess em seu diretório raiz, confira nosso guia sobre por que o arquivo .htaccess pode estar oculto.

Dependendo da configuração do seu site, você pode ou não ter esses arquivos em seu diretório raiz:

Dentro da Pasta wp-content

O WordPress armazena todo o conteúdo adicionado pelo usuário, como uploads, plugins e temas, na pasta wp-content.

Pasta de conteúdo do WordPress

Embora esta seja a pasta com a qual você mais interagirá, ainda assim deve ter muito cuidado. Editar arquivos diretamente aqui sem saber o que está fazendo pode causar erros ou quebrar seu site.

Vamos dar uma olhada dentro da pasta wp-content para entender como ela funciona.

Dentro da pasta wp-content

Embora o conteúdo possa diferir entre sites, todos os sites WordPress terão estes:

  • [dir] temas
  • [dir] plugins
  • [dir] uploads
  • index.php
Pasta de Temas (/wp-content/themes/)

O WordPress armazena seus arquivos de tema nesta pasta. Não recomendamos editar um arquivo de tema diretamente. Se você atualizar o tema para uma versão mais recente, suas alterações serão substituídas.

É por isso que sempre recomendamos que você crie um tema filho para quaisquer personalizações de tema.

Dica alternativa para iniciantes 💡: A maioria dos usuários achará mais fácil trabalhar com SeedProd, um construtor de temas personalizado com arrastar e soltar, do que editar código.

Pasta de Plugins (/wp-content/plugins/)

Todos os plugins do WordPress que você baixa e instala em seu site são armazenados aqui. Você não deve editar arquivos de plugin diretamente, a menos que tenha escrito um plugin específico para o site WordPress para seu próprio uso.

Muitos tutoriais mostram trechos de código para adicionar ao seu site. A maneira mais fácil e segura de adicionar este código personalizado é usando um plugin de trechos de código.

Recomendamos o uso de um plugin como o WPCode porque ele evita os tipos de erros que podem quebrar seu site se você editar arquivos como functions.php diretamente.

Ele também mantém seus trechos de código organizados e separados do seu tema. Usamos o WPCode para gerenciar trechos de código em nossos próprios sites.

Para saber mais, veja nossa análise completa do WPCode ou siga nosso guia sobre como adicionar trechos de código personalizados no WordPress para instruções passo a passo.

Pasta de Uploads (/wp-content/uploads/)

O WordPress armazena todas as suas imagens e uploads de mídia na pasta /wp-content/uploads/. Por padrão, esses uploads são organizados em subpastas por ano e mês.

⚠️Importante: Ao criar um backup do WordPress, você deve incluir a pasta uploads. Embora você sempre possa baixar novamente o núcleo do WordPress, seu tema e plugins, esta pasta contém seu conteúdo exclusivo. Se você a perder, pode ser muito difícil restaurá-la sem um backup.

Outras Pastas em wp-content

Você pode ver algumas outras pastas em seu diretório wp-content:

Muitos plugins do WordPress também criam suas próprias pastas dentro de wp-content. Por exemplo, alguns plugins criam pastas dentro de /wp-content/uploads/ para salvar arquivos gerados pelo usuário.

Este site de demonstração tem pastas criadas pelos plugins Smash Balloon, WooCommerce, SeedProd e WPForms.

Plugins podem criar suas próprias pastas dentro do diretório de uploads

Algumas dessas pastas podem conter arquivos importantes, por isso recomendamos fazer um backup como precaução.

Outras pastas, como as criadas por plugins de cache como o WP Rocket, podem conter dados que você pode excluir com segurança.

Dentro da Pasta wp-admin

A pasta wp-admin contém todos os arquivos necessários para o funcionamento do seu painel administrativo do WordPress. Esta é a área de back-end onde você escreve posts, altera temas, instala plugins e gerencia seu site.

Ele inclui arquivos como admin.php, index.php e pastas para JavaScript, CSS e imagens usadas na interface do painel. Quando você faz login no WordPress, tudo o que você vê é carregado desta pasta.

A menos que você seja um desenvolvedor personalizando a área de administração, não há motivo para abrir ou editar nada dentro de wp-admin. Esses arquivos são essenciais para o funcionamento do seu site. Editar ou excluir um único arquivo pode quebrar seu site.

Se o seu painel de administração não estiver carregando, é mais seguro reinstalar o WordPress ou restaurar a partir de um backup do que tentar corrigir qualquer coisa dentro desta pasta manualmente.

Dentro da Pasta wp-includes

A pasta wp-includes é como a sala de máquinas do WordPress. Ela contém o código principal que faz o WordPress funcionar, incluindo funções, scripts e classes que alimentam temas, plugins e recursos.

Esta pasta tem centenas de arquivos, como functions.php, class-wp-query.php e pastas como js e fonts. Esses arquivos fazem coisas como controlar como as postagens são carregadas, como os widgets são exibidos e como seu tema interage com o WordPress.

Você nunca deve editar nada na pasta wp-includes. Estes são arquivos principais mantidos pelo WordPress. Quaisquer alterações que você fizer aqui serão substituídas durante a próxima atualização, e um único erro pode quebrar todo o seu site.

Se você estiver tentando personalizar a funcionalidade, é melhor usar plugins, hooks ou trechos de código personalizados com uma ferramenta como WPCode. Dessa forma, suas alterações ficam seguras, mesmo quando o WordPress for atualizado.

Perguntas Frequentes sobre a Estrutura de Arquivos e Diretórios do WordPress

É seguro excluir arquivos principais do WordPress?
Não. Você nunca deve excluir arquivos principais do WordPress, como os das pastas wp-admin ou wp-includes. Excluí-los quebrará seu site. Se você suspeitar que um arquivo está corrompido, você deve substituí-lo por uma cópia nova de um download oficial do WordPress.

Posso editar diretamente o arquivo functions.php do meu tema?
Embora você possa, não é recomendado. Qualquer erro pode causar a “tela branca da morte” e suas alterações serão perdidas quando você atualizar seu tema. É muito mais seguro usar um tema filho ou um plugin de snippets de código como o WPCode.

O que são permissões de arquivo e por que elas importam?
As permissões de arquivo controlam quem pode ler, escrever e executar arquivos em seu servidor. Permissões de arquivo incorretas podem ser um risco de segurança. Em geral, diretórios devem ser 755 e arquivos devem ser 644.

Recursos Adicionais

Esperamos que este artigo tenha ajudado você a entender a estrutura de arquivos e diretórios do WordPress. Você também pode querer conferir estes guias relacionados:

Se você gostou deste artigo, por favor, inscreva-se em nosso Canal do YouTube para tutoriais em vídeo do WordPress. Você também pode nos encontrar no Twitter e no Facebook.

Aviso: Nosso conteúdo é apoiado pelos leitores. Isso significa que, se você clicar em alguns de nossos links, poderemos ganhar uma comissão. Veja como o WPBeginner é financiado, por que isso importa e como você pode nos apoiar. Aqui está nosso processo editorial.

O Kit de Ferramentas Definitivo para WordPress

Obtenha acesso GRATUITO ao nosso kit de ferramentas - uma coleção de produtos e recursos relacionados ao WordPress que todo profissional deve ter!

Interações do Leitor

59 CommentsLeave a Reply

  1. Este é um tópico bem escrito porque muitas pessoas começam e param apenas com o arquivo wp-config.php. No entanto, o WordPress tem muitos outros arquivos, igualmente interessantes, que guardam vários outros segredos de trabalhar com este sistema. Aprecio que, ao contrário de outros sites, você aborda o tópico de uma forma verdadeiramente acessível para pessoas sem experiência. Afinal, você tem “iniciantes” em seu nome e está fazendo um ótimo trabalho.

  2. Boa visão geral & um artigo amigável para iniciantes!

    Então isso significa que o WordPress não tem um único arquivo index.html que seja responsável pelo ponto de partida do site? Em vez disso, ele tem index.php, é semelhante ao index.html?

  3. Eu sempre fantasiei sobre o que acontece nos bastidores para gerenciar uma interface front-end e back-end do WordPress tão boa.
    Este guia esclareceu todos esses aspectos dos bastidores do funcionamento do WordPress.
    Ter conhecimento sobre a estrutura desses arquivos e diretórios nos dá controle sobre os ajustes que podemos fazer.
    Obrigado wpbeginner por este guia sobre a estrutura de arquivos do WordPress.

  4. Obrigado por compartilhar esta informação. Isso ajudará muito durante a solução de problemas e o backup e restauração do site.

  5. Por favor, ajude-me a criar uma pasta dentro do meu blog hospedado no WordPress no meu site. Quero criar mais subpastas como notícias, vida, etc. para garantir que meus usuários recebam o conteúdo de forma mais organizada?

  6. Recebendo este erro: Erro fatal: Chamada para função indefinida wp() em XXXX\html\wp-blog-header.php na linha 12. Tentei várias soluções de problemas, mas não consigo resolver o problema. Parei o tema e os plugins.

  7. Olá
    Estou recebendo a mensagem de erro sobre um arquivo ads.txt ausente, sei onde encontrá-lo, mas não tenho certeza de onde devo inseri-lo.

    Atenciosamente
    Bruno
    Dinamarca

  8. Estou tentando fazer o upload de um arquivo descompactado para este local:

    wp-content/uploads/GeoLite2-Country.mmdb

    Pergunta: Como encontro o local e como faço o upload do arquivo descompactado para este local.

  9. Olá
    Meu site foi hackeado. Ele continua me redirecionando para um site de spam. Não consigo fazer login pelo painel (porque ele continua me redirecionando para um site de spam) e não tenho backup do site, mas ainda consigo acessar meu Cpanel, mas não sei o que fazer lá. Por favor, qualquer ajuda será apreciada.
    hemjaypost.com é o site

  10. Pergunta maluca.
    Depois de importar o conteúdo do site de demonstração em um site com o tema Avada – há tantas páginas que eu NÃO TENHO IDEIA de como voltar para identificar e editar minha página inicial no link de PÁGINAS? Agora tenho 8 páginas de "páginas". Como posso encontrar minha página inicial? A propósito – em LEITURAS > CONFIGURAÇÕES – marquei que o blog está atribuído à página inicial, NÃO a uma página ESTÁTICA. Muito obrigado!
    Eu pesquisei de várias maneiras – mas não consigo descobrir isso!

    • Olá Karen,

      Ao ir para Páginas » Todas as Páginas você deve conseguir ver — o rótulo Página Inicial ao lado da página usada como sua página inicial. Você também pode tentar entrar em contato com o desenvolvedor do tema para obter suporte.

      Admin

  11. Eu também quero encontrar onde meus antigos arquivos .htm que agora estão encapsulados no WordPress com URLs diferentes! Preciso excluir um arquivo xml ruim e não tenho ideia de como ir ao servidor e remover. Eu o removi permanentemente na lista de páginas, mas tenho medo que o Bing ainda pense que é isso que eu quero enviar. Ele continua dizendo que não é válido e eu quero removê-lo!
    Obrigado!

  12. olá
    Eu desenvolvi uma postagem personalizada em um site WooCommerce. Mas depois disso, quero usar um slider de fotos dinâmico nesta postagem personalizada, tentei muito, mas não consegui torná-lo dinâmico. Por favor, me guie sobre o uso de modelos de página e como tornar o slider dinâmico.

  13. Útil, mas eu quero editar uma página externamente sem o WordPress, por outro editor HTML, porque eu tento remover temas em algumas páginas específicas, mas não em todo o site.

  14. obrigado, foi muito útil… mas eu quero saber se é seguro substituir todos os arquivos principais do WordPress por novos arquivos?

  15. Olá, eu recentemente baixei meu antigo site Wordpress para o meu computador e instalei um novo site no meu domínio. Agora estou tentando procurar e encontrar todos os meus posts do blog do site antigo para poder adicioná-los ao novo site. Alguma ideia se isso é possível e onde eu os encontraria? Muito obrigado pela sua ajuda.

  16. qual é o nome do arquivo para os usuários no wordpress? Tenho um backup completo do meu site, movi para outro servidor, o número de usuários era cerca de 24 mil, mas agora encontrei apenas 9 mil e gostaria de restaurar o antigo. Agradeço antecipadamente pela sua resposta. Hany Danial

  17. Olá,

    Suponha que eu queira mudar a aparência do tema do WordPress, quais arquivos são importantes ou em qual arquivo preciso mudar o código?

    Nos últimos 2 anos, tenho pensado em mudar um pouco a aparência do meu tema, mas por não entender completamente, não consegui fazer isso.

    Obrigado,
    Amit

  18. Olá, obrigado por este post. Concordo com você que uma alternativa mais fácil ao FTP é o Gerenciador de Arquivos. É um aplicativo baseado na web que vem integrado ao painel cPanel da sua conta de hospedagem WordPress. Informação muito útil

  19. como faço para carregar as imagens para o site ou carregar o novo cupom para o site que usa Wordpress ou editar o conteúdo do site?

    quando eu faço login no site FTP, vejo estas 3 pastas
    wp-admin
    wp-content
    wp-includes

    obrigado
    john

  20. ótimo artigo. Mas tenho uma pergunta. Sou iniciante e estou tentando projetar um site via wordpress. já terminei o design até certo ponto. mas meu problema é que quando tento fazer upload do meu arquivo do wordpress via ftp (file zilla), não consigo encontrar o arquivo no meu C:/. como localizo meu arquivo do wordpress? obrigado enquanto aguardo sua resposta

  21. É muito útil para mim, pois estou começando com meu blog e tenho muito pouco conhecimento sobre essas questões técnicas. Ótimo conteúdo, obrigado.

  22. Ótimo artigo! Tenho uma pergunta, no entanto: Onde encontramos os artigos que escrevemos no site? Digamos que eu escreva um artigo no meu site. Este artigo é normalmente armazenado em arquivos do WordPress. Onde posso encontrá-lo?
    Obrigado

    • Seu artigo em si não será armazenado em arquivos, ele será armazenado no banco de dados. Apenas seus arquivos serão armazenados em wp-content/uploads.

      Ok? :)

  23. por favor, preciso da sua ajuda urgentemente, quero recomeçar do zero. Mas preciso apenas dos meus artigos e suas imagens. não preciso de mais nada. O motivo é que meu provedor de hospedagem diz que alguém está usando meu site para enviar spam para as pessoas usando um endereço comercial que eu nem adicionei ao meu webmail. se eu deletar, eles criam outro. mas agora outro problema é que malwares foram detectados no site. mas estou usando o tema newspaper, então não sei por que todos esses problemas. Posso fazer toda a instalação de um novo WordPress e tudo mais, mas preciso apenas colocar o conteúdo que tenho no novo site que vou criar. ainda tenho meu site antigo ativo e tenho o backup no diretório home do meu gerenciador de arquivos.

  24. Obrigado pelo artigo... e quanto a encontrar "páginas" no diretório? não consigo encontrá-las... elas serão acessíveis via cpanel ou apenas na interface do wp? vejo todos os arquivos de imagem que fiz upload na página [dir]uploads, organizados por mês/ano como você mencionou no diretório do cpanel, mas estava me perguntando onde posso encontrar o arquivo real das Páginas/páginas de conteúdo de texto? obrigado...

      • Então, não há como obter o conteúdo das páginas em si através do FTP? Tipo, se eu quisesse baixar minha página 'sobre' do FTP, eu não conseguiria?

        • Ou… este banco de dados está armazenado em outro lugar no site fora da pasta do wordpress, e tendo feito backup apenas da pasta do wordpress quando meu site foi excluído, eu perdi todo o meu conteúdo?

        • Não, você não poderá fazer isso.

          O WordPress não cria e armazena páginas estáticas. Em vez disso, ele armazena seu conteúdo em um banco de dados e, em seguida, gera páginas HTML dinamicamente.

        • “Não, você não poderá fazer isso.

          O WordPress não cria e armazena páginas estáticas. Em vez disso,
          ele armazena seu conteúdo em um banco de dados e, em seguida, gera
          páginas HTML dinamicamente.

          Após uma tela branca da morte (WSOD) e várias horas tentando voltar ao painel, eu deletei todos os arquivos do WP do meu gerenciador de arquivos. Antes de fazer isso, fiz backup e armazenei todos esses arquivos em um arquivo temporário no gerenciador de arquivos.

          Existe uma maneira de gerar minhas entradas (páginas estáticas) em HTML, para que eu possa copiá-las?

          Estou quase pronto para instalar outro tema do WP, mas antes de fazê-lo, tenho uma pequena esperança de que essas páginas ainda estejam armazenadas em algum lugar, como em um mundo etéreo de algum banco de dados.

        • Robert, apoio sua moção. A resposta tem sido habilmente contornada aqui. Existe algum tipo de taxa de associação que precisamos pagar por essas respostas aparentemente simples? Tudo o que consigo encontrar é a ferramenta de importação/exportação de páginas, depois editar o CSS ou excluir as páginas desnecessárias conforme desejado.

  25. Ótimo artigo. A equipe de desenvolvimento que trabalha com serviços de gerenciamento de conteúdo corporativo como o WordPress (ou, nesse caso, qualquer outro CMS como Sitefinity, Drupal, etc.) deve entender a estrutura básica de arquivos. Isso não só os ajudará a encontrar os arquivos, mas com isso eles também poderão organizar os arquivos da maneira correta.
    Usar uma abordagem aninhada para salvar seus arquivos de conteúdo e sistema é a melhor maneira de projetar uma estrutura de arquivos.

Deixar uma resposta

Obrigado por escolher deixar um comentário. Por favor, tenha em mente que todos os comentários são moderados de acordo com nossa política de comentários, e seu endereço de e-mail NÃO será publicado. Por favor, NÃO use palavras-chave no campo do nome. Vamos ter uma conversa pessoal e significativa.