Tudo o que quer saber antes de instalar.
Uma análise detalhada de como o DataFirefly Glossário SEO: Léxico de termos técnicos, balões automáticos nas suas descrições e ligação interna para os seus produtos, para PrestaShop 8 e 9 funciona, porque o construímos assim e o raciocínio por trás das funcionalidades acima.
Porque é que um glossário é uma das melhores relações entre esforço e resultado no SEO de comércio eletrónico
Um catálogo de comércio eletrónico capta pesquisas transacionais: mochila em tela plastificada, casaco ripstop de homem. É a parte visível e disputada do mercado. Mas a montante existe um volume considerável de pesquisas informacionais que as suas fichas de produto não conseguem captar por natureza: o que é a tela plastificada, diferença entre ripstop e cordura, o que significa o denier de um tecido. Essas pesquisas são mais fáceis de posicionar (a concorrência comercial é baixa), trazem tráfego em fase de descoberta e, sobretudo, podem ser encaminhadas para o seu catálogo através de uma ligação contextual bem colocada. O glossário é precisamente a ferramenta que as capta. Cada termo técnico torna-se uma página dedicada, rápida de produzir, tematicamente coerente com o seu catálogo e naturalmente ligada aos seus produtos. Ao contrário de um blogue, não há redação editorial contínua para manter: escreve o termo uma vez e ele trabalha por si indefinidamente.
O duplo benefício: conversão e posicionamento
A maioria dos comerciantes que instala um glossário fá-lo pelo SEO, e descobre um benefício de conversão que não esperava. Um visitante que lê uma ficha de produto e tropeça num termo técnico tem três opções: adivinhar (mau para a confiança), abrir um novo separador no Google (mau para si, porque sai do seu site) ou desistir. O balão resolve o problema sem nunca fazer sair o visitante da ficha: passa o rato, lê a definição numa frase e continua a leitura. A taxa de rejeição desce, o tempo passado sobe, e estes dois sinais de comportamento alimentam por sua vez o posicionamento da própria ficha de produto. O módulo deixa-lhe a decisão: no modo ligação e balão (predefinição), tem os dois benefícios; no modo apenas balão, privilegia a pedagogia sem acrescentar ligações de saída às suas fichas; no modo apenas ligação, privilegia a ligação interna pura.
Como funciona o motor de injeção, e porque nunca parte o seu HTML
É o ponto técnico mais sensível de um módulo deste tipo, e aquele em que a maioria das soluções do mercado falha. Um módulo de glossário ingénuo faz uma simples substituição de texto no HTML da descrição. Resultado: cola ligações dentro de etiquetas existentes, parte atributos, transforma uma palavra que está dentro de um URL numa ligação aninhada, ou volta a ligar o texto de uma ligação que ele próprio acabou de criar. O DataFirefly Glossário SEO procede de outra forma. O conteúdo é primeiro dividido em segmentos de etiqueta e segmentos de texto. Só os segmentos de texto são candidatos à substituição, e o motor mantém um contador de profundidade para cada zona proibida: assim que entra numa etiqueta a, script, style, code, pre, svg, textarea, select, option, button, iframe ou noscript, ou num título h1, h2 ou h3, todos os segmentos de texto até ao fecho correspondente ficam intactos. Nos segmentos permitidos, a pesquisa usa uma expressão regular Unicode com fronteiras de palavra reais, que exclui letras, algarismos, traços inferiores e hífenes de ambos os lados do termo, sendo por isso impossível transformar a palavra cordura dentro da palavra corduras, ou apanhar um fragmento no meio de um identificador. Por fim, cada ligação injetada é temporariamente substituída por um marcador único durante o tratamento e reposta no fim: isso garante que um termo nunca poderá voltar a ser ligado dentro de uma ligação colocada pelo próprio módulo.
Sinónimos: o detalhe que multiplica a cobertura por três
Um mesmo conceito raramente se exprime de uma só forma num catálogo escrito ao longo de vários anos por várias pessoas. Tela plastificada, tela plastificada em PVC, tecido plastificado e plastificação em PVC designam a mesma coisa. Um módulo que só corresponde ao nome exato do termo falha a maioria das ocorrências reais. Por isso, cada termo do glossário aceita uma lista de sinónimos separados por vírgulas, totalmente livre e traduzível idioma a idioma. Todas as variantes (nome principal e sinónimos) são fundidas e depois ordenadas por comprimento decrescente antes da correspondência: a expressão mais longa e mais discriminante ganha sempre, o que evita que uma variante curta apanhe o fragmento de uma variante mais longa. Na prática, se tela plastificada em PVC e tela plastificada estiverem ambas na lista, é a primeira que será ligada quando aparecer por inteiro. A correspondência é insensível a maiúsculas e minúsculas e tolerante a espaços múltiplos ou mudanças de linha, pelo que as expressões cortadas por uma quebra de linha no HTML são reconhecidas normalmente.
As proteções contra a sobreotimização, ativadas por predefinição
Uma ligação interna excessiva é contraproducente: o Google identifica há muito os padrões de sobreotimização de âncoras, e uma ficha de produto cheia de vinte ligações internas para definições dilui o PageRank interno em vez de o concentrar. Por isso, o módulo parte de definições propositadamente conservadoras. O limite de ocorrências por termo está fixado em 1 por predefinição: mesmo que a palavra ripstop apareça oito vezes numa descrição, só a primeira ocorrência se torna ligação e as outras sete ficam em texto simples. O limite global por conteúdo está fixado em 10: para além disso, o motor pára, sejam quais forem os termos que restem. Os dois valores são configuráveis se a sua estratégia for outra, mas recomendamos manter o limite por termo em 1, porque uma única ligação por noção basta largamente para transmitir o sinal semântico e a segunda nada acrescenta ao motor. Cada termo dispõe ainda de um interruptor de ligação automática individual: um termo pode existir no glossário, ter a sua página de definição indexada e nunca ser injetado automaticamente nos conteúdos.
Os dados estruturados: DefinedTerm e DefinedTermSet
O vocabulário Schema.org define dois tipos dedicados ao glossário, ainda muito pouco aproveitados no comércio eletrónico. Cada página de termo emite um JSON-LD do tipo DefinedTerm com o seu nome, a sua descrição, o seu URL e a sua ligação a um conjunto. A página de índice emite um DefinedTermSet que refere todos os termos ativos. Na prática, isso dá ao Google e aos motores de resposta um sinal explícito e sem ambiguidade: esta página define um termo preciso e pertence a um glossário estruturado sobre esse domínio. É uma das raras marcações que indica ao motor não só do que fala a página, mas que função ocupa na arquitetura do site. Na era das respostas generativas (AI Overviews, ChatGPT e Perplexity), os conteúdos definicionais bem marcados estão sobre-representados nas citações, e um glossário bem feito é hoje um dos formatos de conteúdo mais citados pelos motores de resposta.
Multilingue e multiloja, pensados desde o início
Todos os campos de texto do glossário são multilingues: o nome do termo, os sinónimos, as duas definições, o slug, o meta title e a meta description podem ser diferentes em cada idioma da sua loja. É indispensável, porque os sinónimos de um termo não têm razão para ser os mesmos em português e em alemão, e o slug do URL deve estar no idioma do visitante. A correspondência é sempre feita no idioma do contexto atual: uma descrição portuguesa nunca será enriquecida com termos ingleses, nem o contrário. No multiloja, os termos estão associados às lojas através da tabela de associação padrão do PrestaShop: pode ter um glossário técnico denso na sua loja B2B e um glossário reduzido e simplificado na sua loja B2C, na mesma instalação.
Zero IA, zero API, zero custos recorrentes
Este módulo não faz qualquer chamada de rede. Não há chave de API para fornecer, fornecedor externo para escolher nem consumo para vigiar. Todo o tratamento é feito em PHP, do lado do servidor, a partir dos seus próprios dados. É uma escolha assumida: a ligação por glossário é um problema determinístico e não um problema de inferência. Você conhece os seus termos técnicos melhor do que qualquer modelo, e a substituição de um texto dentro de HTML não precisa de inteligência artificial para ser bem feita, precisa de ser feita com rigor. A consequência prática é que o módulo não tem custos de exploração, nem latência, nem dependência de um serviço externo que possa mudar de preços ou fechar, e nenhum dado do seu catálogo sai do seu servidor.
Casos de uso típicos
Têxtil e marroquinaria: um vocabulário de materiais denso (gramagem, curtimenta, denier, ripstop e plastificação) que o cliente não domina, com um forte volume de pesquisas informacionais associadas. Cosmética e suplementos alimentares: os ativos e os ingredientes são outros tantos termos procurados (ácido hialurónico, niacinamida e adaptogénio), podendo cada um remeter para os produtos que os contêm. Equipamento técnico, ferramentas e material profissional: as especificações e normas (IP67, índice UPF, binário de aperto e norma EN 388) são exatamente o que o comprador procura antes de escolher. B2B e venda industrial: um glossário é a melhor forma de estabelecer a autoridade da marca num domínio técnico e de fazer entrar no funil potenciais clientes ainda em fase de compreensão. Lojas de nicho com jargão forte (vinho, café, áudio, ciclismo e aquariofilia): o glossário é literalmente o conteúdo que a comunidade procura, e posiciona-o como a referência do setor.
Arquitetura interna
Autoload PSR-4 nativo no namespace DataFirefly/Glossary/ mapeado na pasta src/, sem Composer nem dependências externas. A entidade GlossaryTerm é um ObjectModel multilingue padrão do PrestaShop, com geração automática dos slugs em falta. O repositório TermRepository centraliza os acessos à base de dados com uma cache estática do dicionário, para que a injeção numa página de categoria com trinta produtos gere apenas uma consulta. O serviço ContentFilter contém todo o motor de substituição, sem estado e testável de forma independente. Os controladores de administração estão em legacy ModuleAdminController, uma escolha propositada para garantir uma compatibilidade estável entre o PrestaShop 8.0 e o 9.x sem manter duas variantes de código. São quatro tabelas SQL com o prefixo dfglossary_ em utf8mb4_unicode_ci: term (identificador, ativo e ligação automática), term_lang (todos os campos traduzíveis), term_shop (associação multiloja) e term_product (produtos associados). A desinstalação elimina as quatro tabelas, o separador do back-office e todas as variáveis de configuração.
Simples e funcional.
Assistência excecional.Traduzido automaticamente