Páginas Comparativas «A vs B» para PrestaShop 8 e 9: documentação

Apresentação

O módulo cria páginas públicas que comparam dois ou três produtos, por exemplo «iPhone 15 vs Galaxy S24», para se posicionar nas pesquisas de comparação. Cada página tem um URL limpo em cada idioma, as suas etiquetas SEO, dados estruturados, uma tabela comparativa, o seu veredicto e uma FAQ. Uma página de listagem reúne todos os comparativos publicados.

Não substitui um comparador de sessão como o Comparador de Produtos, em que o visitante compara a sua própria seleção: os dois módulos podem ser instalados em conjunto.

Instalação

1. Em Módulos > Gestor de módulos, clique em Carregar um módulo e selecione o ficheiro ZIP do módulo.
2. A instalação cria o separador Catálogo > Comparativos SEO, três tabelas (comparativos, traduções, associação de lojas) e o prefixo de URL predefinido de cada idioma instalado.
3. Verifique se os URL amigáveis estão ativos em Parâmetros da loja > Tráfego e SEO. Sem eles, as páginas funcionam, mas com endereços do tipo index.php?fc=module&module=dfversus&controller=compare&rewrite=....

Definições

O botão Configurar do módulo abre um painel de informação (ligação à gestão dos comparativos, endereço da página de listagem em cada idioma, endereço do sitemap) seguido de três blocos de definições.

URL e página de listagem

• Prefixo de URL, por idioma: os comparativos usam /prefixo/slug-da-pagina e a página de listagem /prefixo. Valores predefinidos: comparatif (fr), compare (en), comparativa (es), vergleich (de), confronto (it), porownanie (pl), vergelijking (nl), comparativo (pt). Os prefixos usados pelo PrestaShop (module, content, search, cart, order…) são recusados e substituídos pelo valor predefinido.
• Título da página de listagem (H1), meta título, meta descrição e introdução, por idioma.
• Comparativos por página: 24 por predefinição, de 1 a 100.

Apresentação

• Mostrar ligações nas páginas de produto: lista, sob a página de produto, os comparativos que incluem o produto (hook displayFooterProduct). Ligações nas páginas de produto define o seu número (6 por predefinição).
• Comparativos relacionados: número de comparativos que partilham um produto apresentados no fundo de cada página (6 por predefinição, 0 oculta o bloco).
• Comparar as características do produto: adiciona à tabela todas as características de Catálogo > Atributos e características.
• Mostrar as avaliações dos clientes: avaliação média e número de opiniões do módulo Comentários de produtos (productcomments), se estiver instalado.
• Mostrar apenas as diferenças por predefinição: o visitante pode sempre alterar a opção na página.
• Cor de destaque: usada no produto recomendado, nos selos, nas ligações e no melhor valor. Os tipos de letra são os do tema.

Dados estruturados

Adicionar a marcação JSON-LD está ativo por predefinição. Desative-o apenas se outro módulo já gerar esta marcação nestas páginas. As etiquetas Open Graph continuam a ser adicionadas.

Criar um comparativo

Em Catálogo > Comparativos SEO, clique em Adicionar um comparativo.

Produtos e produto recomendado

Pesquise cada produto por nome, referência, EAN ou ID e clique num resultado (ou use as setas e Enter). Os produtos 1 e 2 são obrigatórios, o produto 3 é opcional. Um produto inativo é assinalado por um selo. O campo Produto recomendado destaca uma coluna com o selo «A nossa escolha» e repete-a no veredicto. Se uma posição ficar vazia, os produtos são reordenados ao guardar.

Título, slug e etiquetas

• Título (H1): se ficar vazio, é gerado em cada idioma a partir dos nomes dos produtos, na forma «Produto 1 vs Produto 2».
• Slug de URL: se ficar vazio, é criado a partir do título. Deve ser único por idioma. Um slug gerado que já existe recebe o sufixo -2, -3. Um slug introduzido à mão que já está em uso é recusado.
• Meta título: se ficar vazio, é usado o título. O Google mostra cerca de 60 caracteres.
• Meta descrição: cerca de 155 caracteres. Se ficar vazia, é gerada uma descrição a partir dos nomes dos produtos.

A pré-visualização nos resultados de pesquisa mostra em tempo real o nome da loja, o URL real, o título e a descrição do idioma em edição, com um contador verde ou vermelho para cada comprimento.

Introdução e veredicto

A introdução aparece acima da tabela e o veredicto abaixo. São os dois textos que distinguem a sua página de uma ficha técnica: explique a quem se destina cada produto e o que realmente os separa.

Critérios editoriais

Um critério por linha, no formato Etiqueta | valor produto 1 | valor produto 2 | valor produto 3. Adicione * no fim de um valor para o assinalar como o melhor. Exemplo:

Autonomia real | 18 h* | 12 h | 15 h
Fotos noturnas | Muito boas | Excelentes* | Excelentes*
Peso na mão | Leve* | Médio | Pesado

Estes critérios formam o grupo «A nossa análise» da tabela.

Perguntas e respostas

Uma pergunta por linha, no formato Pergunta | Resposta. São apresentadas em acordeão no fundo da página e adicionadas ao JSON-LD como FAQPage.

Indexação e publicação

• Permitir a indexação: se desativado, a página continua acessível, mas tem a etiqueta noindex e fica fora dos sitemaps.
• Publicado: se desativado, a página devolve um erro 404 aos visitantes. Continua acessível através de uma ligação de pré-visualização assinada, apresentada no formulário e na ação Ver da lista.
• Associação de lojas: em multiloja, escolha as lojas onde o comparativo existe.

Depois de guardado, o formulário mostra os URL públicos do comparativo em cada idioma. O botão Guardar e continuar mantém o formulário aberto.

Comparativos duplicados

Um comparativo sobre exatamente os mesmos produtos que outro, em qualquer ordem, é recusado ao guardar, com o número do comparativo existente. Duas páginas sobre os mesmos produtos concorreriam no Google: edite antes a página existente.

Gerar a partir de uma categoria

O botão Gerar a partir de uma categoria cria um comparativo para cada par entre os melhores produtos de uma categoria.

1. Escolha a categoria.
2. Escolha como selecionar os produtos: mais vendidos, posição na categoria, mais recentes primeiro ou preço mais alto primeiro.
3. Indique o número de produtos, de 2 a 12: 6 produtos geram 15 comparativos, 12 produtos geram 66.
4. Deixe Publicar imediatamente desativado, como recomendado, e escolha se as páginas são indexáveis.

Só são considerados os produtos ativos e visíveis no catálogo da loja. Os títulos e slugs são criados em todos os idiomas e os pares já comparados são ignorados. As páginas geradas contêm apenas a tabela: adicione pelo menos uma introdução e um veredicto antes de as publicar, uma página sem conteúdo editorial raramente se posiciona.

Lista de comparativos

A lista mostra as miniaturas dos produtos (a cinzento para um produto inativo), o título, os nomes dos produtos, o estado de indexação e de publicação (alteráveis com um clique), o número de visitas e a data de atualização. As visitas excluem os robôs dos motores de pesquisa e as pré-visualizações.

• Ver abre a página pública, com a ligação de pré-visualização se não estiver publicada.
• Duplicar cria uma cópia não publicada com novos slugs e abre o seu formulário. Altere pelo menos um produto antes de guardar a cópia; caso contrário, é recusada como duplicado.
• As ações em massa publicam, despublicam ou eliminam a seleção.

A página pública

A página usa o modelo do seu tema (caminho de navegação, cabeçalho, rodapé) e contém, por esta ordem: a data de atualização, a introdução, o interruptor «Mostrar apenas as diferenças», a tabela, o veredicto, a FAQ, os comparativos relacionados e uma ligação para a página de listagem.

A tabela

No topo de cada coluna: imagem, nome, preço com preço riscado durante uma promoção, botão de adicionar ao carrinho (produtos simples, não personalizáveis e encomendáveis) e ligação para a página de produto. A tabela organiza-se depois em grupos, e as linhas vazias em todas as colunas são ocultadas:

• O essencial: preço (melhor preço assinalado), avaliação dos clientes, disponibilidade, marca, estado.
• A nossa análise: os seus critérios editoriais.
• Especificações técnicas: as características do produto, se a opção estiver ativa.
• Detalhes: peso, largura, altura, profundidade, referência, EAN-13.

No telemóvel

Abaixo de 768 px de largura, cada linha mostra a sua etiqueta acima dos valores: dois ou três produtos cabem na largura do ecrã, sem deslocamento horizontal.

Barra fixa

Quando o cabeçalho da tabela sai do ecrã, aparece no topo uma barra com o nome e o preço de cada produto. Posiciona-se automaticamente sob um cabeçalho fixo do tema. Se ficar mal posicionada com o seu tema, defina o deslocamento no CSS do tema:

:root { --dfv-sticky-top: 64px; }

Integração no tema

O bloco «Comparar este produto» aparece sob a página de produto através do hook displayFooterProduct. Para o colocar noutro local, desative a opção nas definições e adicione no modelo do seu tema:

{hook h='displayDfVersusLinks' product=$product}

Para adicionar a página de listagem ao menu, use o endereço indicado no painel de informação do módulo.

SEO

URL, canonical e redirecionamentos

A etiqueta canonical aponta para o URL do comparativo no idioma apresentado. Uma página acedida pelo slug de outro idioma, por um prefixo antigo ou pelo endereço direto do módulo é redirecionada com um 301 para o seu endereço canónico. Se alterar um prefixo ou um slug, os endereços antigos deixam de ser reconhecidos: preveja redirecionamentos se as páginas já estavam indexadas.

hreflang

As etiquetas hreflang ligam as versões linguísticas de um comparativo, com x-default no idioma predefinido da loja. Só são listados os idiomas em que o comparativo tem slug.

Dados estruturados

Cada comparativo contém um JSON-LD com WebPage (incluindo a data de modificação), BreadcrumbList, ItemList e FAQPage se houver perguntas. A ItemList segue o formato de «página de resumo»: cada elemento aponta para a página de produto, que já tem a sua própria marcação Product. A página de listagem contém CollectionPage e ItemList. Desde 2023, o Google só mostra os resultados enriquecidos de FAQ para alguns sites governamentais e de saúde: a marcação FAQPage continua válida, mas não produz um excerto enriquecido numa loja.

Sitemap

O sitemap próprio está disponível em /dfversus-sitemap.xml (endereço exato no painel de informação do módulo). Contém a página de listagem e cada comparativo publicado e indexável com os seus alternates hreflang. Submeta-o no Google Search Console. Se o módulo gsitemap do PrestaShop estiver instalado, os comparativos também são adicionados ao seu sitemap.

Eliminação de um produto

Quando um produto é eliminado do catálogo, é retirado da posição 3 dos comparativos que o usam. Um comparativo que perde o produto 1 ou 2 é despublicado. Um produto desativado deixa de ser apresentado nos comparativos, e um comparativo com menos de dois produtos visíveis deixa de aparecer na página de listagem e nos sitemaps.

Resolução de problemas

• As páginas devolvem um erro 404: verifique se o comparativo está publicado, associado à loja e contém pelo menos dois produtos ativos. Se os URL amigáveis foram ativados depois da instalação, regenere o ficheiro .htaccess em Tráfego e SEO.
• Um prefixo entra em conflito com outra página: escolha um prefixo mais específico nas definições, por exemplo «comparativos-produtos».
• As avaliações dos clientes não aparecem: o módulo productcomments tem de estar instalado e ativo, com as opiniões validadas. Verifique também a opção «Mostrar as avaliações dos clientes».
• O botão Adicionar ao carrinho não aparece: está reservado a produtos simples, não personalizáveis, encomendáveis, em stock ou por encomenda. Os outros produtos mostram a ligação para a página de produto.
• A barra fixa fica sob o cabeçalho do tema: defina a variável --dfv-sticky-top como indicado acima.