# Editor robots.txt: guia de instalação e utilização
> Guia completo do módulo Editor robots.txt: instalação, edição, validação, regeneração, modelos de bloqueio dos robôs de IA e restauro de cópia de segurança.
- Página:
- Idioma: pt
- Atualizado em: 2026-09-02
- Outros idiomas: [fr](https://www.datafirefly.com/documentation/editeur-robots-txt/index.md), [en](https://www.datafirefly.com/en/documentation/robots-txt-editor/index.md), [es](https://www.datafirefly.com/es/documentation/editor-robots-txt/index.md), [de](https://www.datafirefly.com/de/documentation/robots-txt-editor-anleitung/index.md), [it](https://www.datafirefly.com/it/documentation/guida-editor-robots-txt/index.md), [pl](https://www.datafirefly.com/pl/documentation/edytor-robots-txt-prestashop/index.md), [nl](https://www.datafirefly.com/nl/documentation/editeur-robots-txt/index.md)
- Índice:
O **Editor robots.txt** da DataFirefly permite-lhe modificar, validar, regenerar e guardar o ficheiro `robots.txt` da sua loja diretamente a partir do back-office PrestaShop, sem acesso FTP nem SSH. Este guia cobre a instalação e o conjunto das funcionalidades.
## Compatibilidade
- PrestaShop 8.0 a 9.x
- PHP 7.4 a 8.x
- Multiloja
- Interface em francês e inglês (traduzível em Internacional → Traduções)
## Instalação
1. Descarregue o arquivo `dfrobotseditor.zip`.
2. No back-office, abra **Módulos → Gestor de módulos**.
3. Clique em **Instalar um módulo** e carregue o ZIP (ou copie a pasta `dfrobotseditor` para `/modules/` e instale-a a partir da lista).
4. Depois de instalado, clique em **Configurar**: o editor abre diretamente.
Na instalação, nenhum ficheiro `robots.txt` é modificado. O módulo limita-se a abrir um editor; cada gravação fica sob o seu controlo.
## Aceder ao editor
Dois acessos possíveis:
- Através do botão **Configurar** do módulo (recomendado).
- Através do menu **Módulos → Editor robots.txt** no back-office.
O ecrã principal mostra o caminho do ficheiro, o seu estado de escrita, uma ligação « Ver online » e, se for o caso, a data da última cópia de segurança.
## Modificar e guardar
O conteúdo do ficheiro aparece num editor monoespaçado. Modifique-o livremente e clique em **Guardar**. A cada gravação:
- a versão anterior é automaticamente guardada em cópia de segurança;
- os fins de linha são normalizados;
- o conteúdo é limitado a 64 KB.
## Regenerar o ficheiro por defeito
O botão **Regenerar (por defeito)** reconstrói um `robots.txt` padrão. O módulo usa as regras nativas do PrestaShop quando estão disponíveis, caso contrário um modelo DataFirefly equivalente. A versão atual é guardada em cópia de segurança antes da substituição.
A regeneração escreve imediatamente o ficheiro. É criada previamente uma cópia de segurança: pode voltar atrás através de **Restaurar a cópia de segurança**.
## Validar a sintaxe
O botão **Validar a sintaxe** analisa o conteúdo do editor e lista as anomalias, classificadas por gravidade:
- **Erro**: Sitemap não absoluto, regra colocada antes de qualquer `User-agent`, linha malformada.
- **Aviso**: diretiva desconhecida, presença de um BOM, diretiva `Noindex` obsoleta, `Crawl-delay` não numérico.
- **Info**: ficheiro vazio (todos os robôs são autorizados).
A validação não modifica o ficheiro: ajuda-o a corrigir antes de guardar.
## Modelos rápidos
O menu **Inserir um modelo** adiciona conteúdo pronto a usar no local do cursor:
- **Linha Sitemap**: insere o URL absoluto do seu sitemap.
- **Bloquear os robôs de IA**: insere um bloco que bloqueia GPTBot, ClaudeBot, CCBot, Google-Extended, PerplexityBot, Bytespider e outros.
- **Autorizar tudo** / **Bloquear tudo**.
Exemplo de bloco de bloqueio dos robôs de IA:
```
# Bloqueio dos robôs de IA, DataFirefly
User-agent: GPTBot
Disallow: /
User-agent: ClaudeBot
Disallow: /
User-agent: CCBot
Disallow: /
```
O Google-Extended diz respeito ao treino das IA da Google, não à indexação na Pesquisa Google. Ajuste a lista segundo a sua estratégia de SEO e de AEO.
## Restaurar uma cópia de segurança
Cada gravação ou regeneração cria uma cópia de segurança da versão anterior, guardada na base de dados (logo **nunca acessível publicamente**). O botão **Restaurar a cópia de segurança** reescreve instantaneamente essa versão no ficheiro.
## Permissões e resolução de problemas
O ficheiro `robots.txt` deve ter permissão de escrita para o servidor web. Se não for o caso, o módulo mostra um aviso e desativa a gravação.
```
chmod 644 /caminho/para/robots.txt
# se o ficheiro ainda não existir:
chmod 755 /caminho/para/raiz/
```
- **« Só de leitura »**: aplique as permissões acima, ou ajuste o proprietário do ficheiro (utilizador do servidor web).
- **O ficheiro não aparece online**: verifique que nenhuma regra de servidor ou de CDN serve um `robots.txt` estático diferente.
## Multiloja
O `robots.txt` é um ficheiro único servido na raiz de cada domínio. Em multiloja com um só domínio, basta um ficheiro. Em multidomínios, agrupe as secções por domínio nesse mesmo ficheiro.
## Desinstalação
A desinstalação do módulo elimina o seu separador e a sua cópia de segurança na base de dados. **O seu ficheiro robots.txt não é modificado**: fica tal como o guardou.