PS PrestaShop Iniciante

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.

Atualizado Versão do módulo 2.0.0

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

  1. Descarregue o ZIP na sua conta de cliente DataFirefly.
  2. No back office, vá a Módulos > Gestor de módulos > Carregar um módulo e envie o ZIP.
  3. 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.
  4. Se o módulo nativo Google sitemap (gsitemap) estiver ativo, desative-o e elimine os seus ficheiros *_sitemap.xml da raiz: o painel indica-o enquanto estiver ativo.
  5. 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.

Painel do sitemap: índice publicado, número de URL, imagens, vídeos e ficheiros, última e próxima geração
Painel do sitemap: índice publicado, número de URL, imagens, vídeos e ficheiros, última e 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.

Conteúdo listado por tipo e verificações de saúde: pastas, URL amigáveis, módulo gsitemap, robots.txt e tarefa agendada
Conteúdo listado por tipo e verificações de saúde: pastas, URL amigáveis, módulo gsitemap, robots.txt e 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.

Controlo de qualidade: ficheiros validados e 20 URL testados como um visitante (estado HTTP, noindex, URL canónico)
Controlo de qualidade: ficheiros validados e 20 URL testados como um visitante (estado HTTP, noindex, URL canónico)

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.

Ficheiros publicados: URL por ficheiro, tamanho e data real da última alteração do conteúdo
Ficheiros publicados: URL por ficheiro, tamanho e data real da última alteração do conteúdo

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.

Visualizador integrado: URL, imagens, vídeos, idiomas hreflang e data de alteração de um ficheiro de sitemap
Visualizador integrado: URL, imagens, vídeos, idiomas hreflang e data de alteração de um ficheiro de sitemap

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.
Definições de conteúdo: tipos de páginas, páginas estáticas, visibilidade dos produtos e exclusão de conteúdo reservado
Definições de conteúdo: tipos de páginas, páginas estáticas, visibilidade dos produtos e exclusão de conteúdo reservado

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.
Idiomas e hreflang: códigos idioma-região, anotações recíprocas e idioma x-default
Idiomas e hreflang: códigos idioma-região, anotações recíprocas e idioma x-default

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.
Etiquetas e ficheiros: lastmod real, visualização XSLT, compressão gzip e divisão dos ficheiros
Etiquetas e ficheiros: lastmod real, visualização XSLT, compressão gzip e divisão dos ficheiros

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.

Regras de exclusão: por texto do URL, por ID, produtos sem imagem, por loja
Regras de exclusão: por texto do URL, por ID, produtos sem imagem, por loja
  • 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.
Criação de uma regra de exclusão: URL que contém um texto, um valor por linha, todas as lojas
Criação de uma regra de exclusão: URL que contém um texto, um valor por linha, todas as lojas

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.

Vídeos de produto adicionados ao sitemap de vídeos, com miniatura, título e duração
Vídeos de produto adicionados ao sitemap de vídeos, com miniatura, título e duração
Ficha de um vídeo: produto, título e descrição por idioma, miniatura, URL do leitor e duração
Ficha de um vídeo: produto, título e descrição por idioma, miniatura, URL do leitor e duração

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.

Automatização: URL cron protegido por token, comando CLI, motores de pesquisa e IndexNow
Automatização: URL cron protegido por token, comando CLI, motores de pesquisa e IndexNow

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.

robots.txt: pré-visualização do bloco dfsitemap, adicionado ou removido apenas a pedido
robots.txt: pré-visualização do bloco dfsitemap, adicionado ou removido apenas a pedido

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.

Esta página foi útil?

Ainda com dúvidas? Contacte o suporte