Kowal Google Sitemap

MAGENTO 2 · MAPAS XML · STORE VIEW · HREFLANG

Kowal Google Sitemap

Crie perfis de sitemap para Store Views e escolha as fontes dos endereços: catálogo, CMS e conteúdos Kowal suportados. Controle exclusões, relações linguísticas e a geração através do painel, do cron ou da CLI.

Perfis de Store View · Histórico de geração · Integrações opcionais

COMO FUNCIONA NA PRÁTICA

Kowal Sitemap expande o mapa do site com produtos, categorias, CMS e, através de adaptadores opcionais, Blog, TrustedUs e Layered Navigation. Crie perfis para Store View, controle fontes e exclusões, suporte hreflang e automatize a geração.

Produtos, categorias, páginas CMS ativas e endereços próprios. Os adaptadores adicionam artigos de blog, realizações e páginas configuradas de navegação em camadas.

Mapas separados para versões linguísticas, x-default e relações explícitas entre traduções de páginas CMS.

O novo mapa só substitui o anterior após uma geração correta. Mapas grandes são divididos e unidos por um índice.

• controlo de fontes, exclusões e URL adicionais,
• deduplicação de endereços,
• cron, painel administrativo e CLI,
• modo de teste e histórico de execuções,
• atualização opcional do robots.txt dinâmico,
• suporte para imagens de produtos, artigos e categorias,
• gravação XML em streaming para limitar o consumo de memória.

Instalação: Composer. Escolha os adaptadores de integração de acordo com as necessidades da loja.

Abra kowal.store → Modules → Sitemap → Maps and Configuration. Crie um perfil para a Store View, escolha o nome do índice e as fontes de URL. O formulário separa as definições gerais, fontes, exclusões e alternativas linguísticas.

Generate adiciona uma tarefa à fila processada pelo Magento cron a cada 5 minutos. O agendamento do perfil define o intervalo de geração; a sua desativação não bloqueia a geração manual. O histórico mostra relatórios e erros das execuções.

O núcleo suporta produtos, categorias, páginas CMS ativas e URL adicionais. Para as fontes, define, entre outros, imagens, lastmod e hreflang. As imagens incluem a imagem principal do produto ou do artigo, bem como a imagem da categoria.

Pode adicionar endereços próprios no painel; JSON/CLI permite também indicar metadados adicionais. A lista de exclusões aceita URL completos ou caminhos com o carácter opcional *. É possível excluir categorias indicadas juntamente com a respetiva subárvore.

O pacote Composer atual inclui os módulos opcionais Kowal_SitemapBlog, Kowal_SitemapTrustedUs e Kowal_SitemapLayeredNavigation. Cada integração requer o módulo de origem adequado e a ativação do adaptador.

O Blog fornece artigos, categorias e tags elegíveis; o TrustedUs — grupos ativos de realizações ou empresas. O Layered Navigation adiciona páginas Shop By e contextos especiais, sem gerar todas as combinações de filtros. A adapter suite requer PHP 8.3+.

Ligue os perfis linguísticos através de um hreflang_group comum, diferentes Store Views e códigos language únicos. Opcionalmente, um perfil pode ter x-default. Páginas em falta ou excluídas não são substituídas pela página inicial.

As páginas CMS requerem mapeamento explícito, por exemplo, dois identificadores CMS diferentes recebem uma chave comum about-us. Após alterar traduções, gere todos os perfis do grupo para que as relações correspondam ao mesmo estado do conteúdo.

bin/magento kowal:sitemap:generate --id=1 --dry-run --format=json recolhe e qualifica endereços, além de verificar entradas XML e relações, sem publicar mapas. Substitua o ID de exemplo pelo identificador do seu perfil.

Os comandos save, generate, validate e status permitem guardar a configuração, iniciar a geração e verificar o relatório. O modo de teste facilita a avaliação das exclusões antes da primeira publicação.

O gerador grava XML em streaming, e um conjunto SQLite temporário em disco serve para qualificar e deduplicar endereços. Mapas grandes são divididos em partes ligadas por um índice estável.

O XML é validado antes da comutação do índice. Uma nova geração só substitui a anterior após uma preparação correta; as partes antigas permanecem durante o período de retenção e são limpas apenas com base no histórico próprio do módulo.

Os ficheiros são publicados em pub/. A primeira geração não substitui o ficheiro de outro gerador — escolha um nome livre. Depois de validar o novo mapa, altere a indicação do sitemap e o agendamento do gerador anterior.

A opção robots aplica-se ao robots.txt dinâmico do Magento. Um ficheiro estático ou CDN requer atualização no processo de implementação. O object storage remoto precisa de um adaptador de publicação separado.

Publique endereços que devem representar as páginas corretas da loja e verifique a sua disponibilidade, bem como a política canonical/noindex. O módulo rejeita, entre outros, endereços com parâmetros, fragmentos e domínio externo; não substitui a avaliação da configuração de outras extensões SEO.

O mapa ajuda a disponibilizar URL ao motor de pesquisa, mas a sua submissão não garante utilização nem indexação. O Google ignora priority e changefreq e requer um lastmod fiável. Regras de sitemap — Google Search Central.

O âmbito básico requer Magento Open Source 2.4.6+, PHP 8.1+ numa versão suportada pelo Magento, extensões XMLReader, XMLWriter, PDO e PDO_SQLite, bem como Kowal Base. Os perfis são armazenados na base de dados Magento, e o SQLite é usado temporariamente durante a geração.

Escolha as fontes de acordo com os módulos instalados. Antes de iniciar o agendamento, verifique o relatório de teste, o índice público e as partes XML, os endereços das Store Views e as relações linguísticas.

Pacote kowal/module-sitemap, módulo Kowal_Sitemap. Depois de configurar o acesso ao repositório Kowal, instale o pacote, ative o módulo, atualize o Magento e limpe a cache. Em produção, inclua a compilação e a implementação de conteúdos estáticos de acordo com o processo da loja.

1. Cria um perfil de mapa
Escolhe a Store View, o nome do ficheiro, as fontes e as exclusões.

2. Verifica e gera o XML
Utiliza o modo de teste, a fila ou a CLI.

3. Disponibiliza o índice correto
Verifica os ficheiros e configura a sua indicação para o motor de pesquisa.

Cria dois perfis com ficheiros e códigos de idioma separados, atribuídos a um único grupo hreflang. Relaciona as páginas CMS equivalentes através de chaves comuns e, após alterar as traduções, atualiza ambos os mapas.