Documentação do módulo Sitemap XML avançado para PrestaShop (dfsitemap)
Instalar e configurar o dfsitemap 2.0.0: painel, controlo de qualidade, conteúdo, hreflang, imagens e vídeos, regras de exclusão, cron, robots.txt, IndexNow e multiloja.
O módulo Sitemap XML avançado (dfsitemap) gera os sitemaps XML do PrestaShop 1.7.8, 8 e 9: um índice por loja, um ficheiro por idioma e por tipo de conteúdo, com imagens, vídeos e etiquetas hreflang recíprocas. A versão 2.0.0 traz um novo back office, um controlo de qualidade, um visualizador integrado e compressão gzip. Esta página cobre a instalação, as definições, as regras de exclusão, o agendamento e a resolução de problemas.
Instalação
- Descarregue o ZIP na sua conta de cliente DataFirefly.
- No back office, vá a Módulos > Gestor de módulos > Carregar um módulo e envie o ZIP.
- Abra Parâmetros da loja > Tráfego e SEO > Sitemap XML avançado. A barra do módulo dá acesso ao painel, às definições, à automatização, às regras de exclusão e aos vídeos de produto.
- Se o módulo nativo Google sitemap (gsitemap) estiver ativo, desative-o e elimine os seus ficheiros
*_sitemap.xmlda raiz: o painel indica-o enquanto estiver ativo. - Clique em Gerar agora e submeta o URL do índice no Google Search Console e no Bing Webmaster Tools.
O mesmo ZIP funciona do PrestaShop 1.7.8 ao 9.x, em multiloja e multilingue. O módulo escreve os seus ficheiros dfsitemap-*.xml na raiz da loja e os ficheiros temporários em modules/dfsitemap/var/tmp/.
Atualização a partir da 1.1.0
Carregue o ZIP 2.0.0 como numa instalação: o PrestaShop executa a atualização. As definições, as regras, os vídeos, a fila IndexNow e os sitemaps publicados são mantidos. Se a 1.1.0 tinha escrito o seu bloco no robots.txt, a opção que o mantém atualizado fica ativa; caso contrário, fica desativada.
Painel
Para cada loja do contexto, o painel mostra o estado dos sitemaps (online, regeneração em atraso, última geração com erro, nunca gerado), o URL do índice com os botões Copiar, Explorar e XML em bruto, o número de URL, imagens, vídeos e ficheiros, e as datas da última e da próxima geração.

Mais abaixo, o conteúdo listado por tipo e o cartão Saúde verificam as pastas com permissão de escrita, os URL amigáveis, a presença do gsitemap ou de um sitemap.xml físico, o modo de manutenção, a declaração no robots.txt e a última chamada da tarefa agendada.

Controlo de qualidade
O botão Executar o controlo lê em fluxo cada ficheiro publicado: elemento raiz, espaços de nomes, limites de 50 000 URL e 50 MB, URL absolutos, codificados e no domínio da loja. Depois abre 20 URL aleatórios como um visitante sem sessão: estado HTTP sem seguir redirecionamentos, cabeçalho X-Robots-Tag, meta robots e URL canónico. Os pedidos só vão para os domínios da loja.

Um URL «a rever» resulta normalmente de um redirecionamento adicionado por outro módulo ou de uma página reservada a um grupo de clientes. Exclua-o com uma regra se não dever ser indexado.
Os ficheiros
Para cada loja, o módulo publica um índice dfsitemap-{id loja}-index.xml que aponta para ficheiros nomeados por idioma e tipo, por exemplo dfsitemap-1-pt-product-1.xml. Quando um ficheiro atinge o número de URL definido, ou antes de 45 MB, o resto passa para -2, -3, etc. Com a compressão gzip, os ficheiros são publicados em .xml.gz e o índice fica sem compressão.
O lastmod de cada ficheiro no índice é a data da última alteração do seu conteúdo: um ficheiro idêntico à geração anterior mantém a sua data.

O botão Explorar abre um visualizador no back office: URL, número de imagens e vídeos, idiomas hreflang e data de alteração, 100 por página, com um filtro. Substitui a visualização XSLT que o Chrome está a retirar.

Com os URL amigáveis ativos, o índice também é servido em /sitemap.xml no domínio de cada loja. Os ficheiros são criados numa pasta temporária e publicados loja a loja: os sitemaps anteriores ficam online durante a geração.
Definições
As definições seguem o contexto multiloja: no contexto de uma loja, os valores guardados só se aplicam a essa loja. Um indicador assinala as alterações por guardar.
Conteúdo
- Tipos de conteúdo: páginas estáticas, produtos, categorias, páginas CMS, categorias CMS, marcas, fornecedores, URL personalizados. Só é listado o conteúdo ativo.
- Páginas estáticas: página inicial, mais vendidos, novidades, promoções, listas de marcas e fornecedores, lojas, contacto, mapa do site. Uma página desativada nas preferências da loja (marcas, fornecedores, mais vendidos) é ignorada.
- Produtos visíveis apenas na pesquisa: por predefinição só são listados os produtos com visibilidade Em todo o lado ou Apenas catálogo.
- Excluir o conteúdo reservado a grupos de clientes (ativo por predefinição): os produtos e categorias que um visitante sem sessão não consegue abrir, e que responderiam 403, não são listados.

Uma página CMS com a opção Indexação pelos motores de pesquisa desativada é servida com noindex. O módulo não a lista e mostra quantas páginas estão nessa situação.
Idiomas e hreflang
- Idiomas: deixe tudo marcado para seguir os idiomas ativos de cada loja. O código hreflang de cada idioma é apresentado.
- Alternativas hreflang: cada URL lista todas as suas traduções, incluindo ele próprio, para que as anotações sejam recíprocas.
- Código hreflang: idioma e região (
pt-PT, a partir do código de idioma de Internacional > Idiomas) ou apenas idioma (pt). Dois idiomas que partilhariam um código mantêm a sua região. - Idioma x-default: idioma predefinido da loja, um idioma específico ou nenhum.

Imagens e vídeos
- Sitemap de imagens e todas as imagens do produto (caso contrário, só a capa), no tamanho de imagem escolhido.
- Imagens de categorias, marcas e fornecedores.
- Sitemap de vídeos e deteção de YouTube e Vimeo nas descrições de produto e nas páginas CMS. No Vimeo, o título e a miniatura são lidos uma vez a partir do serviço público oEmbed do Vimeo e guardados em cache.
Etiquetas e ficheiros
- lastmod: data real da última atualização de produtos, categorias, categorias CMS, marcas e fornecedores. As páginas sem data fiável não têm lastmod.
- changefreq e priority: desativadas por predefinição, a Google ignora-as.
- Visualização legível no navegador (XSLT): folha de estilos no idioma de cada ficheiro. Desativada por predefinição nas novas instalações porque o Chrome está a retirar o XSLT; use o visualizador do back office.
- Comprimir os sitemaps (gzip) e URL por ficheiro: 10 000 por predefinição, entre 100 e 50 000, com divisão antes de 45 MB.

URL adicionais
- URL personalizados: um por linha; um caminho relativo como
/blog/é acrescentado ao URL da loja. Só são mantidos os URL do domínio da loja, como exige o protocolo. - Sitemaps adicionais: URL absolutos de sitemaps gerados noutro local, adicionados ao índice. Um sitemap de outro domínio só é lido se ambos os sites estiverem verificados na mesma conta do Search Console.
Geração
- Frequência: de hora a hora a uma vez por semana, usada pelo cron.
- Elementos por lote (50 por predefinição) e limite de tempo por pedido (20 segundos, limitado a 15 segundos a partir do back office).
- Regenerar quando o conteúdo muda: depois de guardar um produto, uma categoria, uma página CMS, uma marca ou um fornecedor, a chamada cron seguinte regenera sem esperar pela frequência, no máximo uma vez por hora.
Regras de exclusão
O conteúdo inativo, os produtos ocultos do catálogo e as páginas reservadas a alguns grupos de clientes nunca são listados. As regras removem conteúdo online que não deve ser indexado. Cada regra aplica-se a todas as lojas ou a uma, a partir da geração seguinte.

- Produtos: por ID, numa categoria (subcategorias incluídas), de uma marca, de um fornecedor predefinido, sem stock, com preço zero, sem imagem.
- Categorias: por ID, ou uma categoria e todas as suas subcategorias.
- Páginas CMS: por ID, ou uma categoria CMS com as suas páginas. Marcas e fornecedores: por ID.
- O URL contém um texto e o URL corresponde a uma expressão regular: um valor por linha, sem distinguir maiúsculas. Uma expressão inválida é recusada ao guardar.

Um URL excluído por uma regra também desaparece das alternativas hreflang das suas traduções.
Vídeos de produto
O separador Vídeos de produto serve para vídeos alojados fora do YouTube e do Vimeo, ou quando quer um título e uma descrição específicos. Para cada vídeo: o produto (pesquisa por nome, referência ou ID), o título e a descrição por idioma, o URL da miniatura, o URL do ficheiro de vídeo ou do leitor, a duração em segundos e a loja.


Iniciar a geração
A partir do back office
Gerar agora inicia a geração para as lojas do contexto, com uma barra de progresso. Se fechar a página, a tarefa fica guardada: Retomar nesta janela continua-a, ou o cron trata disso. Cancelar para a tarefa e deixa os sitemaps online inalterados.
Com o cron
O separador Automatização mostra um URL do tipo https://a-sua-loja.pt/module/dfsitemap/cron?token=..., protegido por um token secreto. Chame-o a cada 5 minutos a partir do gestor cron do seu alojamento. Cada chamada trabalha durante o limite de tempo e a seguinte retoma. Parâmetros opcionais: force=1 e id_shop=1,2. O cartão mostra a última chamada recebida (HTTP ou CLI); Gerar um novo token invalida o URL antigo.

Na linha de comandos
php /caminho/para/prestashop/modules/dfsitemap/cron.php
php /caminho/para/prestashop/modules/dfsitemap/cron.php --force --shop=1
O script processa toda a tarefa de uma só vez. Recusa chamadas web e devolve o código de saída 1 em caso de erro.
Se um pedido for interrompido a meio da geração, a tarefa retoma na última posição guardada e os ficheiros em curso são reparados. O bloqueio do pedido interrompido expira após o limite de tempo mais 90 segundos.
robots.txt
O módulo nunca altera o robots.txt por si só. O cartão robots.txt do separador Automatização mostra as linhas que adicionaria, entre # BEGIN dfsitemap e # END dfsitemap, e permite adicionar, atualizar ou remover esse bloco. O resto do ficheiro é mantido tal como está e uma cópia da versão anterior é guardada em modules/dfsitemap/var/. A opção Manter as linhas Sitemap quando o PrestaShop regenera o robots.txt (desativada por predefinição) reescreve o bloco sempre que o ficheiro é gerado em Tráfego e SEO. A desinstalação remove apenas este bloco.

Motores de pesquisa e IndexNow
A Google (desde 2023) e o Bing (desde 2022) já não aceitam o ping anónimo de sitemaps: o módulo não envia nenhum. Declare o índice uma vez no Google Search Console, no Bing Webmaster Tools ou com uma linha Sitemap: no robots.txt. Um sitemap ajuda os motores de pesquisa a descobrir URL, não garante a indexação.
O IndexNow, desativado por predefinição, notifica o Bing e os outros motores do protocolo das páginas criadas ou alteradas. A Google não o usa. Depois de ativado, o módulo cria um ficheiro de chave na raiz, coloca em fila cada produto, categoria, página CMS, marca ou fornecedor guardado e envia os seus URL na chamada cron seguinte, apenas para o conteúdo listado no sitemap. O cartão IndexNow mostra a fila, o ficheiro de chave e o último envio; perante uma resposta 429 ou 5xx, a fila é mantida.
Multiloja
Cada loja tem o seu índice no seu próprio domínio, os seus idiomas e as suas definições. Selecione uma loja no menu multiloja para lhe dar valores próprios. No contexto Todas as lojas, o painel mostra um cartão por loja.
Para programadores: adicionar URL
Um módulo pode adicionar as suas páginas ligando-se ao hook actionDfSitemapUrls. O hook recebe id_shop, languages (id_lang => código ISO) e link, e devolve uma lista de entradas:
public function hookActionDfSitemapUrls($params)
{
$loc = [];
foreach ($params['languages'] as $idLang => $iso) {
$loc[$idLang] = $params['link']->getBaseLink($params['id_shop']) . $iso . '/blog/o-meu-artigo';
}
return [
['loc' => $loc, 'lastmod' => '2026-09-01 10:00:00', 'images' => ['https://.../imagem.jpg']],
];
}
Uma entrada indexada por idioma recebe as etiquetas hreflang como uma página nativa. Os URL de outro domínio e as entradas inválidas são ignorados.
Perguntas frequentes
O controlo de qualidade assinala um redirecionamento
Outro módulo redireciona esta página (por exemplo, para uma página de configuração). Liste o URL final ou exclua este com uma regra O URL contém um texto.
Falta um produto
Verifique se está ativo, com visibilidade Em todo o lado ou Catálogo, e numa categoria aberta aos visitantes sem sessão. Verifique também as regras de exclusão.
O sitemap não contém nenhuma página CMS
Ative a opção Indexação pelos motores de pesquisa nas páginas que devem ser indexadas.
A geração fica em «Outro processo está a trabalhar na tarefa»
Outro pedido tem o bloqueio, muitas vezes o cron. Se foi interrompido, o bloqueio expira após o prazo indicado e a geração retoma sozinha.
O IndexNow responde 403 ou 422
O motor não encontra o ficheiro de chave ou recusa o anfitrião. Abra o URL do ficheiro de chave apresentado no cartão IndexNow: deve mostrar a chave.