Gerador de FAQ Schema.org: documentação
Instalar e configurar a extensão DfFaqSchema: entradas de FAQ por produto, categoria e página CMS, elemento CMS Shopping Experiences e marcação JSON-LD FAQPage no Shopware 6.5 a 6.7.
Apresentação
O DfFaqSchema acrescenta blocos de perguntas e respostas editáveis às páginas de produto, às páginas de categoria e aos layouts Shopping Experiences do Shopware 6. Cada bloco é renderizado como acordeão Bootstrap e acompanhado de uma marcação Schema.org FAQPage em JSON-LD, injetada automaticamente na página. A extensão é compatível com Shopware 6.5, 6.6 e 6.7 e não exige qualquer alteração ao seu tema.
Instalação
Pela administração
- Abra Extensões e depois As minhas extensões e carregue o ficheiro ZIP da extensão.
- Clique em Instalar e ative a extensão.
Pela consola
bin/console plugin:refresh
bin/console plugin:install --activate DfFaqSchema
bin/console cache:clearCompilação da administração
O módulo de administração e o elemento CMS exigem uma compilação única dos recursos:
./bin/build-administration.shSem este passo, o menu FAQ Schema.org e o elemento CMS não aparecem na administração. O storefront, por seu lado, funciona logo após a ativação.
Configuração
Abra Extensões, As minhas extensões, e depois a configuração do DfFaqSchema. Estão disponíveis duas opções, reguláveis globalmente ou por canal de venda:
- Apresentar as FAQ nas páginas de produto: ativa o acordeão e o JSON-LD nas páginas de produto (ativo por predefinição).
- Apresentar as FAQ nas páginas de categoria: ativa o acordeão e o JSON-LD nas páginas de navegação (ativo por predefinição).
Criar entradas de FAQ
Abra Conteúdos e depois FAQ Schema.org. A listagem mostra todas as entradas com a sua pergunta, a sua atribuição, a sua posição e o seu estado.
Campos de uma entrada
- Pergunta: o texto da pergunta (campo traduzido).
- Resposta: a resposta em texto formatado através do editor integrado (campo traduzido).
- Posição: a ordem de apresentação no acordeão, crescente.
- Ativo: só as entradas ativas são apresentadas e marcadas.
- Atribuição: produto, categoria ou página CMS. O seletor de tipo mostra o campo de pesquisa correspondente.
Traduzir uma entrada
Use o seletor de idioma no topo da página de detalhe para mudar de idioma, e introduza a pergunta e a resposta traduzidas. Cada storefront apresenta os conteúdos do seu idioma e o JSON-LD acompanha automaticamente.
Uma entrada sem tradução num idioma recorre ao idioma predefinido do sistema, segundo o mecanismo normal do Shopware.
Apresentação em produto e categoria
As entradas atribuídas a um produto aparecem sob o conteúdo principal da página de produto. As entradas atribuídas a uma categoria aparecem sob a listagem da página de navegação. Nos dois casos, o JSON-LD FAQPage correspondente é injetado no cabeçalho do documento. A primeira pergunta do acordeão fica aberta por predefinição.
Elemento CMS para as Shopping Experiences
- Crie as suas entradas no módulo sem as atribuir a um produto ou a uma categoria (atribuição página CMS).
- Abra Conteúdos e depois Experiências de compra e edite um layout.
- Acrescente um bloco de texto e substitua o seu elemento pelo elemento FAQ (Schema.org).
- Na configuração do elemento, selecione as entradas a apresentar.
O acordeão e o seu JSON-LD são renderizados no local exato do elemento. Pode usar vários elementos FAQ num mesmo layout.
Marcação JSON-LD e validação
A extensão gera um objeto FAQPage com uma entidade Question por entrada apresentada, com a resposta em HTML no campo text da entidade Answer, o que o Google aceita. A marcação cobre apenas o conteúdo realmente visível na página, em conformidade com as diretrizes de rich results.
Para validar uma página, use o teste de resultados enriquecidos do Google: cole o URL da sua página de produto e verifique que o elemento FAQ é detetado sem erros.
A apresentação efetiva dos rich results fica ao critério do Google, que os reserva sobretudo a sites governamentais e médicos desde 2023. A marcação continua a ser útil para a compreensão das suas páginas pelos motores e pelos assistentes de IA.
Resolução de problemas
- O menu FAQ Schema.org não aparece: execute a compilação da administração e limpe a cache do navegador.
- O acordeão não aparece numa página de produto: verifique que a entrada está ativa, que está mesmo atribuída a esse produto e que a opção de apresentação em produto está ativa para o canal de venda em causa.
- O JSON-LD está ausente: a marcação só é gerada se pelo menos uma entrada ativa for apresentada na página. Verifique o código-fonte da página pesquisando application/ld+json.
- O elemento CMS não apresenta nada: verifique que foram selecionadas entradas na configuração do elemento e que estão ativas.
Desinstalação
A desinstalação elimina as tabelas da extensão e a sua configuração. Marque a opção de conservação dos dados durante a desinstalação para preservar as suas perguntas e respostas com vista a uma reinstalação.